从零到 PR 合并GitCode 工作流与开源贡献全流程指南【免费下载链接】community本项目是CANN开源社区的核心管理仓库包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息项目地址: https://gitcode.com/cann/community第一次给 CANN 社区提代码这篇 GitCode 工作流指南把开源贡献的完整链路走了一遍环境配置、Fork 克隆、本地同步、提交推送、创建 PR、门禁评审再到冲突自救。照着做你的第一个 PR 就能顺畅走完全部流程。装好 Git再把 GitCode 账户信息配正确动手前只需要两样东西一台装好 Git 的电脑一个配好信息的 GitCode 账户。工具用法不熟的话搜一套基础教程就能快速上手想看看社区里都有什么项目可以逛一下 CANN 组织主页。账户信息直接决定你的提交署名顺手把用户名和邮箱填上git config --global user.name your_GitCode_Name git config --global user.email your_GitCode_email邮箱强烈建议和 CLA 签署时用的一致。两边对不上提交可能无法和贡献协议关联后面的流程会白白卡一下。配置 SSH 公钥告别每次输密码每次推送都要敲密码很折磨人用密钥对代替密码就舒服了。本地生成一对密钥把公钥内容复制出来ssh-keygen -t rsa -C your_GitCode_email cat ~/.ssh/id_rsa.pub然后在 GitCode 的个人设置 → 安全设置 → SSH 公钥里把公钥粘进去保存。最后验证一下链路是否通了ssh -T gitgitcode.com看到Welcome to GitCode, $user_name的欢迎语说明配置生效之后推拉代码全程免密。Fork 并克隆到本地工作目录GitCode Fork 克隆分三步。先在官方项目页点右上角的 Fork 按钮创建一份挂在自己名下的副本——以后你的改动都先落在这份副本上不碰官方主干。接着建一个干净的工作目录把 Fork 拉到本地并登记上游仓库mkdir -p ~/code cd ~/code git clone https://gitcode.com/${your_name}/${repo_name}.git cd ${repo_name} git remote add upstream https://link.gitcode.com/i/133f9aff4ef50dd9f3c3d725d3d98fee/${repo_name}.gitupstream指向官方源仓库是后续同步主干进度的参照物缺了它你的本地副本就只和自己的 Fork 打交道了。最后开一条自己的开发分支之后所有修改都发生在它上面git checkout -b myfeature别直接在 master 上写代码留一条干净的分支线后面同步、回退都省心。日常开发fetch rebase别用 pull开发期间官方主干一直在动建议养成习惯每次开始干活前先把主线同步下来再把自己的分支垫到最新 master 之上git fetch upstream git rebase upstream/master很多老手会刻意避开git pull原因是它把拉取和合并捆在一起执行容易顺手生成一堆合并提交把提交历史搅成毛线团fetch 加 rebase 的组合则保持线性、干净的历史。嫌麻烦的话可以提前设一次默认行为git config branch.autoSetupRebase always这样以后凡是 rebase 场景Git 都会自动帮你选对。提交变更推送分支到 Fork改动完成后把它们纳入版本控制git add . git commit -m 一句话说明改了什么、为什么改提交信息是留给审查者的第一份设计文档写清楚动机比罗列文件更有用。刚提交完就想微调上一条补个说明、补个漏改的文件git commit --amend直接改在上一条提交上不用新开一条噪音提交。分支准备好后推到你 Fork 仓库里对应的远端分支PR 才有东西可展示git push -f origin myfeature这里的-f是把远端分支强制覆盖成本地历史只作用于你自己 Fork 里的分支完全安全。千万不要把强推指向官方主干分支——那会用本地历史直接替换远端后果很难收拾。创建 PRGitCode 提交 PR 的正确姿势打开 Fork 仓库的 Pull Requests 页面点新建 Pull Request源分支选myfeature目标分支选官方仓库的 master填好标题和说明即可。PR 是一次正式的合入官方主线请求别急着点提交。发之前自己过一遍改动范围调试代码、无关文件、误提交的产物一样都不要带进去。触发 GitCode 门禁等机器人跑完检查PR 建好后在评论区输入/compileCI 就会被拉起来。机器人会依次跑代码检查、SCA 扫描、反病毒、多平台编译、单元测试等任务不同仓库的耗时不太一样耐心等就行。任何一项 FAILED点进日志定位问题、修完再推一版新提交PR 会自动重跑门禁不用手动重新触发。门禁全绿之后PR 会被分给一位或多位审查者。评审意见都集中在 PR 页面逐条回应、改完推送即可沟通留痕本身就是贡献的一部分。踩坑自救冲突、回退与压缩提交rebase 冲突PR 页面上出现冲突标记说明你的分支和主干改了同一块代码。按这个顺序处理就能解开git checkout master git fetch upstream git rebase upstream/master git checkout myfeature git rebase master此时 Git 会停在冲突文件上手动编辑保留正确内容然后继续git add . git rebase --continue git push -f origin myfeature最后这条强推只更新你自己的 PR 分支属于正常操作放心执行。回退提交某个已合入主干的提交出了问题用 revert 生成一条反向提交来安全撤销它不删除历史审计链路完整git checkout -b myrevert git fetch upstream git rebase upstream/master git revert -m 1 SHA # SHA 是合并提交普通提交去掉 -m 1 直接 revert git push origin myrevert再拿myrevert发一个 PR 即可。压缩提交几条零碎提交想压成一条干净的交互式变基来办git rebase -i HEAD~n # n 是要整理的提交数量编辑界面里把要并入的提交从pick改成s至少保留一个pickESC后输入:wq保存再按提示编辑合并后的提交信息保存退出。最后git push -f origin myfeature强推PR 里的提交历史立刻清爽。走到这里整条 GitCode 贡献链路就闭环了Fork 克隆 → 本地开发与同步 → 提交推送 → 创建 PR → 门禁评审。哪一步卡住了回到对应小节对照命令排查基本都能自己解开。【免费下载链接】community本项目是CANN开源社区的核心管理仓库包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息项目地址: https://gitcode.com/cann/community创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考