Git 版本控制从入门到精通实战指南

也可以使用图形化安装工具，下载 dmg 文件运行即可。

Git 配置

Git 提供了 git config 命令来配置工作环境变量。这些变量决定了 Git 在各个环节的具体工作方式。

配置文件存放在三个不同地方：

• /etc/gitconfig：系统级配置，对所有用户适用。
• ~/.gitconfig：用户级配置，仅适用于当前用户。
• .git/config：项目级配置，仅针对当前项目有效。

级别越高的配置会覆盖低级别的同名配置。

用户信息

配置个人名称和邮箱，记录提交者信息：

git config --global user.name "Your Name"
git config --global user.email [email protected]

文本编辑器

设置默认使用的文本编辑器，例如 VS Code：

git config --global core.editor "code --wait"

差异分析工具

解决合并冲突时使用的工具，例如 vimdiff：

git config --global merge.tool vimdiff

查看配置信息

检查已有配置：

git config --list

直接查阅某个环境变量：

git config user.name

生成 SSH 密钥（可选）

如需通过 SSH 操作，可生成密钥：

ssh-keygen -t rsa -b 4096 -C "[email protected]"

按提示完成生成，将公钥添加到托管服务。

验证安装

运行以下命令确保安装配置正确：

git --version
git config --list

Git 工作流程

下图展示了 Git 的基本工作流程：

克隆仓库

参与已有项目时，首先将远程仓库克隆到本地：

git clone https://github.com/username/repo.git
cd repo

创建新分支

避免直接在主分支开发，通常创建新分支：

git checkout -b new-feature

工作目录

在工作目录中进行代码编辑、添加或删除文件。

暂存文件

将修改的文件添加到暂存区：

git add filename
# 或者添加所有修改
 git add .

提交更改

将暂存区的更改提交到本地仓库：

git commit -m "Add new feature"

拉取最新更改

推送前最好拉取最新更改以避免冲突：

git pull origin main

推送更改

将本地提交推送到远程仓库：

git push origin new-feature

创建 Pull Request（PR）

在托管平台上创建 PR，邀请团队成员审查。合并后更改进入主分支。

合并更改

审核通过后，将远程主分支合并到本地：

git checkout main
git pull origin main
git merge new-feature

删除分支

不再需要时可删除分支：

git branch -d new-feature
# 从远程删除
 git push origin --delete new-feature

Git 工作区、暂存区和版本库

基本概念

• 工作区：你在电脑里能看到的目录。
• 暂存区：英文叫 stage 或 index，一般存放在 .git/index 中。
• 版本库：工作区隐藏目录 .git，包含所有版本历史记录。

图中左侧为工作区，右侧为版本库。标记为 "index" 的区域是暂存区，"master" 代表 master 分支。

HEAD 指向 master 分支的一个游标。objects 标识区域为对象库，位于 .git/objects 目录下。

当对工作区修改执行 git add 时，暂存区更新，文件内容写入对象库，ID 记录在索引中。

执行 git commit 时，暂存区目录树写到版本库，master 分支更新。

执行 git reset HEAD 时，暂存区被重写，工作区不受影响。

执行 git rm --cached <file> 时，直接从暂存区删除文件。

执行 git checkout . 会用暂存区替换工作区文件，此操作危险，会清除未暂存的改动。

执行 git checkout HEAD . 会用 HEAD 指向的分支替换暂存区和工作区文件，同样危险。

1、工作区（Working Directory）

本地计算机上的项目目录，进行文件的创建、修改和删除。

• 显示项目的当前状态。
• 文件修改在此进行，但未记录到版本控制中。

2、暂存区（Staging Area）

临时存储区域，包含即将提交的快照。

• 保存下一个提交中的更改。
• 可多次使用 git add 直到准备好提交。

常用命令：

git add filename
git add .
git status

3、版本库（Repository）

包含所有版本历史记录，每次提交创建不可变快照。

• 分为本地和远程版本库。
• 本地存储在 .git 目录中。

常用命令：

git commit -m "Commit message"
git log
git diff
git diff --cached

关系流转

1. 工作区 -> 暂存区：git add
2. 暂存区 -> 版本库：git commit
3. 版本库 -> 远程仓库：git push
4. 远程仓库 -> 本地版本库：git pull 或 git fetch

实例

假设修改了 file.txt：

1. 工作区：修改并保存。
2. 暂存区：git add file.txt
3. 版本库：git commit -m "Update file.txt"
4. 远程仓库：git push origin main

Git 创建仓库

git init

初始化 Git 仓库，生成 .git 目录，包含资源元数据。

