Codex使用教程

VS Code+Git+GitLens+Codex

使用这种方式应对Codex客户端无法像Antigravity那样实时显示文件变动情况的缺陷，并且保证每次修改有迹可寻有路可退

我的要求

• 我改了哪些文件，一眼能看到
• 每个文件增删多少行，能看到
• 具体改了哪几行，能对比
• 改坏了能回退
• 不满意可以只撤回某一个文件或某几行

操作流程

第一步：装环境

下载3个东西

1. Git for Windows

   下完安装，然后终端执行命令git --version

2. VS Code

3. GitLens 插件

   VS Code扩展市场搜索

第二步：项目纳入Git管理

进入本地项目根目录，执行命令：

1. git init 初始化当前目录为git仓库
2. 配置 .ignore 文件（直接让ai搞这个文件就行）：排除依赖、缓存、构建产物和本地文件，避免脏文件进入版本库
3. git add . 把需要纳管的文件加入暂存区，准备生成首个版本
4. git commit -m "baseline before codex" 创建首个基线版本，作为后续修改的可回退起点

如果它提示你没有用户名邮箱，就先设置：

git config --global user.name "你的名字" 
git config --global user.email "[email protected]"

第三步：在VS Code里查看改动

打开项目后，左侧点 Source Control（源代码管理器）

这里你会直接看到：

• 哪些文件被改了
• 哪些文件是新增
• 哪些文件被删除

点开某个文件，就会看到左右对比：

• 左边旧版本
• 右边新版本

颜色含义通常是：

• 绿色：新增
• 红色：删除
• 蓝色/高亮：修改

顺便记一下这两个区的含义：

• 暂存的更改：这次会被提交的文件
• 更改：这次不会被提交的文件

第四步：看每个文件的详细变动情况

最直接的方法有 3 个。

1. 在终端看总统计

git diff --stat

你会看到类似：

src/a.vue | 12 +++++---- src/b.java | 35 ++++++++++++++++++------- 2 files changed, 30 insertions(+), 17 deletions(-)

1. 看详细 diff

git diff

1. 在 VS Code 里看单文件 diff 直接点 Source Control 里的文件名。

如果你装了 GitLens，体验会更好：

• 能看文件历史
• 能看是谁什么时候改的
• 能按提交追溯
• 能更方便看 diff 和 blame

第五步：建立“先看后改、改完复查”的工作流

以后你每次让我动手，建议固定按这个流程：

1. 改之前看一眼状态

   git status

2. 让我改

3. 改完后看改动

   git diff --stat

如果你想细看，再去 VS Code 里看 diff

第六步：如果改坏了，怎么恢复

这是最重要的实战部分。

1. 只撤销某个文件的未提交改动

git restore 路径\文件名

例如：

git restore web-vue\src\views\user\Home.vue

1. 撤销全部未提交改动

git restore .

1. 如果已经提交了，但你想回到上一个版本 先看历史：

git log --oneline

再回退到某个提交：

git reset --hard 提交ID

这条命令是强回退，危险，但在你明确要恢复时很好用。

1. 更稳一点的方法：用 VS Code 图形界面恢复

   在 Source Control 或 GitLens 里：

   • 右键文件
   • 选择恢复
   • 或者从某个历史提交恢复内容

第七步：怎么防止“中文乱码惨案”

你室友那个情况，多半是编码问题。这个要提前防。

建议你现在就做这几件事：

1. VS Code 右下角检查当前文件编码 尽量统一成 UTF-8
2. VS Code 设置自动保存为 UTF-8
3. 项目根目录加一个 .editorconfig 内容可以先用这个：

root = true [*] charset = utf-8 end_of_line = lf insert_final_newline = true indent_style = space indent_size = 2 [*.java] indent_size = 4 [*.py] indent_size = 4

1. Git 里尽量不要混用奇怪编码的老文件

   特别是：

   • yml
   • properties
   • java
   • vue

2. 每次大改前先提交基线 这样就算乱码，也能直接恢复。

第八步：怎么和我配合最省心

你以后可以直接这样给我指令：

• “先不要改，先告诉我会改哪些文件”
• “改完后给我 git diff --stat 级别的总结”
• “只改这两个文件，别碰别的”
• “先做最小改动，方便我 review”
• “大改前提醒我先 commit 一个 checkpoint”

我也建议你固定要求我按这个格式汇报：

• 修改文件
• 主要改动
• 风险点
• 如何验证

这样你的可控感会高很多。

第九步：最适合你的落地习惯

如果你是答辩阶段，我建议你就用下面这个最简单流程，不折腾：

1. 用 VS Code 打开项目
2. 初始化 Git
3. 提交一版 baseline
4. 每次让我改之前先 commit checkpoint
5. 改完用 Source Control 看 diff
6. 确认没问题再提交
7. 出问题就 restore 或回退到 checkpoint