Git 分布式版本控制系统指南
一、关于版本控制
1. 什么是版本控制？
版本控制是一种记录文件内容变化，以便将来查阅特定版本修订情况的系统。它允许开发者追踪代码的演变历史。
2. 版本控制系统（VCS）带来的好处
- 回溯能力：可以将选定的文件回溯到之前的状态，甚至将整个项目回退到过去某个时间点的状态。
- 差异对比：可以比较文件的变化细节，查出最后是谁修改了哪个地方，从而快速定位导致问题的原因。
- 恢复机制：即使项目中的文件被大量修改或删除，也能轻松恢复到原先的样子。
3. 版本控制系统分类
- 本地版本控制系统：如 RCS。
- 集中化版本控制系统：如 CVS、Subversion。
- 分布式版本控制系统：如 Git、Mercurial、Bazaar。
二、Git 核心概念
1. 三大文件状态
Git 通过三种状态精准管理代码变化，每一步操作都对应状态的转换：
- 已修改（modified）：文件在工作区被修改，但尚未存入本地数据库，是代码变化的初始状态。
- 已暂存（staged）：对已修改文件的当前版本做标记，确认这部分修改会纳入下次提交的快照，相当于给代码拍了张待存档的照片。
- 已提交（committed）：暂存区的快照被永久存入 Git 目录（本地数据库），代码进入安全存储状态。
这三种状态对应 Git 项目的三个核心区域：工作区（实际编写代码的文件夹）、暂存区（临时存放待提交修改的文件）、Git 目录（存储元数据和对象数据库的核心区域）。
2. 四步完成一次代码提交
Git 的基础操作围绕'修改 - 暂存 - 提交 - 同步'展开，每一步都有明确的目标：
- 工作区修改：在本地项目文件夹中编写或修改代码，比如新增一个
user.js文件实现用户登录功能。 - 暂存区标记：通过
git add命令将需要提交的修改加入暂存区，可精准选择单个文件或所有修改，避免误提交无关内容。 - 本地库提交：用
git commit将暂存区内容存入本地 Git 目录，同时填写清晰的提交信息，方便后续追溯。 - 远程库同步：通过
git push将本地提交推送到远程仓库，或用git pull拉取远程最新代码，确保团队协作时版本一致。
三、Git 实战：从环境配置到命令详解
1. 环境配置
安装 Git 后，首要任务是配置用户信息——这会写入每一次提交，成为你的身份标识，在团队协作中至关重要：
# 全局配置（所有本地仓库通用）
git config --global user.name "你的姓名"
git config --global user.email "你的工作邮箱"
# 查看配置是否生效
git config --list
# 单独查看某项配置，如用户名
git config user.name
若需要为特定项目配置不同信息，只需进入项目目录，去掉 --global 参数重新执行命令即可。
2. 本地操作命令
本地仓库是 Git 操作的基础，常用命令覆盖了从初始化到版本回溯的全流程：
| 命令 | 功能说明 | 示例 |
|---|---|---|
git init | 初始化本地仓库，生成隐藏的 .git 目录 | cd 项目文件夹 && git init |
git status | 查看文件状态，区分已修改、已暂存、未跟踪文件 | git status |
git add | 将文件添加到暂存区 | git add *.js（添加所有 JS 文件） |
git commit | 提交暂存区内容到本地仓库 | git commit -m "修复登录页表单验证 bug" |
git log | 查看提交历史，--oneline 参数可简化输出 | git log --oneline |
git rm | 从版本库移除文件（同时删除本地文件） | git rm obsolete.js |
git mv | 移动或重命名文件，保留版本记录 | git mv oldname.js newname.js |
git reset | 取消暂存区文件，或回溯版本 | git reset HEAD user.js（取消 user.js 暂存） |
git checkout | 撤销工作区修改，或切换分支 | git checkout -- user.js（撤销 user.js 未暂存的修改） |
3. 远程操作命令
远程仓库是团队共享代码的核心，以下命令覆盖了远程仓库的管理与同步：
代码同步：
# 从远程仓库抓取代码（不合并到工作区）
git fetch origin
# 拉取远程代码并合并到当前分支（多人协作常用）
git pull origin main
# 推送本地分支到远程仓库（首次推送需加 -u 关联分支）
git push -u origin main
# 克隆远程仓库到本地（初始化新项目时用）
git clone https://github.com/你的账号/项目名.git
查看/管理远程仓库：
# 查看已配置的远程仓库（-v 显示详细 URL）
git remote -v
# 添加远程仓库，命名为 origin（默认名称）
git remote add origin https://github.com/你的账号/项目名.git
# 重命名远程仓库（如将 origin 改为 github）
git remote rename origin github
# 移除远程仓库
git remote remove github
# 查看某个远程仓库的详细信息
git remote show origin
当拉取远程代码遇到'无关历史'冲突时，可添加 --allow-unrelated-histories 参数强制合并，如 git pull origin main --allow-unrelated-histories。
四、Git 分支与标签
1. 分支：隔离开发
- 分支协作流程：
- 接到需求后，从主分支（main）创建功能分支（如
feature/user-profile）。 - 在功能分支开发完成后，切换回主分支（
git checkout main）。 - 合并功能分支到主分支（
git merge feature/user-profile）。 - 确认无误后，删除功能分支（
git branch -d feature/user-profile），若分支未合并需强制删除，用git branch -D 分支名。
- 接到需求后，从主分支（main）创建功能分支（如
核心分支命令：
# 创建分支（如开发新功能的 feature/payment 分支）
git branch feature/payment
# 切换分支
git checkout feature/payment
# 创建并切换分支（推荐用法）
git checkout -b feature/payment
# 查看所有分支（当前分支前带*）
git branch
# 查看分支最后一次提交
git branch -v
2. 标签：标记重要版本
在项目发布节点（如 V1.0、V2.0），用标签标记特定提交，能快速定位发布版本，方便后续维护。Git 标签分为两种：
标签同步：默认 git push 不推送标签，需手动推送：
# 推送单个标签到远程
git push origin v1.0
# 推送所有标签到远程
git push origin --tags
附注标签：包含标签者信息、创建时间、附注描述，更适合团队共享：
git tag -a v1.0 -m "V1.0 版本：完成用户注册、登录、商品列表功能"
轻量标签：仅存储提交校验和，适合本地临时标记：
git tag v1.0 # 给当前提交打轻量标签
五、版本库目录与编码规范
1. 版本库目录规范
混乱的目录结构会增加团队协作成本，统一的目录规范能提升开发效率。推荐的 Git 仓库根目录结构如下：
项目根目录/
├─ documents/ # 项目相关文档（需求文档、设计文档、测试报告等）
├─ projects/ # 项目源代码（按模块划分，如前端项目放 projects/frontend，后端放 projects/backend）
├─ README.md # 项目说明文档（中文），包含项目介绍、目录结构、环境搭建步骤等
└─ README.en.md # 项目说明文档（英文），方便国际协作
2. 编码规范
编码规范是团队协作的语言共识，Git 仓库需配合编码规范与检查工具，确保代码质量：
- 常用编码规范：
- Java 项目：遵循《阿里巴巴 Java 开发手册》，涵盖命名规范、注释要求、异常处理等细节。
- 多语言通用：参考《Google 开源项目风格指南》，适配 C++、Python、JavaScript 等多种语言。
- 编码检查工具：
- Java：使用 Java 开发规约 IDE 插件，在 IDEA、Eclipse 中实时检测代码违规。
- C++：用 Cpplint 工具，可集成到 Visual Studio 等 IDE。
通过工具自动化检查，能减少人工 review 成本，让代码风格保持一致。
六、冲突解决
多人协作时，同一文件的同一部分被修改，合并分支会触发冲突。Git 会在冲突文件中标记冲突区域，只需三步即可解决：
- 查看冲突：执行
git status，会显示 both modified: 冲突文件名，明确冲突文件。 - 修改文件：打开冲突文件，Git 用
<<<<<<< HEAD（当前分支内容）、=======（待合并分支内容）、>>>>>>> 分支名标记冲突区域，按需保留代码并删除标记。 - 提交结果：执行
git add 冲突文件名将修改加入暂存区，再用git commit提交（无需额外写信息，Git 会自动生成冲突解决日志）。
例如：
<<<<<<< HEAD
String welcome = "欢迎登录";
=======
String welcome = "Welcome to Login";
>>>>>>> feature/i18n
修正后：
String welcome = "Welcome to Login";
若冲突复杂，可使用 git mergetool 启用可视化冲突解决工具（如 VS Code、Beyond Compare），降低操作难度。