普通人 AI 实战手册

Appearance

09 · IDE 扩展上手：在编辑器里让 Codex 帮你改 ​

如果你平时用 VS Code 这类编辑器，IDE 扩展会很顺手。 因为你不用在 App、命令行、编辑器之间来回切换。 你正在看的代码，就是你和 Codex 讨论的上下文。

这一篇的目的不是让你学会所有按钮。 你只要先学会一件事：在编辑器里选中一个很小的任务，让 Codex 看懂、修改、展示差异、再由你确认。

IDE 扩展使用流程

第一次只改当前文件 ​

IDE 扩展很方便，但也容易让你忘了范围。

第一次练习只做：

  1. 打开一个文件。
  2. 让 Codex 解释它。
  3. 让 Codex 改一个小点。
  4. 看编辑器里的 diff。

不要一上来让它“整理整个项目”。

第一次练习就选一个“看得见”的改动 ​

不要选抽象任务。 选一个你肉眼能验证的改动，比如：

  1. 改一个按钮文案。
  2. 加一句空状态提示。
  3. 给一个标题换成更清楚的说法。

可以直接发：

text
请只修改当前文件，把我选中的这句文案改得更适合小白理解。
不要改样式，不要改其他文件。
改完后告诉我具体改了哪里。

第一次成功的标准不是“改得多”，而是“我知道它改了哪里”。

第一步：先确认你真的在项目里 ​

打开编辑器以后，先看左侧文件列表。 如果只打开了一个单独文件，Codex 很可能看不到完整项目。 新手更推荐打开整个项目文件夹。

你可以先问：

text
请先告诉我当前编辑器打开的是一个完整项目，还是单个文件。
暂时不要修改任何内容。

如果它回答不确定，先别继续。 先把正确的项目文件夹打开。

第二步：IDE 扩展适合做什么 ​

IDE 扩展特别适合这些任务：

  1. 解释当前文件。
  2. 修改一个函数。
  3. 给一段代码加注释。
  4. 补一个小功能。
  5. 根据报错定位问题。
  6. 对比修改前后的差异。

它不适合一上来就做这种任务：

  1. “帮我重构整个项目。”
  2. “把所有页面都优化一下。”
  3. “随便你改，做到最好。”

这种任务太大。 小白看不懂改动，就容易失控。

第三步：从当前文件开始 ​

第一次用 IDE 扩展，不要让它扫全项目。 先打开一个你能看见的文件。

比如你正在看一个页面文件，可以这样问：

text
请只解释当前打开的这个文件。
用小白能听懂的话告诉我：
1. 这个文件负责什么
2. 里面最重要的 3 个部分是什么
3. 如果我要改页面文字，应该看哪里
暂时不要修改文件。

这一步是在建立共同语言。 你不一定懂代码，但你要知道它说的是不是当前这个文件。

第四步：让它只改一个小目标 ​

确认它理解文件以后，再给一个很小的任务。

示例：

text
请只修改当前文件，把按钮文案从“提交”改成“保存草稿”。
不要改样式，不要改其他文件。
改完后告诉我你改了哪一行。

再复杂一点：

text
请只在当前文件里增加一个空状态提示。
要求：
1. 没有数据时显示“暂无内容”
2. 不改变已有数据展示逻辑
3. 不修改其他文件
完成后说明改动位置和验证方法

你会发现，任务越小，Codex 越稳。 任务越大，你越难判断它有没有跑偏。

第五步：一定要看差异 ​

IDE 扩展最重要的价值之一，是它通常能直接展示改动差异。 你不用一次性相信结果。 你要看它到底改了什么。

重点看四件事：

  1. 有没有改你没要求的文件。
  2. 有没有删除原来能用的代码。
  3. 有没有把简单问题改复杂。
  4. 有没有新增你看不懂的依赖或配置。

如果看不懂，直接问：

text
请用普通话解释这次 diff。
逐条告诉我：
1. 删除了什么
2. 新增了什么
3. 有没有影响我没有提到的功能
4. 我应该怎么验证

不要因为它显示“完成”就马上接受。 先看差异，再决定。

第六步：让它教你验证 ​

小白最容易漏掉的是验证。 你以为改好了，其实只是文件变了。

每次修改后，都补一句：

text
请告诉我这次修改应该怎么验证。
如果需要运行命令，请先解释命令作用，再给我一条最小命令。

如果是页面改动，可以验证：

  1. 页面能不能打开。
  2. 文案有没有变。
  3. 旧功能有没有坏。
  4. 手机尺寸下有没有挤在一起。

如果是代码逻辑，可以验证：

  1. 原来的输入还能不能用。
  2. 新增情况是否生效。
  3. 错误情况是否有提示。
  4. 测试或构建是否通过。

第七步：IDE 扩展的新手工作流 ​

你可以固定用这个流程：

  1. 打开正确项目文件夹。
  2. 打开要处理的文件。
  3. 先让 Codex 解释，不修改。
  4. 给一个最小任务。
  5. 看 diff。
  6. 让它解释 diff。
  7. 按它给的方法验证。
  8. 通过后再做下一个任务。

这个流程看起来慢。 但对小白来说，它比“让 AI 一次性全改完”安全很多。

常见错误 ​

错误一：只打开一个文件就让它改项目

它可能缺少上下文。 你应该打开项目文件夹。

错误二：让它同时改很多地方

你看不懂 diff，就无法判断风险。 先改一个点。

错误三：不看差异直接接受

这是最危险的习惯。 Codex 是助手，不是最终负责人。

错误四：不会验证就结束

不会验证，就不算完成。 至少让它告诉你怎么检查。

检查清单 ​

开始任务前，确认：

  • 当前打开的是正确项目。
  • 当前任务只涉及一个小目标。
  • Codex 先解释过它准备改哪里。
  • 修改后你看过 diff。
  • 你知道怎么验证结果。

小结 ​

IDE 扩展的优势是贴着代码工作。 它适合你边看文件、边问问题、边做小改动。

新手不要追求“全自动”。 先把一个文件、一个任务、一次 diff 跑顺。 下一篇讲 Codex Cloud：什么时候可以把任务交给云端跑，什么时候不要。