摘要你的代码不能只活在本地硬盘里远程仓库才是协作和备份的最终归宿。本篇将带你注册 GitHub 账号将本地仓库推送到远程再克隆他人的开源项目理解git remote、git push、git pull、git fetch的本质区别并通过一个完整的 Pull Request 流程体验开源协作Fork、Clone、Branch、Commit、Push、Open PR、Code Review、Merge。学完这篇你就可以开始参与全球任何开源项目了。一、远程仓库的概念与 GitHub 简介远程仓库是托管在网络上的项目版本库对 Git 来说它和你本地的.git没有任何本质区别只是通过网络协议HTTPS、SSH来传输数据。GitHub 是全球最大的代码托管平台拥有数千万开发者和数亿仓库。此外还有 GitLab、Bitbucket、Gitee 等。本文以 GitHub 为例。二、关联远程仓库git remote假设你已经有一个本地仓库想在 GitHub 上创建一个对应的远程仓库。登录 GitHub点击右上角→ New repository。填写仓库名称如my-first-git保持 Public。创建后GitHub 会给出一个远程地址如gitgithub.com:你的用户名/my-first-git.git。在本地终端中添加远程仓库的引用git remote add origin gitgithub.com:你的用户名/my-first-git.gitorigin是远程仓库的默认别名你可以取任何名字但业界约定俗成就叫origin。查看已配置的远程仓库git remote -v输出这表示抓取和推送都会去这个地址。三、推送与抓取push、fetch、pull3.1 git push把你的成果分享给世界将本地提交推送到远程git push -u origin main-u是--set-upstream的缩写会将本地main分支与远程origin/main建立追踪关系。以后在这个分支只需git push即可。如果推送失败通常是因为远程仓库有本地不存在的提交别人已经推送过。此时需要先拉取再推送。3.2 git fetch看看外面发生了什么git fetch会将远程仓库的最新提交和分支信息“下载”到本地但不会自动合并你的工作。git fetch origin此时你本地会出现一个origin/main分支远程跟踪分支你可以在合并前检查它git log origin/main --oneline确认无误后再合并git merge origin/main这种fetchmerge的组合拳正是git pull所做的。3.3 git pull拉取并自动合并git pull origin main它等价于git fetch origin git merge origin/main如果本地和远程的分支已经分叉pull可能会产生合并冲突。解决冲突的方式与上一篇文章完全一样。四、克隆仓库git clone参与一个已有项目时无需从零初始化。只需拿到远程地址克隆即可git clone gitgithub.com:torvalds/linux.git克隆完成后你会得到一个完整的本地仓库并自动配置好origin远程。克隆会默认把整个仓库的所有分支都下载下来但只会把main分支检出到工作区。若要切换到远程存在的其他分支例如devgit switch dev如果本地没有dev分支Git 会自动基于同名的远程分支创建追踪分支。五、实战完整的 Pull Request 协作流程假设你想为朋友的开源项目贡献代码但没有直接推送权限。GitHub 的 Fork Pull Request 机制就是为此而生。5.1 第一步Fork 仓库在朋友的 GitHub 仓库页面右上角点击Fork按钮。这会把你朋友的仓库完整复制一份到你自己的 GitHub 账户下。5.2 第二步克隆你自己的 Forkgit clone gitgithub.com:你的用户名/朋友的仓库.git cd 朋友的仓库5.3 第三步添加上游仓库为了保持和你朋友原始仓库的同步通常将朋友的仓库添加为一个远程命名为upstreamgit remote add upstream gitgithub.com:朋友的用户名/朋友的仓库.git5.4 第四步创建功能分支并开发git switch -c fix-typo echo 修正拼写错误 README.md git add README.md git commit -m 修正 README 中的拼写错误5.5 第五步推送到你 Fork 的远程仓库git push -u origin fix-typo5.6 第六步发起 Pull Request在 GitHub 上你的仓库页面通常会看到一个醒目的 “Compare pull request” 按钮。点击后仔细填写标题和描述说明你做了什么改动、为什么要这么做。点击 “Create pull request”。5.7 第七步Code Review 与合并项目维护者你朋友会收到通知审查你的代码。他可能提出修改意见。你在本地做出修改后再次pushPR 会自动更新。最终维护者点击 “Merge pull request”你的贡献就正式并入主项目了。六、保持 Fork 与上游同步在你开发期间朋友的原始仓库可能已经更新。定期同步上游是良好习惯# 获取上游仓库的最新状态 git fetch upstream # 切回 main 分支合并上游的 main git switch main git merge upstream/main # 将同步后的 main 推送到你自己的远程仓库 git push origin main如果你在自己的功能分支上需要上游的新代码也可以将upstream/main合并进来或用rebase保持整洁。七、日常协同中的常见问题7.1 推送被拒绝non-fast-forward当你push时提示! [rejected] main - main (non-fast-forward)说明你本地的main落后于远程。按下面步骤解决git pull --rebase origin main # 解决可能出现的冲突 git push origin main7.2 不小心在 main 分支上做了修改直接push时才发现不应该污染main。冷静只要还没推送到远程# 在 main 上将改动移到一个新分支 git switch -c new-feature # 再切回 main 重置到远程状态 git switch main git reset --hard origin/main这样你的修改安全地转移到了new-feature分支main又恢复干净。总结远程仓库是代码协作的基石origin是默认别名。git push上传git fetch下载而不合并git pullfetchmerge。git clone克隆整个仓库自动建立远程关联。Fork Pull Request 是 GitHub 开源协作的标准姿势Fork → Clone → Branch → Commit → Push → Open PR → Review → Merge。推送被拒时先拉取再推送保持分支整洁可以多用--rebase。如果这篇文章帮你解决了实操上的困惑别忘记点击点赞、分享也可以留言告诉我你遇到的其它问题我会尽快回复。动手练习是掌握编程最快的方法请务必亲手敲一遍本文的所有示例代码并截图保存你的成果。你的关注是我坚持原创和细节共享的力量来源谢谢大家。
连接世界——远程仓库与 GitHub 协作实战
摘要你的代码不能只活在本地硬盘里远程仓库才是协作和备份的最终归宿。本篇将带你注册 GitHub 账号将本地仓库推送到远程再克隆他人的开源项目理解git remote、git push、git pull、git fetch的本质区别并通过一个完整的 Pull Request 流程体验开源协作Fork、Clone、Branch、Commit、Push、Open PR、Code Review、Merge。学完这篇你就可以开始参与全球任何开源项目了。一、远程仓库的概念与 GitHub 简介远程仓库是托管在网络上的项目版本库对 Git 来说它和你本地的.git没有任何本质区别只是通过网络协议HTTPS、SSH来传输数据。GitHub 是全球最大的代码托管平台拥有数千万开发者和数亿仓库。此外还有 GitLab、Bitbucket、Gitee 等。本文以 GitHub 为例。二、关联远程仓库git remote假设你已经有一个本地仓库想在 GitHub 上创建一个对应的远程仓库。登录 GitHub点击右上角→ New repository。填写仓库名称如my-first-git保持 Public。创建后GitHub 会给出一个远程地址如gitgithub.com:你的用户名/my-first-git.git。在本地终端中添加远程仓库的引用git remote add origin gitgithub.com:你的用户名/my-first-git.gitorigin是远程仓库的默认别名你可以取任何名字但业界约定俗成就叫origin。查看已配置的远程仓库git remote -v输出这表示抓取和推送都会去这个地址。三、推送与抓取push、fetch、pull3.1 git push把你的成果分享给世界将本地提交推送到远程git push -u origin main-u是--set-upstream的缩写会将本地main分支与远程origin/main建立追踪关系。以后在这个分支只需git push即可。如果推送失败通常是因为远程仓库有本地不存在的提交别人已经推送过。此时需要先拉取再推送。3.2 git fetch看看外面发生了什么git fetch会将远程仓库的最新提交和分支信息“下载”到本地但不会自动合并你的工作。git fetch origin此时你本地会出现一个origin/main分支远程跟踪分支你可以在合并前检查它git log origin/main --oneline确认无误后再合并git merge origin/main这种fetchmerge的组合拳正是git pull所做的。3.3 git pull拉取并自动合并git pull origin main它等价于git fetch origin git merge origin/main如果本地和远程的分支已经分叉pull可能会产生合并冲突。解决冲突的方式与上一篇文章完全一样。四、克隆仓库git clone参与一个已有项目时无需从零初始化。只需拿到远程地址克隆即可git clone gitgithub.com:torvalds/linux.git克隆完成后你会得到一个完整的本地仓库并自动配置好origin远程。克隆会默认把整个仓库的所有分支都下载下来但只会把main分支检出到工作区。若要切换到远程存在的其他分支例如devgit switch dev如果本地没有dev分支Git 会自动基于同名的远程分支创建追踪分支。五、实战完整的 Pull Request 协作流程假设你想为朋友的开源项目贡献代码但没有直接推送权限。GitHub 的 Fork Pull Request 机制就是为此而生。5.1 第一步Fork 仓库在朋友的 GitHub 仓库页面右上角点击Fork按钮。这会把你朋友的仓库完整复制一份到你自己的 GitHub 账户下。5.2 第二步克隆你自己的 Forkgit clone gitgithub.com:你的用户名/朋友的仓库.git cd 朋友的仓库5.3 第三步添加上游仓库为了保持和你朋友原始仓库的同步通常将朋友的仓库添加为一个远程命名为upstreamgit remote add upstream gitgithub.com:朋友的用户名/朋友的仓库.git5.4 第四步创建功能分支并开发git switch -c fix-typo echo 修正拼写错误 README.md git add README.md git commit -m 修正 README 中的拼写错误5.5 第五步推送到你 Fork 的远程仓库git push -u origin fix-typo5.6 第六步发起 Pull Request在 GitHub 上你的仓库页面通常会看到一个醒目的 “Compare pull request” 按钮。点击后仔细填写标题和描述说明你做了什么改动、为什么要这么做。点击 “Create pull request”。5.7 第七步Code Review 与合并项目维护者你朋友会收到通知审查你的代码。他可能提出修改意见。你在本地做出修改后再次pushPR 会自动更新。最终维护者点击 “Merge pull request”你的贡献就正式并入主项目了。六、保持 Fork 与上游同步在你开发期间朋友的原始仓库可能已经更新。定期同步上游是良好习惯# 获取上游仓库的最新状态 git fetch upstream # 切回 main 分支合并上游的 main git switch main git merge upstream/main # 将同步后的 main 推送到你自己的远程仓库 git push origin main如果你在自己的功能分支上需要上游的新代码也可以将upstream/main合并进来或用rebase保持整洁。七、日常协同中的常见问题7.1 推送被拒绝non-fast-forward当你push时提示! [rejected] main - main (non-fast-forward)说明你本地的main落后于远程。按下面步骤解决git pull --rebase origin main # 解决可能出现的冲突 git push origin main7.2 不小心在 main 分支上做了修改直接push时才发现不应该污染main。冷静只要还没推送到远程# 在 main 上将改动移到一个新分支 git switch -c new-feature # 再切回 main 重置到远程状态 git switch main git reset --hard origin/main这样你的修改安全地转移到了new-feature分支main又恢复干净。总结远程仓库是代码协作的基石origin是默认别名。git push上传git fetch下载而不合并git pullfetchmerge。git clone克隆整个仓库自动建立远程关联。Fork Pull Request 是 GitHub 开源协作的标准姿势Fork → Clone → Branch → Commit → Push → Open PR → Review → Merge。推送被拒时先拉取再推送保持分支整洁可以多用--rebase。如果这篇文章帮你解决了实操上的困惑别忘记点击点赞、分享也可以留言告诉我你遇到的其它问题我会尽快回复。动手练习是掌握编程最快的方法请务必亲手敲一遍本文的所有示例代码并截图保存你的成果。你的关注是我坚持原创和细节共享的力量来源谢谢大家。
