赵承铭很多开发者在本地用Git已经很熟练了：clone、commit、push、pull这些命令闭着眼睛都能敲。但真要给一个开源项目提交贡献时，第一反应往往是“我该把代码推到哪里去？”——你发现你根本没法直接往人家的仓库里push。你得先fork，再clone，再建分支，改完代码后推到自己的fork，最后发起Pull Request。很多人就卡在了这一连串流程里：fork和clone到底什么关系？为什么我不能直接在原仓库上开个分支？upstream又是什么鬼？
这篇文章就是为这些疑问准备的。我按自己的理解，把一套完整的、以“贡献”为目标的Git全流程拆开来讲，从环境安装配置讲起，到第一个Pull Request被合并，再到长期维护一个fork的同步策略。它适合谁看？适合那些已经会基本Git命令、但还没完整走通过一次开源贡献流程的人；也适合已经提交过PR、但被维护者要求“请先rebase一下”之后不知道该怎么办的人。这套流程走一遍，你对Git的协作模型才算真正建立起来。
1. 为什么“会Git命令”和“会贡献”是两回事
1.1 你熟悉的Git其实是“小团队模式”
先说一个很多人没意识到的点：你平时在公司或个人项目里用的Git，和开源贡献时用的Git，本质上不是同一套协作模型。
在公司里，通常大家共享同一个远程仓库，每个人都有push权限。你要加功能就git checkout -b feature-xxx，改完git push origin feature-xxx，然后直接在GitLab或GitHub上发起Merge Request或Pull Request让同事review。别人review完，点击合并，完事。
这套流程里，所有分支都活在同一个远程仓库里。你不需要fork，因为你本来就有写权限。
但开源项目不是这样的。绝大多数开源项目，维护者不可能给全世界每个想贡献的人开放写权限。所以平台方设计了一套更稳妥的模型：你想贡献，先在我的仓库旁边复制一份完全属于你的仓库副本，这个动作就叫fork；你在你的副本上随便折腾，改好了，再发起一个请求，请维护者“把你的改动拉回去”。这个请求就是Pull Request。
1.2 开源贡献用的是“fork + PR”模型
所以，一旦进入开源贡献场景，你的本地Git仓库要同时面对三个“仓库”：
- 本地仓库：你clone下来并正在编辑代码的那个目录。
- 你的远端仓库（origin）：你fork出来的、属于你自己的GitHub/GitLab/Gitee仓库。你有完全写权限。
- 上游仓库（upstream）：项目官方维护的那个原始仓库。你只有读权限，除非你的PR被合并。
这三者之间的关系，是理解整个贡献流程的地基。很多新人在看到git remote -v输出两行地址时就开始晕了，其实只要记住一个核心原则：你往origin推，你从upstream拉，你的PR是从origin指向upstream的“申请”。
1.3 全流程里的隐藏要求
另外，这套流程对提交历史的要求，比小团队模式严格得多。在团队里你敲一个“fix bug”的commit message，同事碍于面子可能就merge了。但在开源项目里，维护者和审查者每天要面对几十上百个PR，他们没时间猜你想干什么。你的commit message写得不清不楚、你的PR描述没有交代测试情况、你的分支上堆了一堆“wip”、“haha”之类的提交……这些都会直接拉低你的PR被合入的概率。
所以“从入门到精通”的关键转折点，不是你掌握了多少Git命令，而是你有没有建立起一种意识：你的提交历史、PR描述，本质上是你写给维护者和未来贡献者的一份“沟通文档”。后面几节我会把每个环节怎么做都讲清楚。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备：安装、身份配置与SSH密钥里最容易被忽略的三个细节
2.1 安装Git：不同系统的快速路径
这个部分虽然基础，但为了保证流程完整还是说一下。
- Windows：直接下载Git for Windows安装包，一路Next。装完后你会拥有Git Bash，这是Windows上体验最接近Linux终端的环境。
- macOS：推荐用Homebrew安装，
brew install git，比官网下载的dmg包更好管理版本。 - Linux：各发行版包管理器直接装就行，
sudo apt install git或sudo dnf install git。
装完之后验证一下：git --version，能输出版本号就OK。但注意，这只是开始。真正决定你后面能否顺畅提交PR的，是接下来几个配置项。
2.2 第一件事不是clone，而是配置身份
很多人clone完项目才发现，自己提交人的名字是“user”或者一串乱码，头像也不显示。问题出在最基础的两行配置上：
bash复制git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
这里有个很容易被忽略的点：user.name和user.email会作为提交作者信息永久写入Git历史里，开源项目里所有提交都是公开的。所以请务必用你确实想展示的名字，以及和你的代码托管平台账号绑定的邮箱。
比如你在GitHub上开启了“邮箱隐私保护”，GitHub会给你一个形如`12345678+user