Infrastructure Debugging

Dependency Resolution Strategy

When Facing Package Errors

1. Read the full error: Scroll up to find the root cause, not just the final message
2. Check version compatibility: Many issues stem from version mismatches
3. Clear caches first: npm cache clean --force or pip cache purge
4. Try fresh install: Delete lock files and node_modules/venv, reinstall
5. Check peer dependencies: Especially for React, TypeScript, and build tools

Common Package Manager Issues

npm/yarn/pnpm:

• ERESOLVE errors: Try --legacy-peer-deps or update conflicting packages
• EACCES permission errors: Don't use sudo, fix npm permissions instead
• Phantom dependencies: Use pnpm for stricter resolution