在数字化出海与一人公司业务落地中，掌握 与 Git 和 GitHub 无缝整合的 的底层逻辑与实操细节至关重要。本文将结合一线实战经验进行全链路复盘。
3.7 代码管理（Git 与 GitHub 工作流）
用 Codex 做真实项目时，一定要懂一点 Git 和 GitHub。
小白可以先这样理解：
Git = 本地代码版本管理工具
GitHub = 把代码放到网上协作的平台
Codex = 帮你读代码、改代码、跑命令的 AI 编程助手一句话：
Git 负责记录代码变化。
GitHub 负责远程保存和协作。
Codex 负责帮你完成具体编程任务。Git 和 GitHub 有什么区别
| 对比 | Git | GitHub |
|---|---|---|
| 简单来说 | 本地版本管理工具 | 代码云盘 + 协作平台 |
| 主要作用 | 记录代码每次改了什么 | 远程保存代码、团队协作 |
| 使用位置 | 你的电脑里 | 浏览器 / 云端 |
| 核心能力 | commit、branch、diff、merge | repository、issue、pull request |
| 是否必须联网 | 不需要 | 需要 |
| 和 Codex 的关系 | Codex 改完代码后，用 Git 检查和保存 | Codex Web / Cloud 常和 GitHub 配合 |
小白必须先懂的 Git 概念
| 概念 | 简单来说 | 作用 |
|---|---|---|
| Repository | 一个代码仓库 | 存放整个项目 |
| Commit | 一次代码存档 | 记录这次改了什么 |
| Branch | 分支 | 在不影响主线的情况下改代码 |
| Diff | 改动对比 | 看新增、删除、修改了什么 |
| Stage | 暂存区 | 准备把哪些改动保存进 commit |
| Merge | 合并 | 把一个分支的改动合到另一个分支 |
| Conflict | 冲突 | 两边改了同一处代码，需要手动选择 |
| Push | 推送 | 把本地代码上传到 GitHub |
| Pull | 拉取 | 把 GitHub 上的新代码同步到本地 |
| Clone | 克隆 | 从 GitHub 下载一个项目到本地 |
小白必须先懂的 GitHub 概念
| 概念 | 简单来说 | 作用 |
|---|---|---|
| Repository | GitHub 上的项目仓库 | 存代码 |
| Issue | 问题 / 需求记录 | 记录 bug、需求、任务 |
| Pull Request / PR | 代码合并申请 | 改完代码后申请合并 |
| Main Branch | 主分支 | 项目的稳定版本 |
| Feature Branch | 功能分支 | 用来开发新功能 |
| Review | 代码检查 | 合并前检查代码 |
| Actions | 自动化流程 | 自动测试、构建、部署 |
| README | 项目说明书 | 告诉别人项目怎么用 |
| .gitignore | 忽略文件清单 | 防止上传无关或敏感文件 |
为什么用 Codex 更需要 Git
| 场景 | 为什么需要 Git |
|---|---|
| Codex 改了很多代码 | 可以查看具体改了哪里 |
| Codex 改错了 | 可以回退到之前版本 |
| Codex 删除了不该删的内容 | 可以用 Git 找回 |
| 多次让 Codex 修改 | 每次 commit 保存一个阶段 |
| 想让 Codex 大胆试方案 | 用 branch 或 worktree 隔离风险 |
| 要把项目放到 GitHub | 需要 push 到远程仓库 |
| 团队协作 | 需要 PR、review、merge |
一句话：
没有 Git，Codex 改错了你很难回退。
有了 Git，Codex 可以放心试，你可以随时检查和恢复。如何在 Codex 中使用 Git
| 步骤 | 操作 | 目的 |
|---|---|---|
| 1 | 初始化 Git | 让项目开始被 Git 管理 |
| 2 | 写好.gitignore | 防止上传垃圾文件和密钥 |
| 3 | 先 commit 一次 | 保存干净版本 |
| 4 | 新建分支 | 给 Codex 一个安全实验区 |
| 5 | 让 Codex 修改代码 | 完成具体任务 |
| 6 | 查看 diff | 检查 Codex 改了什么 |
| 7 | 运行项目 / 构建 | 确认没出错 |
| 8 | 满意后 commit | 保存这次修改 |
| 9 | push 到 GitHub | 上传远程仓库 |
| 10 | 创建 PR | 合并前再检查一次 |
在 Codex 对话框中输入：把项目初始化成一个 Git 工程，并排除不需要的文件
Codex 会帮我们直接写好.gitignore 文件
如何在 Codex 中使用 GitHub
使用前需要准备什么
| 准备项 | 作用 | 简单来说 |
|---|---|---|
| GitHub 账号 | 保存远程代码 | 代码云盘账号 |
| Git | 本地版本管理 | 记录代码变化 |
| GitHub 仓库 | 放项目代码 | 一个远程项目文件夹 |
| 本地项目 | Codex 要修改的代码 | 电脑里的项目文件夹 |
| GitHub 登录权限 | 允许 push / PR | 证明这是你的仓库 |
| .gitignore | 防止上传无关文件 | 不上传垃圾文件和密钥 |
标准上传流程
| 步骤 | 操作 | 目的 |
|---|---|---|
| 1 | 在 GitHub 新建仓库 | 创建一个远程项目空间 |
| 2 | 复制仓库地址 | 后面要连接本地项目 |
| 3 | 将地址复制给 Codex | 让 Codex 知道要上传到哪个仓库 |
| 4 | 推送到 GitHub | 正式上传代码 |
创建 GitHub 仓库
复制仓库地址
将地址复制给 Codex
Codex平台中“做一个首页”项目的页面
推送到 GitHub
代码回滚
修改代码
先让 AI 修改一下代码
提交到 Git，保存好当前版本
继续修改代码
打开 IDE 查看代码并且回退代码
先打开 IDE 查看代码
复制版本号
复制给 Codex，让它回退代码到指定版本
Git Worktree
给同一个 Git 项目，额外开一个独立工作副本。
相当于一个草稿本，效果满意后再合并回正式项目。
为什么需要 Worktree
普通 Git 分支虽然可以切换，但每次只能在一个文件夹里操作一个分支。
Worktree 的好处是：
| 场景 | Worktree 的作用 |
|---|---|
| 想让 Codex 大胆改代码 | 给它单独开一个副本 |
| 不想影响当前项目 | 主项目保持不动 |
| 想同时做多个任务 | 每个任务一个 worktree |
| 想比较多个方案 | 方案 A / B / C 分开放 |
| 改坏了不想要 | 直接丢掉 worktree |
| 做大改动 / 重构 | 降低污染主项目的风险 |
创建 Worktree
Codex平台界面，左侧为项目列表，其中“hello – codex\_2”项目被红色框突出显示
使用分支进行任务
Gitpod界面中“hello – codex\_2”分支的代码编辑区域
合并回主干
检查效果满意后，就可以合并回主干，并把这个分支删除。
💎 【独家资源】火儿跨境科技 VIP 资料会员：
解锁全站 500+ 实战提示词库、自动化工作流脚本、商业源码与高阶专属圈子，持续沉淀一人公司数字资产。
👉 立即开通 VIP 资料会员（月度订阅 $9.99，即刻畅享核心工具箱） | 查看会员权益与等级说明
🚀 【体系大课】火儿跨境科技 官方实战课程：
告别零散摸索，全案拆解从建站、SEO长效获客到海外广告变现的工业级闭环流水线。
👉 《谷歌SEO优化系统课程》 | 《谷歌广告全系统基础夯实课》 | 《Facebook广告投放基础夯实课》 | 查看全部实战课程专区
💡 进阶指引：本文属于《03Codex从入门到实战》系统实操专栏。如需全面掌握从零构建智能体协作开发环境与自动化工程流水线，欢迎查阅对应大盘母舰专题：AI智能体团队协同。
