GitHub/Git 常用命令及使用场景

以下是按使用场景整理的 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 同步,再从最新主分支开分支,是避免冲突成本最低的做法。

相关推荐
dong_junshuai29 分钟前
每天一个开源项目#160 LoopForge:把Agent交付拆成可退回的验收流程
github
Allen36682 小时前
给博客和秘书加上 HTTPS 之后的一点记录
github
laoyeye8313 小时前
手写 vLLM 分页 KV Cache(二):深入物理块分配、Block Table 与 Slot Mapping
github
Summer-Bright5 小时前
企业落地智能体,供应链签名还是空白:1862 个 MCP 服务器无认证裸奔
服务器·人工智能·github·mcp
一条Go5 小时前
Pod 终端与日志:为什么浏览器建连要先换一张 60 秒的票
后端·架构·github
一条Go5 小时前
开源新生代雷达 · 第 14 期
github
徐小夕8 小时前
万字拆解:零向量库、无模型微调,SAG2 凭什么刷新多跳问答 SOTA
前端·vue.js·github
黑土豆8 小时前
用 drawink 给业务页面加一层画板:从网页批注到无限板书
前端·javascript·github
慧都小项1 天前
MyEclipse Inline Diff 实用指南:逐处核对 AI 修改再提交
git·ai编程·myeclipse·java 代码审查·ai 代码修改