第 4 章：Codex 的文件与项目管理

你不会写代码？没关系。Codex 会帮你搞定文件、项目和代码版本管理，你只需要动嘴说就行。

---

4.1 Codex 如何读写文件

有了 Codex，你不用打开编辑器，直接在聊天框里说一句话，就能创建、查看或修改文件。

创建新文件

你只需要说：

「帮我创建一个文件，叫 hello.py，内容是打印'你好，世界！'」

Codex 会立刻在你的项目目录里创建好这个文件。你可以在终端里用 ls 命令看到它。

[截图：Codex 聊天框中输入指令创建新文件并得到成功反馈的界面]

查看文件内容

想看某个文件里写了什么？直接说：

「帮我看看 config.json 里面的内容。」

Codex 会打开文件并把内容展示给你。如果文件很长，它还会告诉你总共有多少行。

编辑文件

想修改某一行内容？说清楚你要改什么：

「把 index.html 第 15 行的标题从'我的网站'改成'零零AI 官网'。」

Codex 会用补丁（patch）方式来修改文件——就像用便利贴贴上去修改，而不是重写整个文件。这样更精确，也不会误删其他内容。

删除文件

「把 test.txt 删掉，我不用了。」

Codex 会先跟你确认，然后执行删除操作。

🧠 小技巧：你不需要记住文件路径，直接说文件名就行。Codex 会在当前项目里自动找到它。

---

4.2 项目操作

项目就是一堆文件放在一个文件夹里。Codex 可以把整个项目当成一个整体来操作。

新建项目

想开始一个新项目？说：

「帮我创建一个新的 Python 项目，名字叫 my-blog，放在桌面。」

Codex 会帮你：

1. 创建 my-blog/ 文件夹
2. 在里面放上项目需要的基本文件（比如 main.py、README.md）
3. 如果有需要，还会帮你初始化好配置

添加文件到项目

「在 my-blog 项目里新建一个文件叫 about.md，写一些关于我的介绍。」

组织目录结构

项目文件多了容易乱？跟 Codex 说一声就行：

「帮我把 images/ 文件夹里的所有图片按日期归类，放到 images/2025/、images/2026/ 这样的子文件夹里。」

或者：

「帮我把项目整理一下，所有 .css 文件放到 styles/ 文件夹，所有 .js 文件放到 scripts/ 文件夹。」

Codex 会分析当前目录结构，然后执行整理操作。

[截图：Codex 执行项目文件整理前后对比]

---

4.3 Git 集成（版本控制）

Git 是个版本控制工具，说白了就是给你的文件"存档"。每次修改都可以保存一个版本，想回到哪一天就回到哪一天。

Codex 把 Git 变得超级简单——你不用记任何命令，说话就行。

查看状态

想知道项目里哪些文件被改过？说：

「看看现在的 Git 状态。」

Codex 会告诉你哪些文件是新添加的、哪些被修改过、哪些删除了。

提交更改

改完代码想存个快照？说：

「帮我提交所有修改，提交信息写'修复了登录页面的按钮样式问题'。」

Codex 会执行：

git add .
git commit -m "修复了登录页面的按钮样式问题"

创建分支

分支就是"平行世界"——你可以在分支里随便改，不影响主版本。说：

「帮我创建一个新分支叫 add-dark-mode，然后切换到上面去。」

查看提交历史

「帮我看看最近 5 次提交记录。」

Codex 会展示每次提交的时间、作者和说明。

提 Pull Request (PR)

PR 是让其他人 review 你的代码改动的流程。Codex 可以帮你完成整个流程：

「帮我创建一个 PR，把 add-dark-mode 分支合并到 main 分支，标题写'新增深色模式'。」

[截图：Codex 在终端中执行 git 命令并显示成功结果的界面]

---

4.4 多文件操作

全局搜索和替换

想象一下，你的网站叫「老王杂货铺」，现在改名叫「老王优选」。所有文件里都要把旧名字换成新名字。一个个改？太累了。

直接跟 Codex 说：

「把项目里所有文件中出现的'老王杂货铺'，全部替换成'老王优选'。」

Codex 会搜索项目里所有文件，把每一处都替换掉。替换前它会告诉你哪些文件会被改动，让你确认。

项目级重构

重构就是"不改功能、只改代码结构"。比如：

「帮我把项目里的所有 console.log 删掉，这些只是调试用的，上线后不需要。」

或者：

「帮我把所有图片路径从 /images/ 改成 /assets/images/。」

Codex 会遍历整个项目，一次性改完所有相关文件。

---

4.5 内置工作区隔离（Built-in Worktrees）

这是 Codex 的一个非常实用的功能。它让你可以在同一个项目里同时处理多个不同的任务，彼此互不干扰。

举个例子

假设你正在做一个网站项目，突然有个紧急 bug 要修，但手上还有一个新功能写了一半：

1. 当前工作区：正在开发新功能，文件各种修改中
2. 新工作区：专门修 bug，改完之后立即上线

如果用传统方式，你得把修改藏起来（stash），或者克隆一份代码。用 Codex 的工作区隔离，你只需要说：

「帮我创建一个新的工作区叫 hotfix-login，专门用来修复登录 bug。」

Codex 会创建一个隔离的环境，你在这个环境里改的文件不会影响主工作区。修完 bug 后，说：

「帮我提交 hotfix-login 工作区的修改，然后切回之前的工作区。」

一切就像没发生过一样——除了 bug 已经修好了。

[截图：Codex 工作区隔离功能的界面展示，显示多个工作区并列]

什么时候用它？

• 同时做多个功能开发
• 紧急 bug 需要优先修复
• 想实验新想法又不想搞乱现有代码
• 多人协作时保持各自的修改独立

---

本章小结：Codex 把文件操作、项目管理和版本控制全部变成了"说话就能搞定"的事。不管你是创建文件、搜索替换还是管理 Git 分支，都不用记命令、不用点鼠标，只管说需求就行。

---