分布式版本控制系统 Git 的安装与实战指南

若需要为特定项目配置不同信息，只需进入项目目录，去掉 --global 参数重新执行命令即可。

本地操作命令

本地仓库是 Git 操作的基础，常用命令覆盖了从初始化到版本回溯的全流程：

远程操作命令

远程仓库是团队共享代码的核心，以下命令覆盖了远程仓库的管理与同步：

代码同步：

# 从远程仓库抓取代码（不合并到工作区）
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）。
  2. 在功能分支开发完成后，切换回主分支（git checkout main）。
  3. 合并功能分支到主分支（git merge feature/user-profile）。
  4. 确认无误后，删除功能分支（git branch -d feature/user-profile），若分支未合并需强制删除，用 git branch -D 分支名。

核心分支命令：

# 创建分支（如开发新功能的 feature/payment 分支）
git branch feature/payment

# 切换分支
git checkout feature/payment

# 创建并切换分支（推荐用法）
git checkout -b feature/payment

# 查看所有分支（当前分支前带*）
git branch

# 查看分支最后一次提交
git branch -v

标签：标记重要版本

在项目发布节点（如 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 # 给当前提交打轻量标签

版本库目录与编码规范

版本库目录规范

混乱的目录结构会增加团队协作成本，统一的目录规范能提升开发效率。推荐的 Git 仓库根目录结构如下：

项目根目录/
├─ documents/      # 项目相关文档（需求文档、设计文档、测试报告等）
├─ projects/       # 项目源代码（按模块划分，如前端项目放 projects/frontend，后端放 projects/backend）
├─ README.md       # 项目说明文档（中文），包含项目介绍、目录结构、环境搭建步骤等
└─ README.en.md    # 项目说明文档（英文），方便国际协作

编码规范

编码规范是团队协作的'语言共识'，Git 仓库需配合编码规范与检查工具，确保代码质量：

• 常用编码规范：
  • Java 项目：遵循《阿里巴巴 Java 开发手册》，涵盖命名规范、注释要求、异常处理等细节。
  • 多语言通用：参考《Google 开源项目风格指南》，适配 C++、Python、JavaScript 等多种语言。
• 编码检查工具：
  • Java：使用'Java 开发规约 IDE 插件'，在 IDEA、Eclipse 中实时检测代码违规。
  • C++：用 Cpplint 工具，可集成到 Visual Studio 等 IDE。

通过工具自动化检查，能减少人工 review 成本，让代码风格保持一致。

冲突解决

多人协作时，同一文件的同一部分被修改，合并分支会触发冲突。Git 会在冲突文件中标记冲突区域，只需三步即可解决：

1. 查看冲突：执行 git status，会显示'both modified: 冲突文件名'，明确冲突文件。
2. 修改文件：打开冲突文件，Git 用 <<<<<<< HEAD（当前分支内容）、=======（待合并分支内容）、>>>>>>> 分支名 标记冲突区域，按需保留代码并删除标记。例如：

# 冲突前
<<<<<<< HEAD
String welcome = "欢迎登录";
=======
String welcome = "Welcome to Login";
>>>>>>> feature/i18n

# 冲突后（保留国际化版本）
String welcome = "Welcome to Login";

3. 提交结果：执行 git add 冲突文件名 将修改加入暂存区，再用 git commit 提交（无需额外写信息，Git 会自动生成冲突解决日志）。

若冲突复杂，可使用 git mergetool 启用可视化冲突解决工具（如 VS Code、Beyond Compare），降低操作难度。