IDE 扩展最适合做小范围、看得见的局部修改。

> 前置教程:IDE 里第一次解释当前文件

> 如果你还没有用 IDE 扩展完成只读解释,先完成前置教程。

> 依据来源:OpenAI Codex 官方手册中关于 IDE 扩展上下文、选中代码、共享配置、审批和沙箱的说明。

完成本篇后,你会知道:

  • 如何选择一个安全的小任务。
  • 如何限制 Codex 只改当前文件或选中代码。
  • 如何要求 Codex 修改前先说明计划。
  • 如何看修改结果。
  • 如何让 Codex 做验收说明。

第一次局部修改,不要选复杂任务。

适合:

  • 改一个按钮文案。
  • 改一个标题。
  • 调整一段样式 class。
  • 给一个函数增加空值判断。
  • 把一段难懂代码改得更清晰。

不适合:

  • 重构整个页面。
  • 改登录注册流程。
  • 改数据库结构。
  • 增加完整业务模块。
  • 同时改很多文件。

第一次要小到你能一眼看懂。

在编辑器里选中你希望 Codex 修改的代码。

建议只选:

  • 一个函数。
  • 一个组件片段。
  • 一小段模板。
  • 一小段样式。

不要选整个项目,也不要选太多文件。

复制这个模板:

``

请只修改我当前选中的代码。

目标:

【写清楚你想改成什么】

限制:

  1. 不要修改其他文件。
  2. 2. 不要引入新依赖。

    3. 不要重构无关代码。

    4. 修改前先用中文说明你的计划。

    5. 修改后说明你改了什么,以及我应该怎么验证。

    `

    例子:

    `

    请只修改我当前选中的代码。

    目标:

    把按钮文案从“Submit”改成“保存”,并让 loading 状态显示“保存中”。

    限制:

    1. 不要修改其他文件。
    2. 2. 不要引入新依赖。

      3. 不要重构无关代码。

      4. 修改前先用中文说明你的计划。

      5. 修改后说明你改了什么,以及我应该怎么验证。

      `

      Codex 如果先给计划,你要检查:

      • 是否只改选中代码。
      • 是否没有新增依赖。
      • 是否没有扩大范围。
      • 是否能解释为什么这样改。

      如果计划太大,立刻纠正:

      `

      范围太大了。请缩小到只修改当前选中代码,不要动其他文件,也不要重构。

      `

      如果计划清楚,再继续。

      修改完成后,重点看:

      • 改动是否在当前文件。
      • 有没有无关格式化。
      • 文案或逻辑是否符合目标。
      • 有没有明显语法错误。
      • 是否保留原有行为。

      你可以让 Codex 总结:

      `

      请总结这次局部修改:

      1. 改了哪里。
      2. 2. 为什么这样改。

        3. 有没有影响其他逻辑。

        4. 我应该怎么验证。

        `

        第 6 步:让 Codex 做轻量验收

        IDE 局部修改后,不一定每次都要跑完整构建。

        但你至少要让 Codex 说明验收方式:

        `

        请根据这次修改给出验收清单。

        如果你认为需要运行检查,请说明需要运行什么。

        如果你认为只需要人工查看,也请说明原因。

        `

        这里要符合实际情况:

        • 文案改动:可能人工查看即可。
        • 逻辑改动:可能需要跑相关测试或手动操作。
        • 类型改动:可能需要类型检查。
        • 多文件改动:更应该切到 CLI 做完整检查。

        第 7 步:如果 IDE 修改不够稳,切到 CLI

        如果 Codex 在 IDE 里越改越多,不要硬扛。

        你可以停止当前任务,然后切到 CLI 或桌面版,让 Codex 做更完整的项目级分析。

        提示词:

        `

        刚才 IDE 局部修改范围开始变大。

        请重新只读分析当前任务,先不要修改文件。

        请告诉我最小修改范围和验收标准。

        ``

        完成后,你应该能做到:

        • 选择一个足够小的 IDE 修改任务。
        • 限制 Codex 只改当前文件或选中代码.
        • 修改前先看计划。
        • 修改后看总结和验证建议。
        • 发现任务变大时切到 CLI 或桌面版。

        下一篇看:IDE、CLI、桌面版怎么配合