返回学习记录

Learning archive

Git 基础操作手册

覆盖 Git 基础配置、仓库管理、分支操作、远程协作与常见问题处理的实用操作手册。

2026年5月1日
  • Git
  • 版本控制
  • 操作手册

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-forwarddev 是 main 的直接后继,直接移动指针
Merge commit双方都有新提交,生成合并提交
Conflict冲突,需要手动解决

禁用快进的合并(保留分支历史):

git merge --no-ff dev

5.3 变基(git rebase)#

# 将当前分支变基到 main
git checkout dev
git rebase main

rebase vs merge:

对比项mergerebase
历史保留分叉,生成合并提交线性历史,更干净
冲突处理一次解决可能多次解决
适用公共分支私有分支整理

警告: 不要对已推送的公共分支做 rebase,会改写历史,影响他人。

5.4 解决冲突#

当合并或拉取出现冲突时:

git status                # 查看冲突文件

冲突文件中会出现标记:

<<<<<<< HEAD
当前分支的代码
=======
要合并进来的代码
>>>>>>> dev

解决步骤:

  1. 打开冲突文件,手动编辑,保留正确内容
  2. 删除 <<<<<<<、=======、>>>>>>> 标记
  3. git add 冲突文件
  4. 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 pullfetch + 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:

对比项resetrevert
历史改写历史保留历史,新增撤销提交
已推送分支危险(需强推)安全(推荐)
适用本地未推送已推送远程

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 的关键。

页内目录14 章