Git常用指令 - 技术栈

Git 常用50个核心操作命令（附详细说明）

以下按仓库初始化与配置、文件状态与暂存、提交与日志、分支管理、远程仓库、合并与变基、标签、撤销与回滚、LFS大文件、高级实用十大场景分类，覆盖开发全流程高频操作，命令简洁且标注适用场景，新手也能直接套用。

一、仓库初始化与全局配置（5个）

主要用于首次使用Git的环境配置、本地仓库创建，配置后全局生效（除非单独修改仓库配置）。

git config --global user.name "你的用户名"
配置Git全局提交用户名（GitHub/GitLab的用户名，必填）。
git config --global user.email "你的邮箱"
配置Git全局提交邮箱（与GitHub/GitLab绑定的邮箱，必填）。
git config --global --list
查看Git所有全局配置信息，验证用户名、邮箱是否配置正确。
git init
在当前文件夹初始化本地Git仓库，生成隐藏的.git目录（仓库核心文件）。
git clone <仓库地址>
克隆远程GitHub/GitLab仓库到本地，包含所有文件、分支和提交历史（支持HTTPS/SSH地址）。

二、文件状态查看与暂存（7个）

Git核心工作流（工作区→暂存区→本地仓库）的关键操作，高频使用于开发中文件管理。

git status

查看工作区文件状态：未跟踪（新文件）、已修改、已暂存、干净（无修改），带颜色标注更清晰。

git add <文件/文件夹路径>

将指定文件/文件夹从工作区提交到暂存区 ，是提交前的必要步骤（例：git add index.html、git add src/）。

git add .

快捷命令：将工作区所有未跟踪+已修改 的文件一次性提交到暂存区（最常用，开发中高频）。

git add -u

将工作区已跟踪（曾提交过） 的修改文件提交到暂存区，忽略新创建的未跟踪文件。

git reset HEAD <文件路径>

将指定文件从暂存区回滚到工作区 ，取消暂存（例：误add文件时使用，保留文件修改）。

git reset HEAD .

一次性将暂存区所有文件 回滚到工作区，取消全部暂存操作。

git clean -f

删除工作区未跟踪的新文件（无法恢复，慎用），仅删除Git未记录的文件，保留已跟踪的修改文件。

三、提交与提交日志（8个）

将暂存区文件提交到本地仓库，及查看/筛选提交历史，是版本追溯的核心操作。

git commit -m "提交备注信息"

将暂存区所有文件提交到本地Git仓库 ，-m后必须跟清晰的备注（例：git commit -m "feat: 新增登录功能"）。

git commit -am "提交备注信息"

快捷命令：跳过暂存区，直接将已跟踪的修改文件 提交到本地仓库（新文件需先git add，无法直接用）。

git commit --amend

修正最后一次提交 ：若漏加文件/备注写错，执行后进入编辑模式，修改备注或补充暂存文件后保存，覆盖最后一次提交记录（未推送到远程时使用）。

git log

查看本地仓库完整提交历史：包含提交ID、作者、时间、提交备注，按时间倒序排列。

git log --oneline

简洁版提交日志：仅显示7位短提交ID+提交备注 ，屏幕占比小，最常用的日志查看方式。

git log --graph

图形化显示提交历史，清晰展示分支合并、分叉的关系（多分支开发时必备）。

git log --author="用户名/邮箱"

筛选指定作者的提交记录，快速查找某个人的开发记录（例：git log --author="zhangsan@163.com"）。

git log --since="2026-02-01"

筛选指定时间后的提交记录，也可写相对时间（例：git log --since="3 days ago" 查看3天内的提交）。

四、分支管理（10个）

Git最核心的功能，多分支开发（主分支、开发分支、功能分支、修复分支）的必备操作，覆盖分支创建、切换、删除、查看全流程。

git branch

查看本地所有分支，当前所在分支前带*标记。

git branch -a

查看本地+远程 所有分支，远程分支以remotes/origin/开头。

git branch <分支名>

创建新分支（基于当前所在分支的最新提交，仅本地创建，未切换）。

git checkout <分支名>

切换到指定本地分支，切换前需保证工作区无未提交的修改（避免冲突）。

git checkout -b <分支名>

快捷命令：创建新分支并立即切换 到该分支（开发中最常用，例：git checkout -b feat/pay）。

git checkout -b <本地分支名> origin/<远程分支名>

从远程分支拉取并创建本地对应分支（例：拉取远程dev分支：git checkout -b dev origin/dev）。

git branch -m <旧分支名> <新分支名>

重命名本地分支（例：git branch -m feat/pay feat/wechat-pay）。

git branch -d <分支名>

删除本地已合并的分支（安全删除，未合并则提示失败）。

git branch -D <分支名>

强制删除本地分支（无论是否合并，慎用，例：删除废弃的功能分支）。

git push origin --delete <远程分支名>

删除远程仓库的分支（例：git push origin --delete feat/pay，删除后团队成员需拉取最新远程信息）。

