分类：报错解决
这里仅展示已发布且允许收录的文章。阅读时建议先判断自己的真实能力和项目风险，再使用工具生成草稿或报价参考。
相关文章
共 65 篇，按发布时间排序。
API Key 无效或缺失排查清单
一份给新手使用的 API Key 无效或缺失排查清单，覆盖错误记录、环境变量、部署平台、权限额度、日志脱敏和客户沟通。
API Key 无效或缺失项目范围：使用前怎么判断是否适合
接到 API Key 无效或缺失的排错需求时，新手应先判断复现环境、授权方式、密钥安全、交付范围和验收标准，再决定是否报价。
API Key 无效或缺失的常见错误和修复步骤
整理 API Key 无效或缺失排查中的常见错误：变量名不一致、没有重启服务、前端暴露密钥、线上变量遗漏、权限额度不足。
API Key 无效或缺失怎么处理
新手排查 API Key 无效或缺失时，可以按环境变量、密钥权限、计费状态、服务端读取和安全边界逐步检查，避免泄露客户密钥。
dependency conflict 依赖冲突处理检查清单
一份给新手的 dependency conflict 依赖冲突检查清单，覆盖报错、包管理器、锁文件、peer dependency、Node 版本、验证命令和项目暂停条件。
dependency conflict 依赖冲突使用前怎么判断是否适合
用项目视角判断依赖冲突任务能不能接：看日志、仓库权限、锁文件、验证命令、客户授权、生产风险和交付边界，先诊断再承诺修复。
dependency conflict 常见错误和解决步骤
整理 dependency conflict 依赖冲突排查中的常见错误：混用包管理器、乱删锁文件、强制安装、忽略 peer dependency、没跑 build，以及更稳的解决顺序。
dependency conflict 依赖冲突怎么处理
给中文新手的 dependency conflict 依赖冲突排查流程：先保存报错和锁文件状态，再看包管理器、peer dependency、版本范围、Node 版本和验证命令，不要一上来强制安装。
npm run dev 能跑但 build 失败检查清单
一份给新手的 build 失败检查清单，覆盖完整日志、失败阶段、TypeScript、lint、环境变量、静态生成、路径大小写、依赖版本和项目暂停条件。
npm run dev 能跑但 build 失败使用前怎么判断是否适合
用项目视角判断 build 失败任务能不能接：看完整日志、仓库权限、环境变量、部署平台、验证命令、生产风险和交付边界，先诊断再承诺修复。
npm run dev 能跑但 build 失败常见错误和解决步骤
整理 build 失败排查中的常见错误：只看 dev、不保存完整日志、关掉类型检查、忽略环境变量、忽略静态生成和路径大小写，以及更稳的解决顺序。
npm run dev 能跑但 build 失败怎么办
给中文新手的 build 失败排查流程：先区分 dev 和 build，再检查 TypeScript、lint、环境变量、静态生成、依赖版本、大小写路径和部署环境差异。
环境变量 missing 排查检查清单
一份给新手的环境变量 missing 检查清单，覆盖变量名、发生环境、本地和部署平台差异、公开变量、敏感密钥、验证命令和客户待确认事项。
环境变量 missing 使用前怎么判断是否适合
用项目视角判断环境变量缺失任务能不能接：看日志、变量名、环境、客户授权、敏感密钥、部署平台和交付边界，先诊断再协助配置。
环境变量 missing 常见错误和解决步骤
整理环境变量 missing 排查中的常见错误：泄露密钥、混淆本地和部署环境、把服务端密钥放到客户端、配置后不重新部署，以及更稳的解决顺序。
环境变量 missing 怎么排查
给中文新手的环境变量 missing 排查流程：先确认缺哪个变量、在哪个环境缺、本地和部署平台是否一致，再处理公开变量、敏感密钥和客户授权边界。
ESLint error 处理检查清单
一份给新手的 ESLint error 检查清单，覆盖规则名、文件行号、代码修复、配置判断、局部禁用、验证命令和项目交付记录。
ESLint error 使用前怎么判断是否适合
用项目视角判断 ESLint error 修复任务能不能接：看规则名、影响范围、团队配置、CI 门禁、验证命令和交付边界，先诊断再修改。
ESLint error 常见错误和解决步骤
整理 ESLint error 处理中的常见错误：全局关闭检查、批量加 eslint-disable、忽略 Hook 规则、只看 build 通过，以及更稳的解决顺序。
ESLint error 要不要直接关闭
给中文新手的 ESLint 报错处理流程：先读规则名和报错文件，判断是代码问题、配置问题还是临时例外，再决定是否局部禁用，不要一上来全局关闭检查。
failed to push some refs 排查检查清单
一份给新手使用的 failed to push some refs 检查清单，覆盖分支、远端、fetch、上游分支、远端领先、权限、保护规则、冲突处理和交付记录。
failed to push some refs 使用前怎么判断是否适合
从项目角度判断 failed to push some refs 是否适合新手处理：区分普通分支问题、远端领先、冲突、权限不足、保护分支和客户授权边界。
failed to push some refs 常见错误和解决步骤
整理 failed to push some refs 的常见处理错误：忽略远端提交、直接强制推送、推错分支、没看权限、没保存现场，并给出更稳的解决顺序。
failed to push some refs 怎么排查
新手遇到 failed to push some refs 时，先不要急着强制推送。本文按远端变更、本地分支、上游分支、权限和保护规则拆解排查顺序，帮助你在不覆盖别人代码的前提下恢复 Git 推送。
git authentication failed 处理检查清单
一份给新手使用的 git authentication failed 检查清单，覆盖远端地址、HTTPS、SSH、token、权限、组织 SSO、凭据缓存和客户授权记录。
git authentication failed 使用前怎么判断是否适合
从项目角度判断 git authentication failed 是否适合新手处理：区分本地配置、平台权限、客户授权、token 安全、SSH key 和组织规则。
git authentication failed 常见错误和解决步骤
整理 git authentication failed 的常见错误：索要客户密码、把 token 写进代码、HTTPS 和 SSH 混查、忽略权限、误删凭据，并给出更稳的恢复顺序。
git authentication failed 怎么解决
新手遇到 git authentication failed 时，先区分 HTTPS、SSH、令牌过期、账号权限和远端地址问题。本文给出安全排查顺序，避免索要客户密码或误改仓库权限。
GitHub Actions build 失败日志检查清单
一份给新手使用的 GitHub Actions build 失败日志检查清单，覆盖 workflow、job、step、关键错误、依赖、测试、环境变量、权限、部署平台和客户确认事项。
GitHub Actions build 失败使用前怎么判断是否适合
从项目角度判断 GitHub Actions build 失败是否适合新手处理：区分代码错误、CI 配置、secret 缺失、部署授权、组织规则和客户待办。
GitHub Actions build 失败常见错误和解决步骤
整理新手排查 GitHub Actions build 失败时的常见错误：只看最后一行、改错 workflow、删除测试、泄露 secret、忽略客户权限，并给出更稳的解决顺序。
GitHub Actions build 失败怎么看日志
新手遇到 GitHub Actions build 失败时，不要只看红叉。本文按 workflow、job、step、关键错误、环境变量、权限和本地复现拆解日志排查流程，帮助你判断下一步该修代码还是请客户补授权。
module not found 报错定位检查清单
一份给新手使用的 module not found 定位检查清单，覆盖缺失模块、导入文件、本地路径、大小写、依赖包、路径别名、构建环境和客户待确认事项。
module not found 使用前怎么判断是否适合
从项目角度判断 module not found 是否适合新手处理：区分本地路径错误、依赖缺失、路径别名、私有包权限、客户漏文件和构建环境差异。
module not found 常见错误和解决步骤
整理新手处理 module not found 时的常见错误：乱装包、改错路径、忽略大小写、删除导入、没看路径别名、忽略客户私有依赖，并给出更稳的修正顺序。
module not found 报错怎么定位文件
新手遇到 module not found 时，不要立刻乱装包。本文按报错来源、导入语句、文件路径、大小写、依赖安装、路径别名和构建环境拆解定位流程，帮助你判断该改代码还是请客户补材料。
Next.js hydration error 怎么排查：新手检查清单
一份给 AI 工具新手的 Next.js hydration error 检查清单：核对报错原文、复现路径、服务端客户端差异、第三方组件、构建验证和明日人工复核事项。
Next.js hydration error 怎么排查：使用前怎么判断是否适合
接到 Next.js hydration error 修复需求时，先把它拆成诊断范围：复现路径、报错截图、仓库权限、测试分支、预览环境和验收标准都明确后，再判断是否适合报价。
Next.js hydration error 怎么排查：常见错误和解决步骤
把 Next.js hydration error 当成前后端渲染结果不一致的问题来排查：先保存报错、复现路径和运行环境，再缩小到组件、数据和浏览器状态差异。
Next.js hydration error 怎么排查
给 AI 工具新手的 Next.js hydration error 排查草稿：先收集报错原文、复现路径和环境差异，再按客户端差异、随机值、时间、浏览器 API 和第三方组件逐项验证。
Node 版本不匹配排查检查清单
一份给新手使用的 Node 版本不匹配排查清单，覆盖 node/npm 版本、package.json engines、.nvmrc、锁文件、包管理器、CI 和部署平台配置。
Node 版本不匹配使用前怎么判断是否适合
从项目角度判断 Node 版本不匹配是否适合新手处理：区分本地环境、包管理器、锁文件、CI、部署平台和客户权限边界。
Node 版本不匹配常见错误和解决步骤
整理新手处理 Node 版本不匹配时的常见错误：盲目升级、删除锁文件、混用包管理器、忽略 CI 和部署平台版本、把客户配置当代码问题，并给出修正步骤。
Node 版本不匹配怎么排查
新手遇到 Node 版本不匹配时，先确认本地、CI、部署平台和 package.json 要求是否一致。本文按报错、当前版本、engines、锁文件、包管理器和客户环境拆解排查流程。
npm command not found 排查检查清单
一份给新手使用的 npm command not found 排查清单，覆盖终端类型、Node/npm 版本、PATH、安装方式、包管理器、客户权限和验证记录。
npm command not found 使用前怎么判断是否适合
从项目角度判断 npm command not found 是否适合新手处理：区分本地环境、客户设备、CI、部署平台和项目包管理器，确认权限后再决定报价范围。
npm command not found 常见错误和修正方法
整理新手处理 npm command not found 时的常见错误：没检查 Node、没重启终端、混用包管理器、乱改 PATH、在客户环境直接操作，并给出修正方法。
npm command not found 怎么解决
新手遇到 npm command not found 时，先确认 Node.js 是否安装、npm 是否随 Node 可用、终端 PATH 是否刷新、项目是否要求 pnpm 或 yarn。本文给出本地排查步骤和项目边界。
package lock 冲突安全处理检查清单
一份给新手使用的 package-lock.json 冲突检查清单，帮助确认 git 状态、包管理器、package.json 变更、锁文件来源、验证命令和客户待确认事项。
package lock 冲突使用前怎么判断是否适合
从项目角度判断 package-lock.json 冲突是否适合新手处理：确认包管理器、分支权限、依赖变更来源、验证命令、客户维护者确认和不包含事项。
package lock 冲突常见错误和修正方法
整理新手处理 package-lock.json 冲突时的常见错误：直接删除锁文件、保留一边、混用包管理器、不看 package.json、没跑验证和在客户主分支试错。
package lock 冲突怎么安全处理
新手遇到 package-lock.json 冲突时，不要第一反应删除锁文件。本文讲如何先确认分支、包管理器、冲突范围、依赖变更来源，再决定保留哪一版并重新安装验证。
permission denied 报错新手怎么处理：新手检查清单
permission denied 报错处理前，新手要检查命令、路径、用户、权限类型、Git/SSH 账号、部署环境和客户授权边界，避免盲目提权。
permission denied 报错新手怎么处理：使用前怎么判断是否适合
接到 permission denied 修复需求时，不要马上报价。先确认报错位置、项目权限、测试分支、部署环境、敏感资源边界和验收标准，再判断是否适合新手承接。
permission denied 报错新手怎么处理：常见错误和解决步骤
permission denied 报错不能靠盲目提权解决。新手要先判断被拒绝的是文件、目录、SSH、Git、部署平台还是客户授权，再按证据处理。
permission denied 报错新手怎么处理
permission denied 不要先乱加权限。新手应先确认是哪一个用户、哪一个路径、哪一个命令被拒绝，再判断是文件权限、目录归属、执行权限、SSH key、环境变量还是部署平台限制。
port already in use 释放端口检查清单
一份给新手使用的 port already in use 检查清单，帮助确认端口号、启动命令、占用进程、是否可关闭、是否可换端口和客户权限边界。
port already in use 使用前怎么判断是否适合
从项目角度判断 port already in use 是否适合新手处理：区分本地开发、客户设备、远程服务器、Docker 和部署平台，确认权限后再决定范围。
port already in use 常见错误和修正方法
整理新手处理 port already in use 时的常见错误：乱杀进程、没确认端口来源、忘记旧终端、随便换端口、在客户服务器操作，并给出修正方法。
port already in use 怎么释放端口
新手遇到 port already in use 时，不要直接乱杀进程。本文讲如何确认端口号、识别占用进程、判断是不是自己的开发服务，再安全关闭或换端口。
Codex 项目 npm install 报错怎么办：新手排查步骤
新手用 Codex 接触 Next.js 或 Node.js 项目时，npm install 报错很常见。本文用可执行步骤解释如何判断 Node 版本、依赖冲突、网络和权限问题，避免在没有把握时承诺客户。
npm install 报错排查检查清单
一份给新手的 npm install 报错排查清单，覆盖目录、Node/npm 版本、lockfile、网络、权限、私有包、低风险验证和交付记录。
npm install 报错排查项目能不能接
用项目视角判断 npm install 报错排查任务能不能接：看客户材料、依赖风险、私有包授权、修复边界、交付记录和报价方式。
npm install 报错常见错误和修复顺序
整理新手排查 npm install 报错时常见的错误：跑错目录、混用包管理器、乱删 lockfile、盲目升级依赖，以及更稳的修复顺序。
用 Codex 排查 npm install 报错
给中文新手的一套 npm install 报错排查流程：用 Codex 辅助解释日志，但由人工确认项目目录、Node 版本、包管理器、权限、网络和可回退边界。
继续用工具做下一步判断
先用工具做判断，再用模板整理交付。生成内容只能作为草稿，不要不审核就直接发给客户。