Git 使用指南详解：从入门到精通

📖 阅读导航

• 什么是版本控制？为什么需要 Git？
• Git 的核心概念：工作区、暂存区、版本库
• 如何安装和配置 Git？
• Git 基础命令详解与实战演示
• 分支管理：创建、切换、合并、删除
• 远程仓库操作：克隆、推送、拉取
• 高级功能：暂存、重置、回退、挑选提交
• 实际工作流程与最佳实践

---

🎯 学习目标

通过本文，你将掌握：

• Git 的基本原理和核心概念
• 常用 Git 命令的使用方法
• 分支管理和团队协作技巧
• 解决常见问题的方法
• 建立高效的 Git 工作流程

---

📚 目录

1. Git 简介与版本控制概念
2. Git 安装与环境配置
3. Git 核心概念详解
4. Git 基础命令操作
5. 分支管理与合并策略
6. 远程仓库操作
7. Git 高级功能
8. 实际工作流程与最佳实践
9. 常见问题与解决方案
10. 总结与进阶学习

---

1. Git 简介与版本控制概念

1.1 什么是版本控制？

版本控制是一种记录文件内容变化，以便将来查阅特定版本修订情况的系统。它可以：

• 追踪文件变化：记录每次修改的内容、时间、作者
• 版本回退：随时回到项目的任意历史状态
• 协作开发：多人同时修改同一项目而不冲突
• 分支管理：并行开发不同功能特性

1.2 为什么选择 Git？

Git 是目前最流行的分布式版本控制系统，具有以下优势：

特性	Git	传统版本控制（如 SVN）
架构	分布式	集中式
离线工作	✅ 完全支持	❌ 需要网络连接
性能	⚡ 极快	🐌 相对较慢
分支操作	🚀 轻量级，秒级创建	🐢 重量级，耗时较长
数据完整性	🔒 SHA-1 校验	⚠️ 相对较弱

1.3 Git 的发展历史

• 2005年：Linus Torvalds 为 Linux 内核开发创建 Git
• 设计目标：速度、简单设计、强力支持非线性开发、完全分布式、能够高效管理大型项目

---

2. Git 安装与环境配置

2.1 安装 Git

Windows 系统

# 方法1：官网下载安装包
# 访问 https://git-scm.com/download/win

# 方法2：使用包管理器
# 使用 Chocolatey
choco install git

# 使用 Scoop
scoop install git

macOS 系统

# 方法1：使用 Homebrew
brew install git

# 方法2：使用 MacPorts
sudo port install git

# 方法3：Xcode Command Line Tools
xcode-select --install

Linux 系统

# Ubuntu/Debian
sudo apt update
sudo apt install git

# CentOS/RHEL/Fedora
sudo yum install git
# 或者 (Fedora 22+)
sudo dnf install git

# Arch Linux
sudo pacman -S git

2.2 验证安装

# 检查 Git 版本
git --version
# 输出示例：git version 2.34.1

2.3 初始配置

安装完成后，需要配置用户信息：

# 配置用户名（必需）
git config --global user.name "你的姓名"

# 配置邮箱（必需）
git config --global user.email "your.email@example.com"

# 配置默认编辑器（可选）
git config --global core.editor "code --wait"  # VS Code
git config --global core.editor "vim"          # Vim
git config --global core.editor "nano"         # Nano

# 配置默认分支名（推荐）
git config --global init.defaultBranch main

# 查看所有配置
git config --list

# 查看特定配置
git config user.name
git config user.email

2.4 配置级别说明

Git 有三个配置级别：

级别	作用范围	配置文件位置	命令参数
系统级	所有用户	/etc/gitconfig	--system
用户级	当前用户	~/.gitconfig	--global
仓库级	当前仓库	.git/config	--local

优先级：仓库级 > 用户级 > 系统级

---

3. Git 核心概念详解

3.1 Git 的三个区域