使用方法

进入目标目录：

mkdir my-project
cd my-project

初始化当前目录：

git init

指定目录初始化：

git init newrepo

纳入版本控制并提交：

git add *.c
git add README
git commit -m '初始化项目版本'

注意：Linux 系统中 commit 信息可用单引号，Windows 命令行建议使用双引号。

git clone

从现有仓库拷贝项目：

git clone <repo>

克隆到指定目录：

git clone <repo> <directory>

例如：

git clone git://github.com/schacon/grit.git mygrit

配置

显示配置：

git config --list

编辑配置：

git config -e # 当前仓库
git config -e --global # 所有仓库

设置用户信息：

git config --global user.name "Your Name"
git config --global user.email [email protected]

Git 基本操作

Git 的核心工作是创建和保存项目快照及对比。

常用 6 个命令：git clone、git push、git add、git commit、git checkout、git pull。

简单步骤：

git init
git add .
git commit

创建仓库命令

提交与修改

提交日志

远程操作

Git 文件状态

文件状态分为三种：工作目录、暂存区、本地仓库。

工作目录

• 未跟踪（Untracked）：新文件，未被 Git 记录。
• 已修改（Modified）：已跟踪文件发生更改，未提交。

暂存区

• 使用 git add <filename> 添加文件。
• 使用 git add . 添加所有更改。

本地仓库

• 隐藏在 .git 目录中。
• 使用 git commit -m "commit message" 提交。

状态转换流程

1. 未跟踪：新文件。

   touch newfile.txt
   git status
   

2. 已跟踪：git add 后。

   git add newfile.txt
   git status
   

3. 已修改：对已跟踪文件更改。

   echo "Hello" > newfile.txt
   git status
   

4. 已暂存：git add 后等待提交。

   git add newfile.txt
   git status
   

5. 已提交：git commit 后。

   git commit -m "Added newfile.txt"
   git status
   

Git 分支管理

分支让多个开发人员并行工作，不影响主代码库。

Git 分支是指向更改快照的指针。

创建分支

创建并切换：

git checkout -b <branchname>

切换分支：

git checkout <branchname>

查看分支

查看所有分支：

git branch

查看远程分支：

git branch -r

查看所有本地和远程：

git branch -a

合并分支

合并其他分支到当前分支：

git merge <branchname>

解决合并冲突

出现冲突时，Git 会标记文件。手动解决后：

git add <conflict-file>
git commit

删除分支

删除本地分支：

git branch -d <branchname>

强制删除：

git branch -D <branchname>

删除远程分支：

git push origin --delete <branchname>

实例

创建测试目录：

mkdir gitdemo
cd gitdemo/
git init
touch README
git add README
git commit -m '第一次版本提交'

列出分支：

git branch

创建新分支：

git branch testing
git branch

切换分支：

git checkout testing
ls

切回 master：

git checkout master
ls

创建并切换：

git checkout -b newtest
git rm test.txt
touch runoob.php
git add .
git commit -am 'removed test.txt, add runoob.php'
git checkout master

删除分支：

git branch -d testing

分支合并：

git merge newtest
git branch -d newtest

合并冲突示例

创建 change_site 分支修改文件：

git checkout -b change_site
vim runoob.php
git commit -am 'changed the runoob.php'

切回 master 修改同一文件：

git checkout master
vim runoob.php
git commit -am '修改代码'

合并产生冲突：

git merge change_site
cat runoob.php

解决冲突后提交：

git add runoob.php
git commit

命令手册

Git 查看提交历史

git log

查看提交历史记录，包括哈希值、作者、日期和消息。

基本语法：

git log [选项] [分支名/提交哈希]

常用选项：

• -p：显示补丁内容。
• --oneline：简洁一行格式。
• --graph：图形化显示分支合并。
• --author=<作者>：特定作者。
• --since=<时间>：指定时间之后。
• --grep=<模式>：搜索提交消息。

列出历史：

git log

简洁模式：

git log --oneline

拓扑图：

git log --oneline --graph

逆向显示：

git log --reverse --oneline

查找特定用户：

git log --author=Linus --oneline -5

限制数量：

git log -n 5

git blame

逐行显示代码由谁在何时修改。

格式：

git blame [选项] <文件路径>

常用选项：

• -L：指定行号范围。
• -C：溯源重命名或拷贝行。
• -M：溯源移动行。

显示文件每一行：

git blame <文件路径>

显示行数统计：

git blame --show-stats <文件路径>

恢复和回退

1、git checkout

恢复文件到指定提交：

git checkout <commit> -- <filename>

