跳至内容

软件技术分享

关于电子游戏的方方面面

  • 游戏产业
    • 行业杂谈
    • 开发者采访
  • 游戏设计
    • 专题学习
    • 设计制作
  • 游戏热点
    • 游戏评测
    • 攻略与资料
    • 流行游戏
  • 工具指南
  • AI
    • AI新闻
    • 使用心得
  • 沙雕应用
  • 游戏7×24小时
  • 关于妙游社

Codex 改完没生效,先看它有没有读懂仓库

作者 2026年11月19日 09:17

第一次让 Codex 处理一个登录超时的 bug,日志里报 undefined,报错位置却在另一个模块。你不把那几个相关文件指给它,它就只能靠猜,猜出来的补丁跟项目现有架构完全不合拍。

CSDN 作者刘炳琦把这类工具从安装配置到多文件重构完整走了一遍。他的判断是,Codex 能把「读懂仓库 → 定位问题 → 给方案 → 动手改 → 运行验证 → 交人审查」这一整条链路从头走到尾,不止是吐一段高亮代码。(原文有删节)

先跑通一条最小链路,再谈功能

安装前有四件事值得先确认。用官方推荐的渠道装 Node 或对应的分发方式,确认终端能正常跑;账号和密钥只用自己能负责的,别碰来路不明的共享凭证;准备好一个 Git 仓库,它的回滚和分步提交都建立在 Git 上,看 diff 也方便;最后拿一个小型样例项目练手,别一上来就用核心业务仓库。

安装就是 npm install -g @openai/codex,跑 codex –version 能出版本号说明程序就位,再 codex login。登录方式随版本变,有的开浏览器授权,有的配 API Key,关键是这一步确认了你是谁、你有没有权调用服务。

装完先别让它改代码。git status 确认当前分支是干净的,至少你知道自己在哪。工作区乱着交出去,它给出的方案也会带着一团乱麻的背景。

然后给它一个不破坏任何东西的任务:读一遍 package.json 和 src/main.js,说明程序入口的执行顺序,再列出三个可能出问题的地方,不要改任何文件。它能答得跟你预期一致,说明上下文链路通了;答非所问,多半是任务里没给明确文件路径,或者目录选错了。

第一轮跑通之后,值得养成的习惯是,每次动手前先让它用一句话复述它打算做什么。复述都不对,后面就是对牛弹琴。

三个阶段,别一步跳到自动执行

第一阶段只读、只解释、只给方案。要修登录超时,先说「请先查找 src/auth 下面的登录相关文件,说明登录流程在第几步可能超时,给出你建议的修复方案,不要修改任何文件」。先让它出方案,等于把决策留给你,只读阶段风险很小。

第二阶段做最小改动,让它给 diff。比如「把 src/auth/LoginService.ts 的会话超时改成 30 分钟,保留原有日志输出,不要动其他文件,改完显示 diff,先不要运行命令」。这里很多人直接跳进自动执行,把人工审查跳过了,问题恰恰出在这。

第三阶段才进多文件任务。把时间格式化函数从 src/utils/date.ts 抽到 src/lib/datetime.ts,更新所有引用它的文件,不改业务逻辑、不动 package.json、不删任何对外导出的函数,完成后跑 npm test,失败就把错误贴出来。这一轮能同时看它有没有理解引用关系、有没有守住你划的边界、能不能跑测试反馈结果。

五个先理解的概念

仓库上下文。它靠查找命令、文件读取、glob 按需探索仓库,不会一次性把整个仓库读进来。目标越明确,它越快缩小范围;你只说「看看这个项目」,它只能随机抓一部分文件,回答自然不稳。

计划与执行分开。它先列计划、等你确认、再动手。版本支持自动执行的话,建议先关掉,至少在开始阶段保持手动确认,这样你每一步都看得见。

工作区和沙箱边界。权限从只读到可写当前工作区再到自动执行,层层放开。刚上手用只读或工作区写入模式,熟悉它的行动风格之后再决定放不放更多权限。前两次跑得顺就把执行权全交出去,是很危险的。

上下文窗口有限,prompt 太长会被截断。把描述控制在目标、路径、边界、验证四块,一个任务描述别超过几百字,当成给新同事交代活儿。

结果可回滚。Git 是它工作的基础,任务前确认分支干净,任务后先看 diff 再提交;它改错了,回滚到上一个 commit 就行。

