常见问题与排错 · Codex 从入门到专精

「网页打开是一片空白」——最常见的那种

先说结论：九成不是文件坏了，而是它去网上拿东西没拿到。

典型场景：AI 生成的网页里写了"从某个网址加载字体/图片/脚本"。你的电脑能访问那个网址时一切正常；换个网络、换台电脑、或者对方网络不通，页面就卡住或全白——因为浏览器在等一个永远不来的文件。

怎么判断：打开页面时按 F12，切到 Console（控制台）标签，如果看到一片红色的 Failed to load resource、ERR_NAME_NOT_RESOLVED、net::ERR_CONNECTION_TIMED_OUT，基本就确认了。

怎么修：把控制台报错截图给它，并说：

修空白页

打开是一片空白，控制台报错如下：［粘贴报错］
请把页面改成完全自包含的：不要引用任何外部网址的字体、图片、
脚本或样式，全部写进文件内部（图片可以用纯 CSS 或内嵌的方式）。
改完请说明你检查了哪些地方，确保断网也能正常显示。

怎么预防：开头就加一句"只生成单个文件，不依赖任何外部资源"。本站就是这么做的——你现在把 WiFi 关掉刷新一下，内容照样在。

「打开要转很久，或者干脆打不开」

三个最常见的原因，从简单到复杂：

① 文件太大。 如果 HTML 里塞了几十兆的图片（把图片直接编码进文件里就会这样），打开会非常慢。解法：让图片单独存成文件放在同目录，页面里引用它们。

② 依赖外部资源。 同上面那条，浏览器在等外网响应，等不到就一直转。

③ 发布在网盘或需要登录的地方。 有些网盘链接打开的是"预览页"而不是网页本身。想给别人看网页，用静态托管服务，直接生成一个网址。

顺便说：单文件 + 不引用外网 + 图片另存，这三条做到了，一个网页可以做到秒开，哪怕内容再多。

「它不动了 / 转了很久没反应」

先分辨两种情况：

它真的在干——复杂任务（读很多文件、跑程序、做长文档）本来就要几分钟。看它有没有在持续输出过程说明，有就是在干活。

它确实卡住了——超过几分钟没有任何动静。这时候不要直接关掉，先用一句话打断它：停一下，告诉我现在到哪一步了，遇到什么困难？ 大多数时候它会自己说明卡在哪（比如要授权、找不到文件）。

如果真没反应，再考虑中断重来。重来时把任务拆小：大任务拆成三步分别做，比一次丢个大任务稳得多。

「它说没有权限，或者一直要我确认」

这不是故障，是设计。两种原因：

① 它要操作的文件夹不在你的工作区里。 把文件挪进工作区文件夹，或者重新指定一个包含它的工作区。

② 你在"每次都要问"的严格模式下。 熟练之后可以调到"只在需要时问"。具体在哪里改，看软件的设置面板或输入 /approvals 之类的命令试试。

提醒：觉得烦可以放宽，但放宽的前提是你有备份、而且它只在你专门划出的文件夹里干活。

「它好像忘了前面说过的要求」

这是上下文被挤掉了（第 6 章讲过原理）。三种解法，按推荐顺序：

① 让它写进文件。 把我刚才说的要求整理成一份 README.md 放在文件夹里，以后每次先读它。 文件比对话可靠。

② 让它总结后开新线程。 先总结目前的进展、约定和待办，我要开一个新对话继续。 然后把总结贴到新线程里。

③ 用压缩/精简功能。 不少工具提供"压缩历史"的命令，把长对话浓缩成要点，腾出空间。

「它把我原来的文件改坏了」

先别慌，按这个顺序救：

第一步：立刻停手，不要再让它碰这个文件夹，避免二次破坏。

第二步：找备份——系统回收站、文件历史记录、Time Machine、云盘的版本历史、Git 记录，任意一个能救回来。

第三步：如果什么都没有，把情况和它说清楚：你刚才把 XXX 文件改坏了，原始内容是［你记得的部分］，请尝试恢复。它有时能根据上下文和残留内容还原一部分。

第四步：吸取教训。 这就是为什么第 8 章反复强调：重要文件先备份，或者开个文件历史。这一步花十秒，能救一个下午。

「它说做完了，我一看根本不对」

这是最需要正视的问题。"声称完成"和"真的完成"是两件事。

立刻能用的对策——加一句要求它自证：

要求自证

在你说"完成"之前，请做到：
1. 实际运行或打开一次，确认结果符合要求
2. 逐条对照我给的要求，说明每一条在哪里体现
3. 如果有任何一条做不到或不确定，直接说出来，不要跳过
4. 把你验证的具体命令/步骤和看到的输出告诉我

另外，收到结果时养成"回读一遍需求"的习惯：你要的五条，它答了几条？漏的那条不用你发现，让它自己数一遍。

「它回答得又长又啰嗦，我不想听废话」

直接下规矩，它可以遵守得很好：

以后回答请遵守：先给结论，最多三句话；需要细节时再展开；不要复述我的问题；不要写客套话；不要在结尾问我"还需要什么帮助吗"。

如果这是长期习惯，把它写进项目说明书（AGENTS.md），一次搞定，不用每次说。

「它老是回英文，或者中文夹英文」

明说就行：请始终用简体中文回复，专业术语第一次出现时可以用括号附上英文。

如果长期需要，写进项目说明书。这类偏好最好固化下来，省得每次提醒。

「生成的中文文档打开是乱码」

这是编码问题，很典型。告诉它：文件保存时请使用 UTF-8 编码，并在 HTML 里写明 charset 为 utf-8，确保中文不乱码。

对于生成的表格 .csv 文件，Excel 有时需要"带 BOM 的 UTF-8"才能正确识别中文，也可以顺手提一句。

「它说的和网上查到的不一样」

默认情况下它主要靠"记忆"回答，记忆是有时效的。所以：涉及会变化的信息（价格、版本、政策、新闻），要明确要求它联网查证，或者你自己去官方页面确认。

可靠的说法是："请联网搜索并给出信息来源链接；如果搜不到，就说搜不到。"

「我怎么知道自己算不算用明白了？」

用这四个标准自测，能全做到，说明你已经是熟练用户了：

能在三句话里说清一个任务，不需要来回补
会主动加约束（不要什么、边界在哪、怎么验收）
重要的活会先备份，并且会自己复核结果
重复的事情会想到"这个可以做成技能/自动化"