Git 有三个主要的工作区域：

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Working Dir   │    │  Staging Area   │    │   Repository    │
│    (工作区)      │    │   (暂存区)      │    │   (版本库)      │
│                 │    │                 │    │                 │
│  ┌───────────┐  │    │  ┌───────────┐  │    │  ┌───────────┐  │
│  │   File    │  │    │  │   Index   │  │    │  │  Commits  │  │
│  │   修改    │  │    │  │   准备    │  │    │  │   历史    │  │
│  └───────────┘  │    │  └───────────┘  │    │  └───────────┘  │
└─────────────────┘    └─────────────────┘    └─────────────────┘
        │                       │                       │
        │        git add        │       git commit      │
        └───────────────────────┼───────────────────────┘
                               │
                    git checkout / git reset

工作区（Working Directory）

• 你在电脑上看到的目录
• 包含项目的实际文件
• 可以编辑、修改文件

暂存区（Staging Area / Index）

• 临时保存即将提交的修改
• 位于 .git/index 文件中
• 可以选择性地添加修改

版本库（Repository）

• 包含项目的完整历史
• 位于 .git 目录中
• 存储所有提交记录

3.2 文件状态生命周期

    Untracked    Modified     Staged      Committed
        │            │           │            │
        │            │           │            │
   ┌────▼────┐  ┌────▼────┐ ┌───▼────┐  ┌────▼────┐
   │  新文件  │  │  已修改  │ │ 已暂存  │  │  已提交  │
   │         │  │         │ │        │  │         │
   └────┬────┘  └────┬────┘ └───┬────┘  └────┬────┘
        │            │           │            │
        │ git add    │ git add   │git commit  │
        └────────────┴───────────┴────────────┘
                                │
                     git checkout / git reset
                                │
                         ┌──────▼──────┐
                         │   Modified   │
                         │   (重新修改)  │
                         └─────────────┘

3.3 Git 对象模型

Git 使用四种对象类型：

Blob（二进制大对象）

• 存储文件内容
• 通过 SHA-1 哈希标识

Tree（树对象）

• 存储目录结构
• 包含文件名和对应的 blob 引用

Commit（提交对象）

• 包含树对象引用
• 包含作者、提交者、时间戳、提交信息
• 包含父提交引用

Tag（标签对象）

• 指向特定提交的引用
• 通常用于标记版本发布

---

4. Git 基础命令操作

4.1 仓库初始化

创建新仓库

# 在当前目录初始化 Git 仓库
git init

# 在指定目录创建并初始化仓库
git init my-project
cd my-project

# 创建裸仓库（用于服务器）
git init --bare

克隆现有仓库

# 克隆远程仓库
git clone https://github.com/user/repo.git

# 克隆到指定目录
git clone https://github.com/user/repo.git my-local-name

# 克隆指定分支
git clone -b develop https://github.com/user/repo.git

# 浅克隆（只获取最近的提交历史）
git clone --depth 1 https://github.com/user/repo.git

4.2 文件操作命令

查看状态

# 查看工作区状态
git status

# 简洁输出
git status -s
git status --short

# 输出示例：
# M  modified_file.txt     # 已修改，已暂存
#  M modified_file2.txt    # 已修改，未暂存
# A  new_file.txt          # 新文件，已暂存
# ?? untracked_file.txt    # 未跟踪文件

添加文件到暂存区

# 添加单个文件
git add filename.txt

# 添加多个文件
git add file1.txt file2.txt

# 添加所有修改的文件
git add .
git add -A
git add --all

# 添加所有 .txt 文件
git add *.txt

# 交互式添加（选择性添加文件的部分内容）
git add -i
git add -p filename.txt

提交更改

# 提交暂存区的更改
git commit -m "提交信息"

# 提交并添加详细描述
git commit -m "简短描述" -m "详细描述
可以多行
包含更多信息"

# 跳过暂存区直接提交（仅对已跟踪文件有效）
git commit -am "提交信息"

# 修改最后一次提交
git commit --amend -m "新的提交信息"

# 空提交（用于触发 CI/CD）
git commit --allow-empty -m "触发构建"

4.3 查看历史记录

基本日志查看

# 查看提交历史
git log

# 简洁的一行显示
git log --oneline

# 图形化显示分支
git log --graph --oneline --all

# 显示最近 n 次提交
git log -n 5
git log -5

# 显示统计信息
git log --stat

# 显示具体修改内容
git log -p
git log --patch

高级日志查询

