分类：Node.js 报错与工程问题
这里仅展示已发布且允许收录的文章。阅读时建议先判断自己的真实能力和项目风险，再使用工具生成草稿或报价参考。
相关文章
共 11 篇，按发布时间排序。
npm run dev 能跑但 build 失败？7 个最常见原因和修复
dev 能跑 build 却失败，几乎都是严格校验和环境差异：TypeScript 类型错、ESLint 当错误、SSR 里用了 window、环境变量缺失、import 大小写、依赖装错位置、动态导入——7 个最常见原因的真实成因和修复命令。
.env 环境变量不生效怎么解决？process.env 读到 undefined 的 6 个原因
本地配了 .env 但 process.env 还是 undefined，常见于没重启 dev、前端变量缺 NEXT_PUBLIC_ 前缀、.env 文件名/位置不对、没装 dotenv、变量名拼错、构建平台没配。逐条给真实修复。
git authentication failed 怎么解决？密码认证已停、用 PAT 或 SSH（GitHub）
git 报 Authentication failed / could not read Username，是因为 GitHub 早已停用密码认证。给出用 Personal Access Token、SSH 密钥、清理旧凭据的真实步骤，区分 HTTPS 和 SSH 两条路。
Cannot find module 报错怎么解决？6 个常见原因（路径 / 大小写 / 依赖没装）
Cannot find module / Module not found 几乎都是这 6 类：依赖没装、import 路径写错、大小写不一致、tsconfig alias 没配、node_modules 坏了、文件没建。逐条给真实定位和修复命令。
Next.js Hydration failed 报错怎么解决？5 个常见原因和修复（SSR 不匹配）
Next.js 报 Hydration failed / Text content does not match，是服务端和客户端渲染结果对不上。常见于 Date/Math.random、typeof window、localStorage、非法 HTML 嵌套、浏览器扩展——逐条给真实成因和修复。
Node 版本不匹配怎么解决？EBADENGINE / Unsupported engine 和 nvm 切换
报 EBADENGINE Unsupported engine 或依赖要求的 Node 版本和你本机对不上，用 nvm 切到项目要求的版本最稳。给出查版本、装 nvm、.nvmrc、engines 字段、本地和线上版本对齐的真实命令。
npm: command not found 怎么解决？4 个原因（没装 Node / PATH / nvm）
终端报 npm: command not found 或 'npm' 不是内部或外部命令，几乎都是 Node.js 没装好、PATH 没配、或装了 nvm 没激活。给出 macOS/Linux/Windows 的真实检查和修复命令。
EADDRINUSE 端口被占用怎么解决？查进程、杀进程、换端口（3000/8080）
npm run dev 报 EADDRINUSE address already in use，是端口被上一个没关的进程占着。给出 macOS/Linux 和 Windows 查端口、杀进程、换端口的真实命令，以及怎么避免再次发生。
git push 报错怎么解决？7 个常见 rejected / permission denied 原因和修复
git push 报错先看关键行再动手：rejected non-fast-forward、Permission denied publickey、密码认证已移除要用 PAT、unrelated histories、large files、no upstream——7 个最常见 git push 报错的真实原因和修复命令，附 Codex 工作流。
npm install 报错怎么解决？9 种常见 npm ERR! 原因和逐条修复命令
npm install 报错先看报错码再动手：ERESOLVE 依赖冲突、EACCES 权限、ENOENT 找不到文件、gyp ERR! 原生模块编译、EBADENGINE 版本不符、网络超时、401 私有包——9 种最常见 npm ERR! 的真实原因和对应修复命令，附 Codex 辅助排查正确姿势。
Vercel 部署失败怎么办？8 个常见 build 报错原因和修复
Vercel 部署失败先看 build 日志再动手：Command exited with 1、Module not found、环境变量缺失、Output Directory 配错、Node 版本不符、构建超时、部署后 404、FUNCTION_INVOCATION_FAILED——8 个最常见 Vercel build 报错的真实原因和修复，附 Codex 辅助排查。
继续用工具做下一步判断
先用工具做判断，再用模板整理交付。生成内容只能作为草稿，不要不审核就直接发给客户。