IDE 里第一次做局部修改

IDE 里第一次做局部修改

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

前置教程：IDE 里第一次解释当前文件
如果你还没有用 IDE 扩展完成只读解释，先完成前置教程。

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

你会学到什么

完成本篇后，你会知道：

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

第 1 步：选择一个小任务

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

适合：

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

不适合：

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

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

第 2 步：选中要修改的代码

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

建议只选：

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

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

第 3 步：发送修改提示词

复制这个模板：

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

目标：
【写清楚你想改成什么】

限制：
1. 不要修改其他文件。
2. 不要引入新依赖。
3. 不要重构无关代码。
4. 修改前先用中文说明你的计划。
5. 修改后说明你改了什么，以及我应该怎么验证。

例子：

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

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

限制：
1. 不要修改其他文件。
2. 不要引入新依赖。
3. 不要重构无关代码。
4. 修改前先用中文说明你的计划。
5. 修改后说明你改了什么，以及我应该怎么验证。

第 4 步：先看计划

Codex 如果先给计划，你要检查：

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

如果计划太大，立刻纠正：

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

如果计划清楚，再继续。

第 5 步：看修改结果

修改完成后，重点看：

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

你可以让 Codex 总结：

请总结这次局部修改：
1. 改了哪里。
2. 为什么这样改。
3. 有没有影响其他逻辑。
4. 我应该怎么验证。

第 6 步：让 Codex 做轻量验收

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

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

请根据这次修改给出验收清单。
如果你认为需要运行检查，请说明需要运行什么。
如果你认为只需要人工查看，也请说明原因。

这里要符合实际情况：

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

第 7 步：如果 IDE 修改不够稳，切到 CLI

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

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

提示词：

刚才 IDE 局部修改范围开始变大。
请重新只读分析当前任务，先不要修改文件。
请告诉我最小修改范围和验收标准。

本篇验收

完成后，你应该能做到：

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

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