环境问题排查
环境问题经常不是代码错误，而是版本、路径、端口、权限或缓存不一致。排查时要把“本机能跑”和“别人能跑”拆成可验证项。
排查流程
mermaid
flowchart TD
A[项目启动失败] --> B[确认运行命令]
B --> C[检查 Node/JDK/Python 版本]
C --> D[检查环境变量和配置文件]
D --> E[检查端口占用]
E --> F[删除缓存后重装依赖]
F --> G[查看完整错误日志]常见项
| 问题 | 检查方式 |
|---|---|
| 版本不一致 | node -v、java -version、python --version |
| 端口被占用 | netstat -ano |
| 依赖损坏 | 删除依赖目录后重新安装 |
| 环境变量缺失 | 查看 .env 和系统环境变量 |
| 权限不足 | 检查目录读写权限 |
建议
- README 中写清楚运行命令和版本要求。
- 错误截图不如完整日志有用。
- 能用锁文件就提交锁文件，减少依赖漂移。
- 容器化项目优先用容器复现环境。