Git 版本控制完全指南：从入门到实践

保存后执行：source ~/.bashrc

三、Git 基础：本地仓库操作

3.1 获取本地仓库

有两种方式获得 Git 仓库：

方式一：初始化新仓库

# 创建项目目录
mkdir my-project
cd my-project
# 初始化 Git 仓库
git init

成功后会在当前目录下生成隐藏的 .git 目录。

方式二：克隆远程仓库

# 从远程仓库克隆到本地
git clone 仓库路径 [本地目录名]
# 本地目录名可选，省略时会自动生成

3.2 Git 文件状态与工作区域

Git 文件有三种状态，对应三个工作区域：

• 工作区：实际编辑文件的目录
• 暂存区：保存即将提交的修改
• 本地仓库：保存已提交的历史版本

文件状态转换：

• 工作区 → 暂存区：git add
• 暂存区 → 本地仓库：git commit

3.3 常用基础命令

查看状态

git status

添加文件到暂存区

# 添加单个文件
git add 文件名
# 添加所有修改
git add .
# 或
git add -A

提交到本地仓库

git commit -m "提交说明"

查看提交日志

# 查看所有日志
git log
# 使用别名查看简洁日志
git-log
# 前提是配置了别名

版本回退

# 根据 commitID 回退
git reset --hard commitID
# 查看所有操作记录（包括已删除的提交）
git reflog

3.4 .gitignore 文件

有些文件无需纳入 Git 管理（如日志文件、编译产物等），可以在项目根目录创建 .gitignore 文件，列出要忽略的文件模式：

# 忽略所有.log 文件
*.log
# 忽略 target 目录
/target/
# 忽略配置文件但保留示例
config.properties
!config.properties.example

四、Git 分支管理

4.1 分支概念

分支允许你把工作从开发主线上分离出来，进行重大 Bug 修复或新功能开发，不影响主线。

4.2 分支常用命令

查看分支

# 查看本地分支
git branch
# 查看所有分支（包括远程）
git branch -a
# 查看分支与远程分支的关联关系
git branch -vv

创建分支

# 创建分支
git branch 分支名
# 创建并切换到新分支
git checkout -b 分支名

切换分支

git checkout 分支名

合并分支

# 先切换到目标分支（如 master）
git checkout master
# 将指定分支合并到当前分支
git merge 要合并的分支名

删除分支

# 普通删除（会检查）
git branch -d 分支名
# 强制删除（不检查）
git branch -D 分支名

注意：不能删除当前所在分支

4.3 分支开发原则与流程

在实际开发中，通常遵循以下分支策略：

1. master（生产）分支
   • 线上运行的主分支
   • 始终保持稳定可部署状态
2. develop（开发）分支
   • 从 master 创建
   • 主要开发分支
   • 开发完成后合并到 master
3. feature/xxx 分支
   • 从 develop 创建
   • 用于开发新功能
   • 完成后合并回 develop
4. hotfix/xxx 分支
   • 从 master 创建
   • 用于紧急修复线上 bug
   • 修复后合并到 master 和 develop

五、远程仓库协作

5.1 常用的代码托管平台

• GitHub (https://github.com/)：全球最大的开源平台
• 码云 Gitee (https://gitee.com/)：国内平台，速度快
• GitLab (https://about.gitlab.com/)：可用于搭建私服

5.2 配置 SSH 公钥

为了安全连接远程仓库，需要配置 SSH 公钥：

# 生成 SSH 密钥对
ssh-keygen -t rsa
# 连续回车即可
# 查看公钥
cat ~/.ssh/id_rsa.pub

将公钥内容复制到代码托管平台的 SSH 公钥设置页面。

验证配置是否成功：

ssh -T [email protected]

5.3 远程仓库操作

添加远程仓库

# 添加远程仓库
git remote add 远端名称 仓库地址
# 示例
git remote add origin [email protected]:用户名/仓库名.git

查看远程仓库

git remote
git remote -v
# 查看详细地址

推送到远程仓库

# 基本推送
git push origin master
# 强制推送（慎用）
git push -f origin master
# 推送并建立关联关系
git push --set-upstream origin master
# 建立关联后，可直接使用 git push
git push

从远程仓库拉取

有两种方式从远程获取更新：

抓取（fetch）：只下载更新，不合并

git fetch origin master

拉取（pull）：下载并合并（相当于 fetch+merge）

git pull origin master

5.4 查看本地分支与远程分支的关联关系

git branch -vv

这个命令会显示每个本地分支追踪的远程分支。

六、解决冲突

6.1 冲突的产生

当两个分支对同一个文件的同一行进行了不同的修改，合并时就会产生冲突。

6.2 解决冲突的步骤

1. 处理文件中冲突的地方
   • 打开冲突文件，查找 <<<<<<<、=======、>>>>>>> 标记
   • 手动编辑文件，保留需要的代码

提交到仓库

git commit -m "解决冲突"

将解决完冲突的文件加入暂存区

git add 文件名

七、Git 工作流程总结

7.1 基本工作流程

克隆/初始化 → 修改文件 → 添加到暂存区 → 提交到本地仓库 → 推送到远程仓库
↓ ↓ ↓ ↓ ↓
git clone 编辑代码 git add git commit git push

7.2 常用命令速查表

八、实用技巧

8.1 高效查看提交历史

# 一行显示，带图形化分支
git log --pretty=oneline --all --graph --abbrev-commit

8.2 找回丢失的提交

git reflog

8.3 暂存部分修改

# 交互式添加，可以选择添加哪些修改
git add -p

结语

Git 是现代软件开发不可或缺的工具，掌握 Git 不仅能提高个人开发效率，更能让团队协作变得顺畅。本文涵盖了从基础配置到高级分支策略的完整知识体系，希望能帮助你更好地使用 Git。

记住：熟能生巧，多实践才能真正掌握 Git 的精髓。如果在使用过程中遇到问题，可以使用 git --help 查看帮助文档，或者查阅官方文档。