-
Fork 项目 (Fork the Repository):
- 在你使用的代码托管平台（如 GitHub、GitLab）上，找到你想要贡献的原始项目仓库。
- 点击 "Fork" 按钮。这会在你自己的账户下创建一个该项目的完整副本（你的 Fork 仓库）。
-
克隆你的 Fork (Clone Your Fork):
- 将你自己的 Fork 仓库克隆到你的本地电脑上。
- git clone <你的 Fork 仓库的 URL>
- cd <项目目录>
-
设置上游仓库 (Configure Upstream):
- 为了方便后续同步原始项目的更新，将原始项目仓库添加为一个名为 upstream 的远程仓库。
- git remote add upstream <原始项目仓库的 URL>
- 你可以用 git remote -v 来验证是否添加成功。
-
保持同步 (Sync Your Fork - Optional but Recommended):
- 在开始做修改前，最好先确保你的本地 main (或 master) 分支与 upstream 的最新状态保持一致。
- git checkout main (或 master)
- git fetch upstream
- git merge upstream/main (或 upstream/master)
- git push origin main (或 master，将更新推送到你自己的 Fork)
-
创建特性分支 (Create a Feature Branch):
- 非常重要： 不要在 main 或 master 分支上直接进行修改。为你的每个独立功能、修复或改进创建一个新的、描述性的分支。
- git checkout -b <你的新分支名称> (例如: git checkout -b fix-typo-in-readme, git checkout -b add-user-auth-feature)
-
进行修改和提交 (Make Changes and Commit):
- 在你的新分支上编写代码、修复 Bug、添加文档等。
- 进行充分的测试，确保你的修改没有引入新问题，并符合项目的编码规范。
- 频繁地提交你的更改，并编写清晰、有意义的提交信息 (Commit Message)。
- git add <修改的文件> 或 git add .
- git commit -m "清晰地描述本次提交做了什么"
-
推送分支到你的 Fork (Push Branch to Your Fork):
- 将你本地的特性分支推送到你自己的 Fork 仓库（通常名为 origin）。
- git push origin <你的新分支名称>
-
创建 Pull Request (Create the PR):
-
打开你 Fork 仓库的 GitHub/GitLab 页面，通常平台会自动检测到你推送了新分支，并提示你创建 Pull Request。
-
或者，访问原始项目的仓库页面，切换到 "Pull requests" 标签页，点击 "New pull request"。
-
选择分支： 确保"base repository"是原始项目及其目标分支（通常是 main 或 develop），"head repository"是你的 Fork 及其你刚刚推送的特性分支。
-
填写 PR 信息：
- 写一个清晰、简洁的标题。
- 在描述中详细说明你做了什么、为什么这样做。如果修复了某个 Issue，请使用关键词链接 Issue (如 "Fixes #123")。遵循项目的贡献指南 (CONTRIBUTING.md) 中可能存在的 PR 模板。
-
提交 PR： 点击 "Create pull request"。
-
-
代码审查与后续修改 (Code Review and Follow-up):
- 项目维护者或其他贡献者会对你的 PR 进行审查 (Code Review)。
- 积极响应： 关注 PR 下的评论，及时、礼貌地回应问题和建议。
- 进行修改： 如果需要修改，直接在你的本地特性分支上进行修改、提交，然后再次推送到同一个远程分支 (git push origin <你的新分支名称>)。你的 PR 会自动更新。
-
合并 (Merge):
- 一旦你的 PR 被批准，项目维护者会将其合并到主代码库中。恭喜你成功贡献！
-
清理 (Optional Cleanup):
- PR 合并后，你可以删除你本地和 Fork 仓库上的特性分支。
- git checkout main
- git pull upstream main (再次同步)
- git branch -d <你的新分支名称> (删除本地分支)
- 在 GitHub/GitLab 页面上删除你 Fork 仓库中的远程分支。
核心要点总结: Fork -> Clone (Your Fork) -> Branch -> Code & Commit -> Push (to Your Fork) -> Create PR (to Original Repo) -> Review & Update -> Merge。