综合练习

这一课你将能做到

1. 独立完成一次完整的 Fork + PR 开源贡献流程
2. 把前 11 课学到的所有命令、流程、规范串联成一次真实交付
3. 在真实项目（本站 java-nav）上留下你的第一个 GitHub 贡献记录

为什么要学

前面 11 课都是「分解动作」，这一课是「连贯动作」。就像学开车：科目二练倒车入库，科目三练上路。真正的掌握，是在一个真实项目里从头到尾走通一次完整流程——从发现 Issue 到代码合并进主干。

完成本课练习后，你的 GitHub 主页会多一条绿色贡献记录，你的简历可以写「参与过开源项目贡献」。

先建立图像

完整任务流程图：

发现任务              搭建环境              开发交付
   │                    │                    │
   ▼                    ▼                    ▼
浏览 Issues   →   Fork + Clone   →   开分支写代码
   │                    │                    │
   │                    │                    ▼
   │                    │               本地测试通过
   │                    │                    │
   │                    │                    ▼
   │                    │               提交 + push
   │                    │                    │
   │                    │                    ▼
   │                    │              创建 PR
   │                    │                    │
   ▼                    ▼                    ▼
              审查 → 修改 → 合并 → 庆祝 🎉

跟着做

本次练习任务：为本站 java-nav 项目提交一个真实 PR（可以是修复 typo、补充文档、改进样式、或解决一个 good first issue）。

步骤 1：找到合适的任务

打开本站 GitHub 仓库的 Issues 页面，筛选 label:"good first issue" 的任务。如果没有，可以：

• 修复一个错别字（docs 标签）
• 补充某个课程的 README 说明
• 改进某段 CSS 样式

步骤 2：Fork 仓库

访问本站仓库页面，点击右上角 Fork。完成后你账号下会出现 你的用户名/java-nav。

步骤 3：Clone 到本地

git clone git@github.com:你的用户名/java-nav.git
cd java-nav
git remote add upstream git@github.com:官方org/java-nav.git
git remote -v
# origin    git@github.com:你的用户名/java-nav.git
# upstream  git@github.com:官方org/java-nav.git

步骤 4：同步上游最新代码

git fetch upstream
git switch main
git merge upstream/main
git push origin main

确保你的 main 和官方保持一致，避免后续冲突。

步骤 5：创建功能分支

根据任务类型选择分支前缀：

# 假设你选择了修复 #15 这个 Issue：课程 README 错别字
git switch -c docs/fix-readme-typo

步骤 6：本地开发

打开项目，按照仓库根目录的 README 指引启动本地服务（通常是 mvn spring-boot:run 或 ./mvnw spring-boot:run），确认改动生效。