排查我的项目跑不起来：新手通用救火流程

项目无法启动时，最重要的是保留完整错误和执行上下文。按固定顺序排查环境、依赖、配置、端口与日志，比随机重装更快且不会掩盖原因。

你会学到什么

• 记录足够的错误证据。

• 按顺序定位常见启动问题。

• 写出别人能复现的求助信息。

动手步骤

• 阅读 README 中的版本、安装和启动要求。

• 确认 node、python、git 等运行时版本。

• 按 lockfile 重装依赖并补齐本地 .env。

• 检查端口占用、第一条错误和受控日志。

最小示例

node --version
python --version
git status
npm ci
npm run build

容易踩坑的地方

• 重装系统与删除所有文件是最后手段。

• 不要把含 Token 的 .env 发到聊天群。

• 权限错误不能默认用 sudo 解决。

完成前检查

• 能复现并记录第一条错误。

• 运行时与依赖版本正确。

• .env 完整且无泄漏。

延伸阅读

• VS Code FAQ：https://code.visualstudio.com/docs/supporting/faq

• npm Docs：npm ci：https://docs.npmjs.com/cli/v11/commands/npm-ci