【无标题】

开源项目 Git 贡献全流程拆解

准备工作

• 注册 GitHub/GitLab 账号，确保本地安装 Git 和开发环境（如 VS Code、IntelliJ 等）。
• 配置 Git 全局信息（用户名、邮箱），生成 SSH 密钥并添加到代码托管平台。

寻找合适的开源项目

• 通过 GitHub Explore 或热门社区（如 Apache、CNCF）筛选目标项目。
• 检查项目的 CONTRIBUTING.md 文档，了解贡献规范和代码风格要求。

Fork 项目到个人仓库

• 在项目主页点击 Fork 按钮创建个人副本。

• 克隆仓库到本地：

  git clone git@github.com:your-username/project.git  
  cd project  

创建开发分支

• 基于 main 或 master 分支创建新分支：

  git checkout -b feature/your-contribution  

修改代码并提交

• 在本地完成代码或文档修改，遵循项目的代码规范。

• 提交更改并添加描述：

  git add .  
  git commit -m "fix: resolve login page bug (close #123)"  

同步上游仓库变更

• 添加原始项目为远程仓库（命名为 upstream）：

  git remote add upstream git@github.com:original/project.git  

• 拉取最新代码并处理冲突：

  git fetch upstream  
  git rebase upstream/main  

推送代码到个人仓库

• 推送分支到远程：

  git push origin feature/your-contribution  

创建 Pull Request (PR)

• 在 GitHub 个人仓库页面点击 Compare & pull request。
• 填写 PR 标题和详细说明，关联相关 Issue（如 fixes #123）。

参与代码审查

• 根据维护者反馈修改代码，通过 git commit --amend 或新增提交更新 PR。
• 使用 git push -f 强制推送分支（适用于修改历史记录的情况）。

PR 合并与后续操作

• 维护者合并 PR 后，删除本地和远程分支：

  git branch -d feature/your-contribution  
  git push origin --delete feature/your-contribution  

• 定期同步个人 Fork 仓库与上游仓库，保持代码最新。

高级协作技巧

• 使用 git cherry-pick 移植特定提交到其他分支。
• 通过 git bisect 定位引入问题的提交。
• 参与项目讨论（Slack、邮件列表）以理解长期规划。