开发环境出错了怎么办
早上刚打开电脑，准备写代码，结果一运行项目就报错。依赖装不上、端口被占用、环境变量找不到……这种问题太常见了。别急，先冷静下来，一步步排查。
看清楚错误信息
很多人一看到红字就慌，其实错误信息里藏着关键线索。比如 npm install 失败时提示 ERR! code ECONNREFUSED，说明是网络连接问题，可能是公司代理没配好。如果是 Python 报 ModuleNotFoundError，那八成是虚拟环境没激活或者包没装对地方。
检查基础配置
有时候问题出在最简单的地方。确认你用的 Node.js 或 Python 版本是否符合项目要求。一个老项目用 Node 14 写的，你现在装了 Node 18，某些包可能直接跑不起来。可以用 nvm 或 pyenv 切换版本试试。
环境变量也经常背锅。比如数据库连接地址写在 .env 文件里，但你忘了复制 .env.example 成 .env，程序自然拿不到配置。
重新安装依赖试试
依赖文件损坏或下载不完整，会导致各种奇怪问题。删掉 node_modules 和 package-lock.json，再重新 npm install。Python 项目可以删除 venv 目录，重建虚拟环境并 pip install -r requirements.txt。
rm -rf node_modules package-lock.json
npm install如果网络慢，考虑换个源。npm 可以用淘宝镜像：
npm config set registry https://registry.npmmirror.com端口冲突怎么办
启动服务时报错“Address already in use”，说明端口被占用了。常见的是 3000、8080、5000 这些默认端口。用命令查一下谁在用：
lsof -i :3000找到 PID 后 kill 掉，或者改项目配置换个端口。
Docker 环境出问题
用了 Docker 也不一定省心。容器起不来，先看日志：docker-compose logs。可能是数据库没等应用就启动了，加个重试机制或者设置 depends_on 并配合健康检查。镜像构建失败，看看 Dockerfile 里是不是 COPY 了不存在的文件，或者缓存污染，可以加 --no-cache 重新构建。
别忽略编辑器和插件
VS Code 的 ESLint 插件报一堆错，但终端 run lint 却没问题？可能是插件用的 Node 版本和你本地不一致。关掉插件试试，或者在设置里指定正确的路径。
还有时候格式化工具保存时自动改代码，导致编译失败。检查 Prettier 或 Husky 配置有没有误伤。
从别人能跑的环境找线索
同事的机器上一切正常，你的就不行。这时候别硬扛，对比一下系统版本、依赖版本、环境变量。让他把 package.json 和 .env.example 发你看看，或者直接拉一份他确认能跑的代码分支试试。
实在不行，新建个干净目录，重新 clone 项目，一步步来，避免旧文件干扰。
开发环境的问题，大多数不是大故障，而是小细节没对上。耐心一点，像查案一样顺着错误提示往下挖， usually 能找到突破口。