开源项目贡献指南：从 Issue 到 Pull Request

FreeGuideOnline 最新 2026-07-01

Summary

Fix header layout breaks on mobile viewports.

Fixes #123

Details

  • Removed fixed width on nav container
  • Applied flex-wrap to header elements

Testing

  1. Open browser dev tools and toggle device toolbar
  2. Select iPhone 12 Pro viewport
  3. Header should now wrap correctly without overflow

Screenshots

（插入前后对比图）


## 第五步：协作与审查

提交 PR 只是中途站，持续的沟通才是贡献的真正核心。

### 积极对待审查意见
项目维护者或其他贡献者可能会提出修改建议。请以开放的心态看待：
-   所有评论都针对代码，而非个人。
-   如果不同意某项建议，可礼貌地阐述理由，展开建设性技术讨论。
-   保持响应速度，每次提交修改后，PR 会自动更新。

### 利用自动化反馈
许多项目会配置 CI 管道。如果你的 PR 触发了测试失败或代码风格检查报错，仔细查看日志，在本地复现并修复后重新推送。

### 优雅地处理冲突
当审查期间上游仓库发生了你 PR 中同样区域的修改时，Git 会提示合并冲突。在本地执行：
```bash
git checkout fix/issue-123-description
git pull upstream main
# 手动解决冲突文件
git add 冲突文件
git commit -m "Resolve merge conflicts"
git push origin fix/issue-123-description

解决冲突后记得再次运行完整测试。

第六步：成功合并与后续

一旦审查通过，维护者会批准并合并你的 PR。恭喜，你已正式成为一名开源贡献者！

清理本地分支

合并完成后，可以安全删除工作分支：

git checkout main
git pull upstream main  # 将上游合并结果同步到本地 main
git branch -d fix/issue-123-description
git push origin --delete fix/issue-123-description  # 可选，删除远程分支