Git 基础操作手册#
本手册整理 Git 日常开发中最常用的基础操作,涵盖安装配置、仓库管理、分支操作、远程协作与常见问题处理。 适合作为日常开发速查表与新手入门指南。
一、Git 简介#
Git 是一个分布式版本控制系统,用于跟踪文件变更、多人协作开发。
1.1 Git 的三个区域#
工作区(Working Directory) → 你实际编辑的文件
↓ git add
暂存区(Staging Area / Index) → 准备提交的文件快照
↓ git commit
本地仓库(Repository) → 已提交的历史版本
↓ git push
远程仓库(Remote) → GitHub / Gitee / GitLab 等
1.2 文件状态#
| 状态 | 说明 |
|---|---|
untracked | 未跟踪(新文件,还没 add) |
modified | 已修改(工作区有改动) |
staged | 已暂存(准备提交) |
committed | 已提交(保存到本地仓库) |
1.3 常用命令速览#
git init 初始化仓库
git clone 克隆远程仓库
git add 添加文件到暂存区
git commit 提交到本地仓库
git status 查看状态
git log 查看提交历史
git push 推送到远程
git pull 拉取远程更新
git branch 分支管理
git checkout 切换分支/恢复文件
git merge 合并分支
git remote 远程仓库管理
二、安装与配置#
2.1 安装#
- Windows: 下载 Git for Windows 安装包,一路默认安装即可
- macOS:
brew install git或安装 Xcode Command Line Tools - Linux:
sudo apt install git(Ubuntu)或sudo yum install git(CentOS)
2.2 验证安装#
git --version
# git version 2.43.0
2.3 首次配置(必做)#
# 配置用户名和邮箱(提交记录会用到)
git config --global user.name "你的名字"
git config --global user.email "you@example.com"
# 查看当前配置
git config --global --list
# 配置默认编辑器(可选)
git config --global core.editor "code --wait"
# 配置换行符处理(Windows 推荐)
git config --global core.autocrlf true
# 查看所有配置(含来源)
git config --list --show-origin
2.4 常用配置项#
| 配置 | 作用 |
|---|---|
user.name / user.email | 提交者信息 |
core.editor | 默认编辑器 |
core.autocrlf | 换行符处理 |
alias.st status | 设置别名,git st 代替 git status |
init.defaultBranch main | 默认分支名设为 main |
查看配置:
git config --global --list
三、创建与克隆仓库#
3.1 初始化新仓库#
# 在当前目录初始化 Git 仓库
git init
# 指定目录初始化
git init my-project
初始化后会生成隐藏的 .git 目录,Git 通过它管理版本历史。
3.2 克隆远程仓库#
# 克隆仓库
git clone https://github.com/user/repo.git
# 克隆到指定目录
git clone https://github.com/user/repo.git my-dir
# 克隆指定分支
git clone -b dev https://github.com/user/repo.git
# 浅克隆(只拉最近一次提交,速度快)
git clone --depth 1 https://github.com/user/repo.git
3.3 查看远程地址#
git remote -v
# origin https://github.com/user/repo.git (fetch)
# origin https://github.com/user/repo.git (push)
四、基本工作流(增删改查)#
4.1 查看状态#
git status # 查看工作区和暂存区状态
git status -s # 精简输出
状态说明:
| 输出 | 含义 |
|---|---|
?? file | 未跟踪文件 |
M file | 已修改(工作区) |
M file | 已暂存(左列 M 表示暂存) |
A file | 新添加到暂存区 |
D file | 已删除 |
4.2 添加文件(git add)#
git add file.txt # 添加单个文件
git add . # 添加当前目录所有改动
git add *.java # 添加所有 .java 文件
git add -A # 添加所有改动(含删除和新增)
git add -u # 只添加已跟踪文件的改动
git add -p # 交互式选择要暂存的片段
4.3 提交(git commit)#
git commit -m "提交说明" # 提交暂存区内容
git commit -am "提交说明" # 添加已跟踪文件并提交(跳过 add)
git commit --amend -m "新的提交说明" # 修改最近一次提交
git commit --amend --no-edit # 只合并暂存区到上次提交,不改说明
提交规范建议:
| 类型 | 说明 |
|---|---|
feat: | 新功能 |
fix: | 修复 Bug |
docs: | 文档更新 |
style: | 格式调整(不影响代码逻辑) |
refactor: | 重构 |
test: | 测试相关 |
chore: | 构建/工具相关 |
git commit -m "feat: 新增用户登录功能"
git commit -m "fix: 修复订单查询空指针异常"
4.4 查看历史(git log)#
git log # 完整历史
git log --oneline # 精简一行显示
git log --oneline --graph --all # 图形化显示所有分支
git log -n 5 # 最近 5 条
git log --author="张三" # 按作者过滤
git log --since="2024-01-01" # 按时间过滤
git log -p file.txt # 查看文件每次改动
git log --stat # 显示改动的文件统计
git log -S "关键字" # 搜索提交内容
4.5 查看差异(git diff)#
git diff # 工作区 vs 暂存区
git diff --staged # 暂存区 vs 最近提交
git diff HEAD # 工作区 vs 最近提交
git diff <commit1> <commit2> # 两个提交之间
git diff branch1 branch2 # 两个分支之间
4.6 文件删除与移动#
git rm file.txt # 删除文件并暂存删除
git rm --cached file.txt # 从 Git 移除但保留本地文件
git mv old.txt new.txt # 移动/重命名文件
4.7 查看某行代码是谁改的(git blame)#
git blame file.txt
五、分支操作(重点)#
5.1 分支的基本操作#
git branch # 查看本地分支(* 表示当前分支)
git branch -a # 查看本地 + 远程分支
git branch -r # 查看远程分支
git branch dev # 创建分支
git checkout dev # 切换分支
git checkout -b dev # 创建并切换到 dev
git switch dev # 切换分支(新命令,更清晰)
git switch -c dev # 创建并切换(新命令)
git branch -d dev # 删除分支(已合并)
git branch -D dev # 强制删除(未合并)
git branch -m old new # 重命名分支
5.2 合并分支(git merge)#
# 1. 切换到目标分支(通常是 main)
git checkout main
# 2. 合并 dev 分支到 main
git merge dev
合并结果:
| 场景 | 结果 |
|---|---|
Fast-forward | dev 是 main 的直接后继,直接移动指针 |
Merge commit | 双方都有新提交,生成合并提交 |
Conflict | 冲突,需要手动解决 |
禁用快进的合并(保留分支历史):
git merge --no-ff dev
5.3 变基(git rebase)#
# 将当前分支变基到 main
git checkout dev
git rebase main
rebase vs merge:
| 对比项 | merge | rebase |
|---|---|---|
| 历史 | 保留分叉,生成合并提交 | 线性历史,更干净 |
| 冲突处理 | 一次解决 | 可能多次解决 |
| 适用 | 公共分支 | 私有分支整理 |
警告: 不要对已推送的公共分支做 rebase,会改写历史,影响他人。
5.4 解决冲突#
当合并或拉取出现冲突时:
git status # 查看冲突文件
冲突文件中会出现标记:
<<<<<<< HEAD
当前分支的代码
=======
要合并进来的代码
>>>>>>> dev
解决步骤:
- 打开冲突文件,手动编辑,保留正确内容
- 删除
<<<<<<<、=======、>>>>>>>标记 git add 冲突文件git commit完成合并(merge 场景)或git rebase --continue(rebase 场景)
# 放弃合并
git merge --abort
git rebase --abort
六、远程仓库协作#
6.1 远程仓库管理#
git remote -v # 查看远程仓库
git remote add origin https://xxx.git # 添加远程
git remote remove origin # 删除远程
git remote set-url origin https://新地址 # 修改地址
git remote rename old new # 重命名
6.2 推送(git push)#
git push # 推送到默认远程和分支
git push origin main # 推送到指定远程分支
git push -u origin main # 首次推送并建立跟踪关系
git push --force # 强制推送(慎用!)
git push --force-with-lease # 更安全的强制推送
git push origin --delete dev # 删除远程分支
6.3 拉取(git pull / fetch)#
git pull # 拉取并合并(= fetch + merge)
git pull --rebase # 拉取并变基(推荐,历史更干净)
git fetch # 只拉取,不合并
git fetch origin dev # 拉取指定分支
fetch vs pull:
| 命令 | 作用 |
|---|---|
git fetch | 只下载远程更新到本地,不修改工作区 |
git pull | fetch + merge(或 rebase),直接更新工作区 |
6.4 完整协作流程(推荐)#
# 1. 拉取最新代码
git checkout main
git pull --rebase
# 2. 创建功能分支
git checkout -b feature/login
# 3. 开发并提交
git add .
git commit -m "feat: 实现登录功能"
# 4. 推送到远程
git push -u origin feature/login
# 5. 在平台上发起 Pull Request / Merge Request
# 6. 审核通过后合并到 main
七、撤销与回退(重点)#
7.1 撤销工作区修改#
# 撤销某个文件的修改(未 add)
git checkout -- file.txt # 旧命令
git restore file.txt # 新命令(推荐)
# 撤销所有修改
git restore .
7.2 取消暂存(git reset)#
git reset HEAD file.txt # 旧命令:取消暂存,保留修改
git restore --staged file.txt # 新命令:取消暂存,保留修改
7.3 版本回退(git reset)#
| 命令 | 说明 |
|---|---|
git reset --soft <commit> | 回退提交,保留改动在暂存区 |
git reset --mixed <commit> | 回退提交,保留改动在工作区(默认) |
git reset --hard <commit> | 回退提交,丢弃所有改动(谨慎!) |
git reset --soft HEAD~1 # 撤消最近 1 次提交,改动保留在暂存区
git reset --mixed HEAD~2 # 撤消最近 2 次提交,改动保留在工作区
git reset --hard HEAD~1 # 撤消最近 1 次提交,丢弃改动
git reset --hard <commit_id> # 回退到指定提交,丢弃之后所有改动
7.4 撤销远程提交(git revert)#
revert 是"安全的撤销",生成一个新提交来抵消之前的提交,适合已推送到远程的情况:
git revert <commit_id> # 撤销指定提交(生成新提交)
git revert HEAD~1 # 撤销上一次提交
reset vs revert:
| 对比项 | reset | revert |
|---|---|---|
| 历史 | 改写历史 | 保留历史,新增撤销提交 |
| 已推送分支 | 危险(需强推) | 安全(推荐) |
| 适用 | 本地未推送 | 已推送远程 |
7.5 恢复误删的提交(git reflog)#
git reflog # 查看 HEAD 的操作历史
git reset --hard <commit_id> # 恢复到指定提交
reflog可以找回误删的提交,是"救命稻草"。
7.6 查看与恢复单个文件#
# 查看某文件在某个提交时的内容
git show <commit_id>:file.txt
# 恢复某个文件到指定提交的版本
git checkout <commit_id> -- file.txt
git restore --source <commit_id> file.txt
八、储藏(git stash)#
临时保存未提交的修改,切换到其他分支处理事情后再回来继续。
git stash # 储藏当前修改
git stash save "说明信息" # 储藏并加说明
git stash list # 查看储藏列表
git stash pop # 恢复最近储藏并删除记录
git stash apply # 恢复最近储藏(保留记录)
git stash apply stash@{1} # 恢复指定储藏
git stash drop # 删除最近储藏
git stash clear # 清空所有储藏
典型场景:
# 正在开发,突然要切换分支修 Bug
git stash
git checkout hotfix
# ... 修复完 ...
git checkout feature/login
git stash pop
九、标签(git tag)#
给重要提交(如发布版本)打标签。
git tag # 查看所有标签
git tag v1.0.0 # 创建轻量标签
git tag -a v1.0.0 -m "发布 1.0.0 版本" # 创建附注标签(推荐)
git show v1.0.0 # 查看标签信息
git push origin v1.0.0 # 推送标签到远程
git push origin --tags # 推送所有标签
git tag -d v1.0.0 # 删除本地标签
git push origin --delete v1.0.0 # 删除远程标签
十、忽略文件(.gitignore)#
在项目根目录创建 .gitignore,指定不需要纳入版本管理的文件。
10.1 常见忽略规则#
# 编译输出
target/
build/
*.class
*.jar
# IDE 配置
.idea/
*.iml
.vscode/
*.swp
# 日志与临时文件
logs/
*.log
*.tmp
# 环境配置(包含敏感信息)
.env
application-local.yml
# 系统文件
.DS_Store
Thumbs.db
# 依赖
node_modules/
10.2 规则说明#
| 写法 | 说明 |
|---|---|
*.log | 忽略所有 .log 文件 |
logs/ | 忽略 logs 目录及其内容 |
!important.log | 取消忽略(例外) |
/*.tmp | 只忽略根目录的 .tmp |
**/temp | 任意层级的 temp |
10.3 已跟踪文件无法被忽略#
.gitignore 只对未跟踪文件生效。如果文件已被跟踪,需要先移除:
git rm --cached file.txt
git commit -m "chore: 停止跟踪 file.txt"
十一、常用组合场景#
11.1 删除本地未推送的提交#
git reset --hard HEAD~1 # 删除最近 1 次提交及其改动
11.2 修改最新提交的说明#
git commit --amend -m "新的提交说明"
11.3 合并多个提交(交互式 rebase)#
git rebase -i HEAD~3 # 合并最近 3 个提交
在编辑器中把 pick 改为 squash(或 s),保存后合并提交。
11.4 查看某个文件的修改历史#
git log -p file.txt
git log --follow file.txt # 跟踪重命名
11.5 找回误删分支#
git reflog
git checkout -b recovered <commit_id>
11.6 只拉取远程某分支#
git fetch origin dev
git checkout -b dev origin/dev
11.7 取消本地未跟踪的改动#
git clean -n # 预览将被删除的文件
git clean -f # 删除未跟踪文件
git clean -fd # 删除未跟踪文件和目录
git clean -fdx # 连 .gitignore 忽略的也删除(慎用)
11.8 修改某次历史提交#
使用交互式 rebase:
git rebase -i HEAD~3
# 将目标提交的 pick 改为 edit,保存
git commit --amend
git rebase --continue
11.9 推送被拒绝(remote rejected)#
原因:远程有本地没有的提交。
git pull --rebase # 先拉取变基
git push
11.10 切换分支时保留未提交修改#
git stash
git checkout 其他分支
git stash pop
11.11 查看两个分支的差异#
git diff branch1..branch2 # 差异内容
git log branch1..branch2 # branch2 有而 branch1 没有的提交
11.12 合并冲突后放弃操作#
git merge --abort # 放弃合并
git rebase --abort # 放弃变基
git cherry-pick --abort # 放弃 cherry-pick
十二、Git 高级命令(了解)#
12.1 挑选单个提交(cherry-pick)#
git cherry-pick <commit_id> # 把某个提交应用到当前分支
12.2 查找引入 Bug 的提交(bisect)#
git bisect start
git bisect bad # 当前版本有 Bug
git bisect good <commit_id> # 已知正常的旧版本
# Git 自动二分查找,逐个标记 good/bad
git bisect reset # 结束
12.3 工作区与暂存区标准流程#
git status
git diff # 查看工作区改动
git add file.txt
git diff --staged # 查看暂存区改动
git commit -m "说明"
git push
十三、常见问题 FAQ#
13.1 git pull 报错 "refusing to merge unrelated histories"#
git pull origin main --allow-unrelated-histories
13.2 提交了敏感信息(密码、密钥)怎么办?#
- 立即修改该密码/密钥
- 若已推送,需用
git filter-repo等工具清理历史,或联系平台彻底删除 - 用
.gitignore防止再次提交
13.3 如何撤销 git add 但保留修改?#
git restore --staged file.txt
13.4 如何撤销 git commit 但保留修改?#
git reset --soft HEAD~1 # 保留改动在暂存区
git reset --mixed HEAD~1 # 保留改动在工作区
13.5 误执行 git reset --hard 后还能恢复吗?#
能,用 reflog 找回:
git reflog
git reset --hard <commit_id>
13.6 如何查看远程分支的最新状态?#
git fetch --all
git branch -a
git log origin/main --oneline -5
13.7 克隆时速度慢怎么办?#
- 使用浅克隆:
git clone --depth 1 - 用国内镜像(如 Gitee 镜像)
- 配置代理
git config --global http.proxy http://127.0.0.1:7890
git config --global --unset http.proxy
十四、Git 工作流小结#
14.1 日常开发的标准流程#
# 1. 更新主干
git checkout main
git pull --rebase
# 2. 创建功能分支
git checkout -b feature/xxx
# 3. 开发 + 提交
git add .
git commit -m "feat: xxx"
# 4. 同步主干(开发中途)
git fetch origin
git rebase origin/main
# 5. 推送
git push -u origin feature/xxx
# 6. 发起 PR/MR → 审核 → 合并
14.2 命令分类速查表#
| 场景 | 命令 |
|---|---|
| 初始化 | git init / git clone <url> |
| 查看状态 | git status |
| 添加暂存 | git add . |
| 提交 | git commit -m "msg" |
| 查看历史 | git log --oneline |
| 查看差异 | git diff |
| 分支操作 | git branch / git checkout / git switch |
| 合并 | git merge / git rebase |
| 远程 | git remote -v / git push / git pull |
| 撤销 | git restore / git reset / git revert |
| 储藏 | git stash / git stash pop |
| 标签 | git tag / git push --tags |
学习建议: 先用
git status和git log熟悉仓库状态,再练习分支与合并;reset --hard和push --force属于危险操作,操作前务必确认。理解三个区域(工作区/暂存区/本地仓库)是掌握 Git 的关键。