五、远程仓库操作（6个）

本地仓库与远程仓库（GitHub/GitLab/Gitee）的关联、同步操作，开发中每次推送/拉取前必用。

git remote add origin <远程仓库地址>

将本地仓库关联到远程仓库，origin是远程仓库的默认别名（仅首次使用）。

git remote -v

查看本地已关联的远程仓库信息，显示fetch（拉取）和push（推送）的地址，验证是否关联正确。

git remote rename <旧别名> <新别名>

修改远程仓库的别名（例：git remote rename origin github）。

git remote remove <别名>

解除本地与指定远程仓库的关联（例：git remote remove origin）。

git fetch origin

从远程仓库拉取所有分支的最新提交记录 （仅同步历史，不合并到本地当前分支，安全无冲突）。

git pull origin <分支名>

快捷命令：git fetch + git merge，从远程指定分支拉取最新代码并合并到本地当前分支（例：git pull origin main，开发中同步远程代码最常用）。

六、合并与变基（4个）

多分支开发完成后，将功能分支代码合并到主分支/开发分支的核心操作，两种方式适用于不同场景。

git merge <分支名>

将指定分支的代码合并到当前所在分支 （例：在main分支执行git merge feat/pay，将支付功能合并到主分支），会生成一个新的合并提交记录。

git merge --no-ff <分支名>

禁用快速合并（no fast forward），无论分支是否线性，都强制生成合并提交记录，保留分支合并历史（团队开发推荐，便于追溯）。

git rebase <分支名>

变基操作：将当前分支的所有提交，移植到指定分支的最新提交之后 （例：在feat/pay分支执行git rebase main，将支付分支基于主分支最新代码重新构建），使提交历史更线性、整洁。

git rebase --abort

变基过程中出现冲突时，放弃变基，恢复到变基前的状态（冲突无法解决时使用）。

七、标签管理（3个）

用于标记项目的版本节点 （如v1.0.0、v2.1.1），便于版本发布和回滚，标签是提交记录的快照，不可修改。

git tag <标签名>

为当前最新提交创建轻量标签 （仅包含标签名，无备注，例：git tag v1.0.0）。

git tag -a <标签名> -m "标签备注"

创建带注释的标签 （推荐，包含作者、时间、备注，例：git tag -a v1.0.0 -m "v1.0.0 正式版：实现核心功能"）。

git push origin <标签名>

将本地标签推送到远程仓库（标签默认不随git push推送，需手动执行，例：git push origin v1.0.0）；推送所有标签：git push origin --tags。

八、撤销与回滚（5个）

开发中误操作（误提交、误修改、误删除）的补救操作，覆盖工作区、暂存区、本地仓库三个层级，按需选择。

git checkout -- <文件路径>

放弃工作区对指定文件的所有修改 ，恢复到最近一次提交/暂存的状态（无法恢复，慎用，例：git checkout -- index.html）。

git reset --hard <提交ID>

强制将本地仓库、暂存区、工作区全部回滚 到指定提交ID的状态（所有后续提交记录被覆盖，未推送到远程时使用，慎用）。

git reset --soft <提交ID>

轻量回滚：仅将本地仓库回滚到指定提交ID，暂存区和工作区的修改保留 （适用于回滚后需重新提交的场景）。

git restore <文件路径>

Git 2.23+新增命令，替代git checkout --，放弃工作区指定文件的修改（更语义化，例：git restore src/App.vue）。

git restore --staged <文件路径>

Git 2.23+新增命令，替代git reset HEAD，将指定文件从暂存区回滚到工作区（取消暂存，例：git restore --staged package.json）。

九、LFS大文件管理（2个）

针对GitHub单文件25MB限制的解决方案，配套之前的大文件上传教程，高频使用。

git lfs track <文件/后缀>

用Git LFS追踪大文件（例：git lfs track "*.zip"、git lfs track "data/dataset.csv"），自动生成.gitattributes文件。

git lfs ls-files

查看当前仓库中被Git LFS追踪的所有大文件，验证是否追踪成功。

额外高频实用命令（补充，超50个福利）

git push：将本地仓库提交推送到远程关联分支（已用git push -u origin main关联后，直接使用）。
git push -u origin <分支名>：首次推送本地分支到远程，并建立本地与远程分支的关联（后续直接git push）。
git gc：清理Git仓库的无用缓存、过期对象，优化仓库体积（仓库过大时执行）。
git diff：查看工作区与暂存区之间的文件修改差异（显示具体修改的代码行）。
git diff <提交ID1> <提交ID2>：查看两个提交之间的代码修改差异，便于代码审查。

核心使用原则

多分支开发规范：主分支（main/master）仅用于发布，开发在dev分支，新功能/修复单独建分支（feat/xxx、fix/xxx）；
提交前必看：git status确认文件状态，避免误提交无关文件；
同步远程前必做：git pull拉取最新代码，避免推送时冲突；
危险操作慎用：git reset --hard、git branch -D、git clean -f，执行前确认工作区已备份重要修改。