# 按作者筛选
git log --author="张三"

# 按时间筛选
git log --since="2023-01-01"
git log --until="2023-12-31"
git log --since="2 weeks ago"

# 按提交信息筛选
git log --grep="修复"

# 按文件筛选
git log -- filename.txt
git log --follow -- filename.txt  # 跟踪文件重命名

# 组合条件
git log --author="张三" --since="1 month ago" --grep="功能"

美化日志输出

# 自定义格式
git log --pretty=format:"%h - %an, %ar : %s"

# 常用别名设置
git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit"

# 使用别名
git lg

4.4 查看差异

# 查看工作区与暂存区的差异
git diff

# 查看暂存区与最后一次提交的差异
git diff --staged
git diff --cached

# 查看工作区与最后一次提交的差异
git diff HEAD

# 比较两个提交
git diff commit1 commit2

# 比较两个分支
git diff branch1 branch2

# 只显示文件名
git diff --name-only

# 显示统计信息
git diff --stat

4.5 撤销操作

撤销工作区修改

# 撤销单个文件的修改
git checkout -- filename.txt

# 撤销所有修改
git checkout -- .

# 新语法（Git 2.23+）
git restore filename.txt
git restore .

撤销暂存区修改

# 取消暂存单个文件
git reset HEAD filename.txt

# 取消暂存所有文件
git reset HEAD

# 新语法（Git 2.23+）
git restore --staged filename.txt
git restore --staged .

撤销提交

# 撤销最后一次提交，保留修改在工作区
git reset --soft HEAD~1

# 撤销最后一次提交，保留修改在暂存区
git reset --mixed HEAD~1
git reset HEAD~1  # 默认是 --mixed

# 撤销最后一次提交，完全删除修改
git reset --hard HEAD~1

# 撤销指定提交（创建新的撤销提交）
git revert commit-hash

---

5. 分支管理与合并策略

5.1 分支基础概念

分支是 Git 最强大的功能之一，它允许你：

• 并行开发不同功能
• 隔离实验性代码
• 支持多人协作开发
• 维护不同版本的代码

    main分支:    A---B---C---F---G
                      \         /
    feature分支:       D---E---/

5.2 分支操作命令

查看分支

# 查看本地分支
git branch

# 查看所有分支（包括远程）
git branch -a

# 查看远程分支
git branch -r

# 查看分支详细信息
git branch -v

# 查看已合并的分支
git branch --merged

# 查看未合并的分支
git branch --no-merged

创建分支

# 创建新分支
git branch feature-login

# 创建并切换到新分支
git checkout -b feature-login

# 新语法（Git 2.23+）
git switch -c feature-login

# 基于指定提交创建分支
git branch feature-login commit-hash

# 基于远程分支创建本地分支
git checkout -b local-branch origin/remote-branch

切换分支

# 切换到指定分支
git checkout feature-login

# 新语法（Git 2.23+）
git switch feature-login

# 切换到上一个分支
git checkout -
git switch -

# 强制切换（丢弃当前修改）
git checkout -f branch-name

删除分支

# 删除已合并的分支
git branch -d feature-login

# 强制删除分支（即使未合并）
git branch -D feature-login

# 删除远程分支
git push origin --delete feature-login
git push origin :feature-login  # 旧语法

5.3 合并策略

Fast-Forward 合并

当目标分支是当前分支的直接后继时：

# 快进合并（默认）
git merge feature-branch

# 禁用快进合并，强制创建合并提交
git merge --no-ff feature-branch

合并前:
    main:     A---B---C
                   \
    feature:        D---E

快进合并后:
    main:     A---B---C---D---E

三方合并

当两个分支都有新提交时：

# 三方合并
git merge feature-branch

# 指定合并信息
git merge feature-branch -m "合并功能分支"

合并前:
    main:     A---B---C---F
                   \
    feature:        D---E

三方合并后:
    main:     A---B---C---F---M
                   \         /
    feature:        D---E---/

Rebase 合并

将一个分支的修改重新应用到另一个分支上：

# 变基操作
git checkout feature-branch
git rebase main

# 或者一步完成
git rebase main feature-branch

# 交互式变基
git rebase -i HEAD~3