最容易踩的三个坑

坑一,不看仓库就让它按记忆改代码。丢一句「把项目里所有不安全的日期处理改掉」,却不告诉它有哪些文件、期望什么行为表现,它只能猜。先用一轮只读分析确认文件列表,再推进到修改。

坑二,过度授权让它自行执行所有命令。它跑个包安装、改个配置、执行迁移脚本,副作用有时候比改代码本身破坏性更大。刚开始先让它列命令、你自己手动跑,有把握了再放开命令行权限。

坑三,只看新代码,不管测试和回归。函数改名成功、import 更新成功,测试一跑原本通过的全挂。每个任务描述里带上验收标准,比如「完成后运行 npm test,失败就把报错贴出来」。

真出了状况,按一条链排查:先看现象,再看输入,然后环境、权限、上下文,最后日志。逐条自问,当前目录对不对,给的路径是否存在,任务描述有没有具体文件名,Node 版本和 Git 状态正不正常,Key 有没有权限,prompt 是不是过长,终端回显里报了什么。大多数新手问题其实卡在中间三环。

一分钟速查

常见问题

问:它答非所问怎么办?

答:先查输入。当前目录对不对、路径是否存在、任务描述里有没有具体文件名,多数是任务没给清楚。

问:怎么防止它顺手改坏别的文件?

答:提示词里写清可改文件范围和禁止触碰的目录,再补一句最小修改、不要重构。

问:它一直停着等我确认?

答:那是沙箱在等授权。先看清它要执行的命令,确认安全再放行。

问:多文件重构怎么控制风险?

答:先只读出方案,再做最小改动看 diff,最后才跑多文件任务并接上测试验证。

来源与编译

本文转载自CSDN(刘炳琦) 《Codex落地指南:从安装配置到多文件重构的完整实践》,原文链接:https://blog.csdn.net/weixin_42527654/article/details/170554085。版权归原作者所有,如需删除请联系我们。

相关阅读

  • Claude Code 聊到三十轮就失忆,先管上下文
  • Grok Bot 一开口就 404,接口地址别塞进技能里
  • 米哈游公开能玩《星穹铁道》的模型 Gamer:只看屏幕、输出键鼠,不是已上线工具
  • Codex 越改越乱,一个 Thread 只做一件事
  • Claude Code Skill 装了不生效,先查三件事
  • Grok Bot 剪口播,三段提示词连原片都不碰

浏览更多「AI」文章 ›

  • 先跑通一条最小链路,再谈功能
  • 三个阶段,别一步跳到自动执行
  • 五个先理解的概念
  • 最容易踩的三个坑
  • 一分钟速查
  • 常见问题
  • 来源与编译

文章导航

上一篇Grok Bot 一开口就 404,接口地址别塞进技能里
下一篇Claude Code 聊到三十轮就失忆,先管上下文

相关文章

Claude Code 聊到三十轮就失忆,先管上下文 Claude Code 聊到三十轮就失忆,先管上下文 Grok Bot 一开口就 404,接口地址别塞进技能里 Grok Bot 一开口就 404,接口地址别塞进技能里 Gamer 项目页公开的《崩坏:星穹铁道》游戏画面拼接图 米哈游公开能玩《星穹铁道》的模型 Gamer:只看屏幕、输出键鼠,不是已上线工具

沙雕应用推荐

弹幕求生 弹幕求生 珍爱生命,远离网络梗。躲避袭来的弹幕,擦弹还能加经验与分数。 去玩一下 ↗

评测设计产业杂谈

软件技术分享

关于电子游戏的方方面面

栏目

  • 游戏产业
  • 游戏设计
  • 游戏热点
  • 工具指南
  • AI
  • 沙雕应用
  • 游戏7x24小时
  • 关于妙游社

本站

  • 首页
  • 隐私政策
  • 联系我们
  • 关于妙游社
  • 工具指南专题
  • 文章 RSS

关注公众号

沙漏社公众号二维码

© 2026 软件技术分享

沪ICP备19032461号-1

目录

×
  • 先跑通一条最小链路,再谈功能
  • 三个阶段,别一步跳到自动执行
  • 五个先理解的概念
  • 最容易踩的三个坑
  • 一分钟速查
  • 常见问题
  • 来源与编译
→ 目录