git fork 分支总结

在 Git 中，fork 操作本身是在代码托管平台（如 GitHub、GitLab、Gitee）上完成的（非本地 Git 命令），但后续的代码同步、修改和提交需要结合本地 Git 命令。以下是完整的操作流程和所需命令：

一、前提条件

• 拥有代码托管平台账号（如 GitHub）。
• 目标仓库的访问权限（公开仓库可直接 fork，私有仓库需被授权）。
• 本地安装 Git，并配置好用户名和邮箱（git config --global user.name "你的名字" 和 git config --global user.email "你的邮箱"）。

二、操作步骤（以 GitHub 为例）

步骤 1：在平台上 fork 目标仓库（非命令行操作）

1. 打开目标仓库的 GitHub 页面（例如：https://github.com/原作者用户名/仓库名）。
2. 点击页面右上角的 Fork 按钮，等待几秒后，平台会在你的账号下创建该仓库的副本（地址为：https://github.com/你的用户名/仓库名）。

   这一步是平台操作，无需 Git 命令，目的是创建独立副本。

步骤 2：将 fork 的副本克隆到本地

在本地终端执行以下命令，将你账号下的 fork 副本下载到本地：

# 克隆你fork的仓库（替换为你的仓库地址）
git clone https://github.com/你的用户名/仓库名.git

# 进入仓库目录
cd 仓库名

步骤 3：关联上游仓库（重要！用于同步原仓库更新）

fork 后的副本不会自动同步原仓库的新内容，需手动关联原仓库（称为 “上游仓库”）：

# 添加上游仓库（替换为原仓库地址）
git remote add upstream https://github.com/原作者用户名/仓库名.git

# 验证关联是否成功（会显示 origin 和 upstream 两个远程仓库）
git remote -v

• origin：默认指向你 fork 的副本（自己的仓库）。
• upstream：指向原仓库，用于同步最新代码。

步骤 4：同步上游仓库的最新代码

在本地开发前，建议先同步原仓库的最新更新，避免冲突：

# 拉取上游仓库的所有分支和更新
git fetch upstream

# 切换到本地主分支（通常是 main 或 master）
git checkout main

# 将上游仓库的主分支合并到本地主分支（同步最新代码）
git merge upstream/main

步骤 5：创建本地分支开发功能

为了避免直接在主分支修改，建议创建新分支开发：

# 创建并切换到新分支（例如：feature/new-function）
git checkout -b feature/new-function

步骤 6：修改代码并提交到本地仓库

在新分支中完成代码修改后，提交到本地：

# 查看修改内容
git status

# 添加所有修改到暂存区
git add .

# 提交修改（填写有意义的提交信息）
git commit -m "feat: 新增XX功能，解决XX问题" 

步骤 7：将本地分支推送到自己的 fork 副本

# 推送到自己的远程仓库（origin），分支名与本地一致
git push origin feature/new-function

步骤 8：向原仓库提交 Pull Request（PR）（平台操作）

1. 打开你 fork 的仓库页面（https://github.com/你的用户名/仓库名）。
2. 页面会提示 “Compare & pull request”，点击进入 PR 编辑页面。
3. 选择原仓库的目标分支（通常是 main 或 master）和你的分支（feature/new-function）。
4. 填写 PR 描述（说明修改内容、目的等），点击 “Create pull request” 提交。

   后续原仓库维护者会审核你的 PR，通过后会合并到原仓库。

步骤 9：（可选）删除分支

如果 PR 被合并，可删除本地和远程的临时分支：

# 切换回主分支
git checkout main

# 删除本地分支
git branch -d feature/new-function

# 删除远程分支（如果需要）
git push origin --delete feature/new-function

三、核心命令总结

操作目的	命令
克隆 fork 副本到本地	git clone https://github.com/你的用户名/仓库名.git
关联上游仓库	git remote add upstream 原仓库地址
同步上游仓库更新	git fetch upstream + git merge upstream/main
创建并切换分支	git checkout -b 分支名
提交本地修改	git add . + git commit -m "提交信息"
推送分支到自己的仓库	git push origin 分支名
删除本地 / 远程分支	git branch -d 分支名 + git push origin --delete 分支名

四、注意事项

1. 定期同步上游：开发过程中，原仓库可能有新更新，需定期执行 git fetch upstream + git merge upstream/main 同步，避免合并冲突。
2. 分支命名规范：建议按功能命名分支（如 feature/xxx、bugfix/xxx），便于管理。
3. PR 描述清晰：提交 PR 时详细说明修改内容，帮助维护者快速理解你的贡献。

通过以上步骤，即可完成从 fork 仓库到提交代码贡献的完整流程。