变基前:
    main:     A---B---C---F
                   \
    feature:        D---E

变基后:
    main:     A---B---C---F
                           \
    feature:                D'---E'

5.4 解决合并冲突

当 Git 无法自动合并时，会产生冲突：

# 查看冲突文件
git status

# 冲突文件内容示例：
<<<<<<< HEAD
当前分支的内容
=======
要合并分支的内容
>>>>>>> feature-branch

解决冲突的步骤：

1. 编辑冲突文件，选择保留的内容
2. 删除冲突标记（<<<<<<<, =======, >>>>>>>）
3. 添加解决后的文件：git add filename
4. 完成合并：git commit

# 中止合并
git merge --abort

# 中止变基
git rebase --abort

# 继续变基（解决冲突后）
git rebase --continue

---

6. 远程仓库操作

6.1 远程仓库概念

远程仓库是托管在网络上的项目版本，常见的托管平台：

• GitHub：全球最大的代码托管平台
• GitLab：支持私有部署
• Gitee：国内代码托管平台
• Bitbucket：Atlassian 旗下平台

6.2 远程仓库管理

查看远程仓库

# 查看远程仓库
git remote

# 查看远程仓库详细信息
git remote -v

# 查看特定远程仓库信息
git remote show origin

添加远程仓库

# 添加远程仓库
git remote add origin https://github.com/user/repo.git

# 添加多个远程仓库
git remote add upstream https://github.com/original/repo.git
git remote add fork https://github.com/myuser/repo.git

修改远程仓库

# 修改远程仓库 URL
git remote set-url origin https://github.com/user/new-repo.git

# 重命名远程仓库
git remote rename origin upstream

# 删除远程仓库
git remote remove origin

6.3 推送和拉取

推送到远程仓库

# 推送当前分支到远程仓库
git push origin main

# 推送所有分支
git push origin --all

# 推送标签
git push origin --tags

# 强制推送（危险操作）
git push origin main --force
git push origin main -f

# 安全的强制推送
git push origin main --force-with-lease

# 设置上游分支
git push -u origin main
git push --set-upstream origin main

从远程仓库拉取

# 拉取并合并
git pull origin main

# 拉取所有分支信息
git fetch origin

# 拉取所有远程仓库信息
git fetch --all

# 拉取并变基
git pull --rebase origin main

# 设置默认拉取策略
git config --global pull.rebase true

fetch vs pull 的区别

# git fetch：只下载，不合并
git fetch origin
git merge origin/main  # 手动合并

# git pull：下载并合并（相当于 fetch + merge）
git pull origin main

# git pull --rebase：下载并变基（相当于 fetch + rebase）
git pull --rebase origin main

6.4 跟踪分支

# 查看跟踪关系
git branch -vv

# 设置当前分支跟踪远程分支
git branch --set-upstream-to=origin/main

# 创建跟踪分支
git checkout -b local-branch origin/remote-branch

# 推送并设置跟踪
git push -u origin feature-branch

---

7. Git 高级功能

7.1 暂存功能（Stash）

当你需要临时保存工作进度时：

# 暂存当前修改
git stash

# 暂存时添加描述
git stash save "修复登录bug的临时保存"

# 查看暂存列表
git stash list

# 应用最新的暂存
git stash apply

# 应用指定的暂存
git stash apply stash@{2}

# 应用并删除暂存
git stash pop

# 删除暂存
git stash drop stash@{1}

# 清空所有暂存
git stash clear

# 查看暂存内容
git stash show
git stash show -p stash@{1}

7.2 重置功能（Reset）

# 软重置：移动 HEAD，保留暂存区和工作区
git reset --soft HEAD~1

# 混合重置：移动 HEAD，重置暂存区，保留工作区（默认）
git reset --mixed HEAD~1
git reset HEAD~1

# 硬重置：移动 HEAD，重置暂存区和工作区
git reset --hard HEAD~1

# 重置到指定提交
git reset --hard commit-hash

# 重置单个文件
git reset HEAD filename.txt

7.3 回退功能（Revert）

# 回退指定提交（创建新的提交）
git revert commit-hash

# 回退合并提交
git revert -m 1 merge-commit-hash

