2.3 GitHub 协作:Issue 与 Pull Request
Git 是版本控制工具,GitHub 是围绕 Git 仓库提供协作界面的在线平台。你可以把 GitHub 理解成:远程仓库 + 讨论区 + 代码评审 + 项目管理。
Issue:先说清楚要解决什么
Issue 通常用来记录一个任务、bug、想法或讨论。例如:
text
标题:登录页按钮在手机端换行
现象:
- iPhone 宽度下,Google 登录按钮文字被挤到两行。
期望:
- 按钮高度稳定,文字不溢出。
可能位置:
- frontend/app/[locale]/account/page.tsx好的 Issue 不只是说“有 bug”,而是说明现象、期望和可能范围。
Pull Request:请求把分支合入主线
Pull Request(通常简称 PR)是“请检查并合并我的分支”的请求。一个常见流程是:
bash
git switch -c fix/mobile-login-button
# 修改代码
git add .
git commit -m "Fix mobile login button layout"
git push -u origin fix/mobile-login-button然后在 GitHub 上创建 PR,把 fix/mobile-login-button 合并到 main。
正在加载交互实验...
Review:代码评审
PR 页面里,队友可以:
- 查看改了哪些文件。
- 在具体行留下评论。
- 请求修改(Request changes)。
- 批准合并(Approve)。
代码评审不是挑刺,而是在合并前发现问题、共享上下文、保持主线质量。
Merge:合并 PR
PR 通过后,可以合并到 main。常见合并方式包括:
- Merge commit:保留分支合并痕迹。
- Squash merge:把 PR 中多个提交压成一个提交。
- Rebase merge:把提交整理到 main 之后,历史更线性。
注意
不同团队对 PR 粒度、提交信息、合并方式有不同规范。学习阶段先理解流程本身,再适应具体团队规则。
正在加载概念检查...
正在加载本节练习...