Forking 工作流

Forking 工作流 与其他工作流最大的不同在于：它不要求贡献者对同一个中央仓库有写权限。每个开发者都拥有一个完全独立的服务器端仓库（Fork），以 Upstream 为权威集成点，通过 Fork 和 Pull Request 贡献代码。

这种模式是代码托管平台（如 GitHub、GitLab、Bitbucket 等）的核心协作方式，也是开源项目维护的标准流程。

核心概念

在 Forking 工作流中，涉及三个主要角色的仓库：

Upstream (上游/官方仓库)：项目的权威版本，通常由项目维护者管理。普通贡献者没有写入权限。
Origin (你的远程 Fork)：你从 Upstream 派生（Fork）出来的仓库，位于你的 GitHub 账号下。你有完全的读写权限。
Local (本地仓库)：你电脑上的仓库，用于实际写代码。

工作流程详解

1. Fork (派生)

开发者首先在 GitHub 上点击 “Fork” 按钮，将官方仓库复制一份到自己的账号下。这是一个服务器端的克隆操作。

2. Clone (克隆)

将你自己的远程仓库 (origin) 克隆到本地。

git clone https://github.com/your-username/repo.git

3. 配置 Upstream

为了保持与官方仓库同步，你需要在本地添加一个指向 Upstream 的远程链接。

git remote add upstream https://github.com/maintainer/repo.git

4. 开发与推送

你在本地创建分支、修改代码，并推送到你自己的远程仓库 (origin)。

git push origin feature/new-idea

5. Pull Request (发起请求)

在 GitHub 页面上，发起一个 Pull Request (PR)，请求将你的 feature/new-idea 分支合并到 upstream 的主分支。

6. 同步 (Sync)

在开发过程中，upstream 可能会更新。你需要定期拉取这些更新到本地，并合并到你的分支，以避免冲突。

git fetch upstream
git merge upstream/main

数据流向图

下图展示了典型的“三角形”数据流向：

flowchart TD
    subgraph Maintainer [维护者区域]
        Upstream[Upstream 官方仓库]
    end

    subgraph Contributor [贡献者区域]
        Origin[Origin 远程 Fork]
        Local[Local 本地仓库]
    end

    %% 流程线
    Upstream --1. Fork--> Origin
    Origin --2. Clone--> Local
    Local --3. Commit & Push--> Origin
    Origin --4. Pull Request--> Upstream
    Upstream --5. Fetch/Pull (Sync)--> Local

    %% 样式定义
    classDef upstream fill:#e53e3e,stroke:#c53030,color:#fff,stroke-width:2px
    classDef fork fill:#3182ce,stroke:#2c5282,color:#fff,stroke-width:2px
    classDef local fill:#38a169,stroke:#276749,color:#fff,stroke-width:2px

    class Upstream upstream
    class Origin fork
    class Local local

优缺点分析

优点

权限隔离：贡献者不需要官方仓库的写入权限，维护者可以安全地接受外部贡献。
保持主库整洁：所有的半成品代码都待在贡献者自己的仓库里，不会弄脏官方仓库的分支列表。
团队协作：即使是公司内部项目，使用 Forking 也能强制实施 Code Review（通过 PR），并防止新人误删主分支。

缺点

同步繁琐：必须手动配置并定期同步 upstream，对于 Git 初学者来说容易混淆 origin 和 upstream。
流程较长：对于极小的修改（如改个错别字），Fork -> Clone -> Push -> PR 的流程显得有些“杀鸡用牛刀”。

适用场景

开源项目：这是最常见、最主流的方案之一，允许全球任何人参与贡献。
大型外包团队：如果你不希望外包人员直接访问核心代码库的写权限。
高安全性项目：需要严格控制合入权限的敏感项目。