# 回退多个提交
git revert HEAD~3..HEAD

7.4 挑选提交（Cherry-pick）

# 挑选单个提交
git cherry-pick commit-hash

# 挑选多个提交
git cherry-pick commit1 commit2

# 挑选提交范围
git cherry-pick start-commit..end-commit

# 挑选时不自动提交
git cherry-pick --no-commit commit-hash

7.5 标签管理

# 创建轻量标签
git tag v1.0.0

# 创建附注标签
git tag -a v1.0.0 -m "版本 1.0.0 发布"

# 为指定提交创建标签
git tag -a v1.0.0 commit-hash -m "版本 1.0.0"

# 查看标签
git tag
git tag -l "v1.*"

# 查看标签信息
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

7.6 子模块（Submodules）

# 添加子模块
git submodule add https://github.com/user/repo.git path/to/submodule

# 初始化子模块
git submodule init

# 更新子模块
git submodule update

# 克隆包含子模块的仓库
git clone --recursive https://github.com/user/repo.git

# 更新所有子模块
git submodule update --remote

# 删除子模块
git submodule deinit path/to/submodule
git rm path/to/submodule

---

8. 实际工作流程与最佳实践

8.1 Git Flow 工作流

Git Flow 是一种广泛使用的分支管理策略：

    main     ●─────●─────●─────●─────●
             │     │     │     │     │
    develop  ●─────●─────●─────●─────●
             │\    │    /│\    │    /│
    feature   │ ●──●──●─/ │ ●──●──●─/ │
             │           │           │
    release   │           ●───●───●──/
             │                      
    hotfix    ●──────────────────●──/

分支类型说明

分支类型	用途	生命周期	命名规范
main	生产环境代码	永久	main
develop	开发环境代码	永久	develop
feature	新功能开发	临时	feature/功能名
release	版本发布准备	临时	release/版本号
hotfix	紧急修复	临时	hotfix/问题描述

实际操作流程

# 1. 初始化 Git Flow
git flow init

# 2. 开始新功能开发
git flow feature start login-system

# 3. 完成功能开发
git flow feature finish login-system

# 4. 开始发布准备
git flow release start 1.0.0

# 5. 完成发布
git flow release finish 1.0.0

# 6. 紧急修复
git flow hotfix start critical-bug
git flow hotfix finish critical-bug

8.2 GitHub Flow 工作流

GitHub Flow 是一种更简单的工作流：

# 1. 创建功能分支
git checkout -b feature/new-feature

# 2. 开发并提交
git add .
git commit -m "添加新功能"

# 3. 推送分支
git push origin feature/new-feature

# 4. 创建 Pull Request

# 5. 代码审查和讨论

# 6. 合并到主分支
git checkout main
git merge feature/new-feature

# 7. 删除功能分支
git branch -d feature/new-feature
git push origin --delete feature/new-feature

8.3 提交信息规范

Conventional Commits 规范

<类型>[可选的作用域]: <描述>

[可选的正文]

[可选的脚注]

常用类型

类型	描述
feat	新功能
fix	修复bug
docs	文档更新
style	代码格式化
refactor	代码重构
test	测试相关
chore	构建过程或辅助工具的变动

示例

git commit -m "feat(auth): 添加用户登录功能"
git commit -m "fix(api): 修复用户信息获取接口错误"
git commit -m "docs: 更新 README 文档"
git commit -m "style: 格式化代码缩进"
git commit -m "refactor(utils): 重构工具函数"
git commit -m "test: 添加登录功能单元测试"
git commit -m "chore: 更新依赖包版本"

8.4 .gitignore 文件配置

# 创建 .gitignore 文件
touch .gitignore

# 常见忽略规则
echo "node_modules/" >> .gitignore
echo "*.log" >> .gitignore
echo ".env" >> .gitignore

常用 .gitignore 模板

# 依赖目录
node_modules/
vendor/

# 日志文件
*.log
logs/

# 环境配置
.env
.env.local
.env.production

# 编译输出
dist/
build/
*.min.js
*.min.css

# IDE 配置
.vscode/
.idea/
*.swp
*.swo

# 操作系统
.DS_Store
Thumbs.db

