以下是按使用场景整理的 GitHub/Git 常用命令,重点标注每条命令在什么情况下用、解决什么问题。
🚀 日常开发:从修改到推送
这是每天都在重复的循环:改代码 → 暂存 → 提交 → 推送到 GitHub。
| 命令 | 典型场景 |
|---|---|
git status |
改完代码先看一眼:哪些文件被修改、哪些已暂存、当前在哪个分支 |
git add <文件> / git add . |
把修改放入暂存区,准备形成一次提交;. 表示全部 |
git commit -m "说明" |
将暂存区内容保存为一个版本快照 |
git commit --amend |
刚提交完发现漏了文件或提交信息写错,用 amend 修补上一次提交,不新增记录 |
git push |
把本地提交上传到 GitHub |
git push -u origin <分支> |
首次推送某条新分支 时,用 -u 关联本地与远程分支,之后直接 git push 即可 |
如果提交后才发现问题,且尚未 push ,优先用
git commit --amend或git reset在本地修正;一旦已 push,就要改用不影响他人历史的git revert。
🌿 分支管理:隔离开发与合并
新功能、修 bug 都不应直接在主分支上改,需要开独立分支。
| 命令 | 场景 |
|---|---|
git branch |
查看本地分支,* 标记当前所在分支 |
git branch -a |
查看所有分支,包括远程分支 |
git switch -c <新分支> 或 git checkout -b <新分支> |
开始新功能/修 bug:创建并立即切换到新分支,最常用 |
git switch <分支> / git checkout <分支> |
在已有分支之间切换 |
git merge <分支> |
把功能分支合并回当前分支(通常在 PR 通过后,或在本地提前合并测试) |
git branch -d <分支> |
合并完成后删除本地功能分支,保持分支列表整洁 |
git push origin --delete <分支> |
删除远程已合并的分支 |
现代 Git 推荐用
git switch代替git checkout做分支切换,语义更清晰;但checkout -b仍然广泛使用,两者并存。
🤝 协作与 PR:Fork → 分支 → 推送 → 拉取请求
向没有写权限的仓库贡献代码,或参与团队 PR 流程时,命令链条如下。
核心流程:Fork → Clone → 新建分支 → 提交 → Push → 打开 PR
text
# 1. 在 GitHub 上 Fork 目标仓库,然后克隆自己的 fork
git clone https://github.com/<你的用户名>/<仓库名>.git
# 2. 新建功能分支
git switch -c feature/xxx
# 3. 修改代码后
git add .
git commit -m "描述改动"
# 4. 推送到自己的 fork
git push -u origin feature/xxx
推送后,到 GitHub 页面创建 Pull Request,选择 base 仓库的 main 分支和你的 compare 分支,填写标题和说明即可。
如果 PR 审查中需要继续修改,在同一分支上再次 commit + push,PR 会自动更新,不需要重新建 PR。
保持 fork 与上游同步(当原仓库有了新提交时):
text
git remote add upstream https://github.com/原仓库/原仓库.git # 仅首次
git fetch upstream
git switch main
git merge upstream/main # 或 git rebase upstream/main
git push origin main
upstream 指向原仓库,origin 指向你自己的 fork;不设置 upstream 时,你的 fork 会逐渐落后于原仓库。
⏪ 撤销与回退:按"是否已 push"来选命令
这是最容易用错的区域。核心分界线:改动是否已经推送到远程、是否可能被他人拉取。
| 场景 | 命令 | 说明 |
|---|---|---|
| 工作区改了,还没 add,想放弃 | git checkout -- <文件> 或 git restore <文件> |
丢弃工作区的修改,恢复到上次提交的状态 |
已 add 暂存,还没 commit,想撤出暂存区 |
git reset <文件> |
取消暂存,修改保留在工作区 |
| 已 commit,尚未 push,想回退版本 | git reset --hard <commit> |
彻底回退到指定提交,工作区和暂存区都重置;仅在本地、未推送时使用 |
| 已 commit,尚未 push,但想保留修改内容 | git reset --soft HEAD~1 |
撤销上一次提交,修改仍留在暂存区,方便重新组织提交 |
| 已经 push,想撤销某次提交 | git revert <commit> |
生成一个反向提交来抵消原提交,不改写历史,对协作者安全 |
reset 后后悔了,想找回 |
git reflog + git reset --hard <sha> |
reflog 记录了 HEAD 的移动历史,可以找回"丢失"的提交 |
merge 冲突的专门场景:
- 合并时冲突,还没 commit,想放弃这次 merge →
git merge --abort,回到合并前最干净的状态。 - merge 已经生成合并提交,且已 push ,想撤销 →
git revert -m 1 <merge-commit>,不要用reset --hard后强推,否则会破坏他人已拉取的历史。
🔄 远程同步:fetch 与 pull 的区别
| 命令 | 场景 |
|---|---|
git fetch |
只想看看远程有哪些新提交,但不想立即合并时使用;下载后不影响你的工作区和当前分支 |
git pull |
日常开工前同步最新代码:相当于 fetch + merge,把远程更新拉下来并合并到当前分支 |
git pull --rebase |
希望提交历史保持线性、避免无意义的合并提交时使用;把你的本地提交"重放"到远程更新之后 |
git remote -v |
查看当前仓库关联了哪些远程地址(origin / upstream) |
每天开工前先
git pull(或git pull --rebase),可以避免在旧代码上开发半天后才发现大量冲突。
📦 临时暂存:写到一半需要切分支
场景:功能写了一半,突然需要紧急修复另一个 bug,但当前改动还不适合提交。
text
git stash # 收起当前未提交的改动,工作区变干净
git switch hotfix # 去修 bug
# 修完、提交、切回原分支后
git stash pop # 恢复刚才收起的改动,并删除 stash 记录
git stash 适合"临时保存现场";git stash list 可以查看暂存了多条记录,git stash apply stash@{n} 可以恢复指定的某一条。
🖥️ GitHub CLI:在终端里完成 GitHub 操作
如果你安装了 gh,很多原本需要打开网页的操作可以直接在命令行完成:
| 命令 | 场景 |
|---|---|
gh repo clone <owner/repo> |
克隆仓库,无需拼接完整 URL |
gh repo fork <owner/repo> --clone |
一步完成 fork + 克隆到本地,适合给开源项目贡献代码 |
gh pr create |
在终端创建 PR;gh pr create --draft 创建草稿 PR |
gh pr checkout <PR号> |
在本地检出别人的 PR 分支,方便审查和测试 |
gh issue list / gh issue create |
管理 Issue |
GitHub CLI 并非必须,但如果你习惯终端工作流,它能显著减少"写完代码还要切浏览器"的上下文切换。
最后两条实用原则 :
① 任何已推送、他人可能已经拉取 的历史,用 revert 加新提交来撤销,不要 reset --hard 后强推;
② 开始任何新功能前,先 git pull 同步,再从最新主分支开分支,是避免冲突成本最低的做法。