文章目录
前言`
想给别人的开源项目贡献代码?最简单常用的办法就是 Fork + Pull Request(PR)。流程很直白:先把项目 Fork 到自己账号,克隆到本地,在一个新的功能分支上改代码、测试,确认没问题后提交并推到远程,最后发起 PR 请原项目维护者合并。下面的步骤会一步步教你怎么做,适合刚入门的同学快速上手。
一、Fork 仓库
步骤:
访问目标仓库主页—》点击右上角的 Fork 按钮(需要登录 GitHub)—》选择将仓库 Fork 到你的个人账号


结果:
你的账号下会创建一个副本仓库:

删除
如果想删除Fork的仓库,访问自己账号下该仓库主页—》点击Setting—》拉到最下面的Danger Zone,单击Delete this repository即可删除该仓库。

二、克隆 Fork 后的仓库到本地
命令:
# 克隆你的Fork仓库
git clone https://github.com/your-forker-username/simple-website.git
cd simple-website
验证:
# 查看远程仓库配置
git remote -v
# 输出:
# origin https://github.com/your-forker-username/simple-website.git (fetch)
# origin https://github.com/your-forker-username/simple-website.git (push)
详细方法可见:Git客户端的安装与使用【超详细】
三、创建功能分支
例如:修改网站的页脚版权年份
命令:
# 基于main分支创建新分支
git checkout -b update-footer-year main
四、修改代码并提交
修改文件:index.html
提交代码:
git add index.html
git commit -m "docs: update copyright year to 2024"
五、推送分支到远程仓库
命令:
git push -u origin update-footer-year
结果:
你的 Fork 仓库会新增一个分支:update-footer-year
六、创建 Pull Request (PR)
步骤:
- 访问你的 Fork 仓库主页:https://github.com/your-forker-username/simple-website
- 点击 Pull requests 标签
- 点击 New pull request
- 选择 Compare across forks
- 左侧选择 base repository 为原仓库的 main 分支
- 右侧选择你的分支 update-footer-year
- 点击 Create pull request
- 填写标题和描述(例如:Update copyright year to 2024)
- 点击 Create pull request
七、等待维护者合并
维护者操作:
- 审查代码变更
- 测试修改后的网站
- 批准并合并 PR
结果:
- 原仓库的 main 分支会包含你的修改
- 你的 Fork 仓库的 update-footer-year 分支会被自动关闭
八、同步Fork原仓库
命令:
# 添加原仓库为上游
git remote add upstream https://github.com/your-username/simple-website.git
# 拉取最新代码
git fetch upstream
git checkout main
git merge upstream/main
git push origin main
九、常见问题与解决方法
PR 被拒绝:
原因:代码不符合规范、存在冲突
解决:根据反馈修改代码,重新提交
Fork 仓库超时:
执行 git fetch upstream 和 git merge upstream/main时超时
权限不足:确保你有 Fork 权限(公开仓库默认允许 Fork)
总结
先 Fork 并克隆到本地,在新的功能分支上改并本地测试,写清楚提交信息,推到远端后发起有说明的 PR,按维护者的建议改进并等待合并。合并后别忘了把自己的 Fork 同步上游,避免以后出现冲突。按这个顺序做,就可以向任何GitHub 开源项目贡献代码。
2万+

被折叠的 条评论
为什么被折叠?