# 临时文件
*.tmp
*.temp

8.5 Git Hooks 自动化

Git Hooks 允许在特定事件发生时自动执行脚本：

常用 Hooks

Hook	触发时机	用途
pre-commit	提交前	代码检查、格式化
commit-msg	提交信息验证	检查提交信息格式
pre-push	推送前	运行测试
post-receive	接收推送后	自动部署

示例：pre-commit Hook

#!/bin/sh
# .git/hooks/pre-commit

# 运行代码检查
npm run lint
if [ $? -ne 0 ]; then
    echo "代码检查失败，请修复后再提交"
    exit 1
fi

# 运行测试
npm test
if [ $? -ne 0 ]; then
    echo "测试失败，请修复后再提交"
    exit 1
fi

---

9. 常见问题与解决方案

9.1 撤销操作

问题：提交了错误的文件

# 解决方案1：修改最后一次提交
git reset --soft HEAD~1
# 重新添加正确的文件
git add correct-file.txt
git commit -m "正确的提交信息"

# 解决方案2：使用 amend
git reset HEAD~1 wrong-file.txt
git add correct-file.txt
git commit --amend

问题：提交信息写错了

# 修改最后一次提交信息
git commit --amend -m "正确的提交信息"

# 如果已经推送，需要强制推送
git push --force-with-lease

9.2 分支问题

问题：切换分支时有未提交的修改

# 解决方案1：暂存修改
git stash
git checkout other-branch
# 稍后回来继续工作
git checkout original-branch
git stash pop

# 解决方案2：提交修改
git add .
git commit -m "临时提交"
git checkout other-branch
# 稍后回来撤销提交
git checkout original-branch
git reset --soft HEAD~1

问题：删除了错误的分支

# 查找分支的最后一次提交
git reflog

# 恢复分支
git checkout -b recovered-branch commit-hash

9.3 合并冲突

问题：复杂的合并冲突

# 使用图形化工具解决冲突
git mergetool

# 配置合并工具
git config --global merge.tool vimdiff
git config --global merge.tool vscode

问题：想要撤销合并

# 如果还没有推送
git reset --hard HEAD~1

# 如果已经推送
git revert -m 1 merge-commit-hash

9.4 远程仓库问题

问题：推送被拒绝

# 原因：远程仓库有新的提交
# 解决方案：先拉取再推送
git pull origin main
git push origin main

# 或者使用变基
git pull --rebase origin main
git push origin main

问题：忘记了远程仓库地址

# 查看远程仓库信息
git remote -v
git remote show origin

9.5 性能问题

问题：仓库太大，克隆很慢

# 浅克隆
git clone --depth 1 https://github.com/user/repo.git

# 部分克隆
git clone --filter=blob:none https://github.com/user/repo.git

问题：Git 操作很慢

# 垃圾回收
git gc

# 重新打包
git repack -ad

# 清理未跟踪的文件
git clean -fd

---

📖 官方文档

• Git 官方文档
• Pro Git 书籍

🎮 交互式学习

• Learn Git Branching
• Git 教程 - 廖雪峰

🔧 实用工具

• GitKraken - Git GUI 客户端
• SourceTree - 免费的 Git GUI
• GitHub Desktop - GitHub 官方客户端

---

🎉 结语

Git 是现代软件开发中不可或缺的工具。掌握 Git 不仅能提高你的开发效率，还能让你更好地参与团队协作。

记住，学习 Git 最好的方法就是多实践。建议你：

1. 🏗️ 创建练习项目：在实际项目中应用所学知识
2. 🤝 参与开源项目：通过贡献开源项目提升协作技能
3. 📚 持续学习：Git 功能丰富，保持学习新特性的习惯
4. 🔄 建立工作流：在团队中建立适合的 Git 工作流程

希望这份指南能帮助你更好地掌握 Git，在软件开发的道路上更进一步！

---

💡 提示：如果你在使用过程中遇到问题，不要害怕查阅文档或寻求帮助。Git 社区非常活跃，大部分问题都能找到解决方案。

🔖 收藏建议：建议收藏本文档，在实际使用中可以随时查阅相关命令和最佳实践。

Happy Coding! 🚀