切换到特定提交（分离头指针状态）：

git checkout <commit>

2、git reset

重置当前分支到指定提交。

• --soft：只重置 HEAD。
• --mixed（默认）：重置 HEAD 和暂存区。
• --hard：重置 HEAD、暂存区和工作目录。

git reset --hard abc123

3、git revert

创建新提交以撤销指定提交，不改变历史。

git revert <commit>

4、git reflog

查看历史操作记录，找回丢失提交。

git reflog
git reset --hard HEAD@{3}

Git 标签

给重要阶段打上标签，通常用于发布版本。

创建标签：

git tag v1.0

带注解标签：

git tag -a v1.0 -m "message"

查看标签：

git tag
git show v1.1

推送标签到远程仓库

默认不推送，需显式：

git push origin <tagname>
git push origin --tags

删除标签

本地删除：

git tag -d <tagname>

远程删除：

git push origin --delete <tagname>

Git Flow

一种基于 Git 的分支模型，旨在帮助团队更好地管理和发布软件。

主要由以下几类分支组成：master、develop、feature、release、hotfix。

Git Flow 安装

Linux

Debian/Ubuntu:

sudo apt-get install git-flow

Fedora:

sudo dnf install gitflow

macOS

Homebrew:

brew install git-flow

Windows

使用 Git for Windows 或 Chocolatey/Scoop 包管理工具安装。

Git Flow 分支模型

• master：永远保持稳定和可发布状态。
• develop：集成所有开发分支，代表最新开发进度。
• feature：开发新功能，从 develop 创建，完成后合并回 develop。
• release：准备新版本，从 develop 创建，测试修复后合并回 develop 和 master。
• hotfix：紧急修复，从 master 创建，完成后合并回 master 和 develop。

Git Flow 工作流程

1. 初始化 Git Flow

git flow init

2. 创建功能分支

git flow feature start feature-name
git flow feature finish feature-name

3. 创建发布分支

git flow release start release-name
git flow release finish release-name

4. 创建修复分支

git flow hotfix start hotfix-name
git flow hotfix finish hotfix-name

优点和缺点

优点：明确的分支模型，隔离开发和发布，版本管理方便。 缺点：对于小型项目可能过于复杂，频繁合并可能导致冲突增加。

Git 进阶操作

1、交互式暂存（Interactive Staging）

git add -p 逐块选择要暂存的更改。

git add -p

常用选项：

• y：暂存当前块
• n：跳过
• s：拆分
• e：编辑

2、Git Stash

临时保存工作进度。

git stash
git stash list
git stash apply
git stash pop

3、Git Rebase

将一个分支上的更改移到另一个分支之上。

git rebase <branchname>

交互式变基：

git rebase -i <commit>

4、Git Cherry-Pick

选择特定提交应用到当前分支。

git cherry-pick abc123

Git 远程仓库

Git 不像 SVN 那样有个中心服务器。如果想分享代码，需要将数据放到服务器上。

添加远程库

git remote add [shortname] [url]

生成 SSH Key 并添加到 GitHub/GitLab 等平台。

验证连接：

ssh -T [email protected]

创建远程仓库后推送：

git remote add origin [email protected]:username/repo.git
git push -u origin master

查看当前的远程库

git remote
git remote -v

提取远程仓库

1. 下载新分支与数据：

   git fetch
   

2. 提取并尝试合并：

   git pull
   

推送到远程仓库

git push [alias] [branch]

删除远程仓库

git remote rm [别名]

Git 服务器搭建

使用裸存储库（Bare Repository）

1、安装 Git

sudo apt install git

2、创建裸存储库

groupadd git
useradd git -g git
sudo su - git
cd /home
mkdir gitrepo
chown git:git gitrepo/
cd gitrepo
git init --bare runoob.git
chown -R git:git runoob.git

3、创建证书登录

将公钥添加到 ~/.ssh/authorized_keys。

4、克隆仓库

git clone git@server_ip:/home/gitrepo/runoob.git

使用 GitLab

适合中大型团队，提供 CI/CD 等功能。

1. 安装 GitLab。
2. 配置管理员账户。
3. 创建项目。
4. 生成密钥对并添加 SSH key。
5. 克隆项目。

Sourcetree 使用教程

SourceTree 是 Git 客户端管理工具，适用于 Windows 和 Mac。

Sourcetree 安装

从官网下载安装包，运行安装程序。

连接 Github 账户

在设置中添加账户，即可管理远程仓库。

创建本地仓库

点击新建，选择创建本地仓库，输入路径和名称即可。

如果本地已有仓库，可直接添加。