Git on YSY的博客

用本地 Codex 并行开发同一个项目

Fri, 31 Jul 2026 00:00:00 +0000

本文演示如何借助本地 Codex 和 Git 工作树，让多个对话同时推进同一个项目中的不同任务。核心原则是先划分清楚任务边界，再分别开发、提交和合并。

本文介绍两种工作流：临时工作树适合一次性的并行任务；永久工作树适合需要持续维护同一条开发线的场景。无论采用哪一种，都应避免多个任务同时修改同一批文件。

1. 临时工作树：适合一次性并行任务

临时工作树的特点是每次新建对话时创建一个分支和对应的工作树。任务完成并合并后，这个工作树通常不再继续使用，适合功能开发、测试补充或独立问题排查等短期任务。

1.1 创建工作树并分配任务

首先新建一个对话。

然后将本地环境切换到新的工作树。

接下来，为第一个工作树分配任务。重复“新建对话、创建工作树、分配任务”的过程，就可以让多个对话并行修改同一个项目。

在开始前，建议明确每个任务负责的模块和文件范围。例如，一个任务负责接口实现，另一个任务负责测试，第三个任务负责前端页面。任务说明中最好同时写清目标、涉及目录、验收方式和不应修改的文件，避免后续合并时出现冲突或重复工作。

多个任务并行执行后的效果如下：

1.2 要求每个任务完成收尾

当某个工作树中的任务完成后，可以向对应对话发送下面这段提示，确保它在提交前完成必要的检查：

1
2
3
4
5
6


请停止继续扩展范围，完成当前任务的收尾：

1. 运行本任务相关测试、Ruff、Python 编译和 git diff --check。
2. 只提交你自己修改的文件，不要更新 docs/任务书.md、docs/完成记录.md。
3. 创建一个清晰的 Git 提交。
4. 回复提交哈希、修改文件列表、测试结果和已知风险。

这样可以让每个并行任务都产出独立、可审查的提交，也便于后续定位问题。

1.3 将各工作树的改动合并到主线

当各工作树完成 Git 提交后，回到主工作区的终端，按提交间的依赖关系依次执行 cherry-pick。例如：

1
2
3
4


git cherry-pick <A 的提交哈希>
git cherry-pick <C 的提交哈希>
git cherry-pick <E 的提交哈希>
git cherry-pick <D 的提交哈希>

这些命令会将各工作树中的提交复制到主线。每次执行 cherry-pick 后，都应检查当前工作区状态和补丁格式：

1
2


git status --short
git diff --check

如果发生冲突，应在主工作区统一处理，不要回到原工作树反复修改同一处代码。处理完成后继续执行 cherry-pick，并在所有提交合并完成后运行完整测试。

2. 永久工作树：适合持续维护的任务

如果某个任务需要跨多次对话持续推进，或你希望长期保留它的独立开发环境，可以创建永久工作树。它不需要在每次开始新对话时重复创建分支，更适合持续迭代的功能或长期维护的模块。

2.1 创建永久工作树

在项目右侧的三个点菜单中，选择创建永久工作树。

创建完成后，先向 AI 发送一条只读检查指令，确认当前工作树的根目录和 Git 状态：

1

请只执行 git rev-parse --show-toplevel 和 git status --short，不修改任何文件，并报告输出结果。

确认工作树状态无误后，再为它创建对应的分支。

后续可以持续在这个工作树中推进同一类任务。需要将成果并入主线时，仍然应遵循独立提交、审查差异和集中处理冲突的原则。

3. 如何选择工作树方式

临时工作树：适合目标明确、完成后即可合并的一次性任务。
永久工作树：适合跨多个阶段持续迭代，或需要长期保留上下文和开发环境的任务。

无论使用哪种方式，任务之间的文件边界越清晰，最终合并就越顺畅。

4. 小结

使用本地 Codex 并行开发的重点不在于同时开启多少个对话，而在于任务边界清晰、每项改动独立提交，并在主工作区集中完成合并与验证。这样既能提升并行效率，也能控制集成风险。

新电脑 Git 初始化配置指南

Wed, 11 Feb 2026 00:00:00 +0000

1. 问题背景

在新电脑上使用 Git 时，常常会因为缺少必要配置而遇到各种问题：

无法连接 GitHub（网络问题）
提交代码时提示缺少用户信息
中文文件名显示为乱码

本文整理了新机 Git 初始化的完整流程，帮助你快速配置好开发环境。

2. 配置代理

如果你需要使用代理工具访问 GitHub，首先需要配置 Git 的网络代理。

2.1. 查找代理端口

不同的代理工具使用的端口不同：

Clash：默认端口 7890
Clash Verge：默认端口 7897
其他工具：可在工具的设置中查看

2.2. 设置代理

在 Git Bash 或终端中输入以下命令（将 7897 替换为你的实际端口）：

1
2


git config --global http.proxy http://127.0.0.1:7897
git config --global https.proxy http://127.0.0.1:7897

2.3. 验证配置

输入以下命令查看配置是否生效：

1

git config --global -l

如果看到以下输出，说明代理配置成功：

1
2


http.proxy=http://127.0.0.1:7897
https.proxy=http://127.0.0.1:7897

3. 配置用户信息

Git 在提交代码时需要记录提交者的身份信息。

3.1. 设置用户名和邮箱

在引号内填入你的 GitHub 用户名和邮箱（建议使用 GitHub 绑定的邮箱）：

1
2


git config --global user.name "你的 GitHub 用户名"
git config --global user.email "your-email@example.com"

示例：

1
2


git config --global user.name "sign-river"
git config --global user.email "example@gmail.com"

4. 解决中文文件名乱码问题

如果你的项目中有中文文件名，Git 默认会将其转义为八进制编码，显示为乱码（如 \344\270\255\346\226\207）。

4.1. 设置显示中文

执行以下命令禁用路径引号转义：

1

git config --global core.quotepath false

配置后，git status 等命令就能正常显示中文文件名了。

5. 完整配置脚本

如果你想一次性完成所有配置，可以复制以下命令并修改对应的值：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# 配置代理（根据实际端口修改）
git config --global http.proxy http://127.0.0.1:7897
git config --global https.proxy http://127.0.0.1:7897

# 配置用户信息（替换为你的信息）
git config --global user.name "你的用户名"
git config --global user.email "your-email@example.com"

# 解决中文乱码
git config --global core.quotepath false

# 查看所有配置
git config --global --list

6. 常见问题

6.1. Q1: 如何取消代理配置？

如果不再需要代理，可以使用以下命令移除：

1
2


git config --global --unset http.proxy
git config --global --unset https.proxy

6.2. Q2: 如何修改已有的配置？

直接重新执行设置命令即可覆盖旧配置，或者使用以下命令编辑配置文件：

1

git config --global --edit

6.3. Q3: 配置是否对所有仓库生效？

--global 参数表示全局配置，对当前用户的所有 Git 仓库生效。如果只想针对某个仓库配置，可以去掉 --global 参数，在仓库目录下执行命令。

7. 总结

完成以上配置后，你的新电脑就可以正常使用 Git 进行开发了。这些配置只需要执行一次，之后就可以专注于代码本身。

如果遇到其他 Git 相关问题，欢迎在评论区讨论！