Git 的核心价值

• 版本控制：完整记录所有修改历史，支持随时回退到任意历史版本
• 团队协作：允许多开发者同时工作，有效避免代码冲突和覆盖问题
• 高效分支：通过分支隔离功能开发与稳定主线，保持项目稳定性
• 变更追溯：详细记录每次提交信息，便于问题定位和责任追踪

二、环境配置与安装

1. Git 安装指南
   • 下载地址：https://git-scm.com/
   • 安装验证方法：

git --version

1. VSCode 插件推荐

插件名称	主要功能	是否免费
GitLens	代码行级历史追踪、高级提示	基础功能免费
Git Graph	可视化分支与提交历史	是
Git History	查看文件修改历史	是

1. 必要配置

# 设置全局用户信息（首次使用必须配置）
git config --global user.name "您的姓名"
git config --global user.email "您的邮箱"

三、基础工作流

1. 本地仓库操作指南

# 初始化新仓库
git init# 查看仓库当前状态 
git status# 文件管理操作
git add <文件名>      # 添加指定文件到暂存区
git add .             # 添加所有变更文件# 提交变更
git commit -m "提交说明"  # 提交暂存区内容到本地仓库# 查看历史记录
git log               # 显示提交历史

1. 文件状态说明

状态标识	含义	操作建议
U	文件冲突	需手动解决冲突
M	文件已修改	需执行add和commit操作
A	文件已暂存	等待提交至仓库
D	文件已删除	需提交删除操作
??	未跟踪文件	需先执行add命令

四、分支管理策略

1. 功能分支工作流

版本控制工作流程

1. 功能开发流程

1. 基于主分支创建功能分支

   git checkout -b feature/新功能名称
   

2. 开发并提交代码

   git add .
   git commit -m "实现新功能"
   

3. 合并到主分支

   git checkout main
   git merge feature/新功能名称
   

4. 清理功能分支

   git branch -d feature/新功能名称
   

2. 分支命名规范

• main/master：主分支，用于生产发布，必须保持稳定状态
• feature/：前缀，用于功能开发分支
• release/：前缀，用于版本发布准备分支
• hotfix/：前缀，用于线上问题紧急修复分支

五、可视化工具使用指南

1. Git Graph 使用

1. 1.点击 VSCode 侧边栏 Git Graph 图标
2. 2.查看图形化分支历史
3. 3.右键提交可进行分支操作（检出、合并、重置等）

2. Git History 使用前提

• •必须在 Git 仓库中（已执行 git init）
• •右键文件选择 "View File History"
• •可查看文件历史版本和差异对比

3. VSCode 内置 Git 功能

• •源代码管理视图（左侧第三个图标）
• •内联修改提示（需在设置中启用）
• •差异对比功能

六、常见问题解决方案

1. 仓库体积过大

原因：提交了大型文件（如二进制文件、压缩包、依赖库等）

解决方案：

• 使用 filter-repo 清理历史大文件（操作前请备份）：

  pip install git-filter-repo
  git filter-repo --path-glob '*.zip' --invert-paths
  # 强制推送到远程
  git push origin --force --all
  

预防措施：

• 完善 .gitignore 文件
• 使用 Git LFS 管理必需的大型文件：

  git lfs install
  git lfs track "*.psd"
  git lfs track "*.zip"
  

---

2. 插件无法正常工作

检查项：

1. 确保已安装 Git
2. 确认当前目录为 Git 仓库（已执行 git init）
3. 尝试重启 VSCode
4. 检查插件配置（如 git.path）

---

3. 提交身份错误

解决方案：

# 检查当前配置
git config --list
# 修改全局配置
git config --global user.name "正确姓名"
git config --global user.email "正确邮箱"

七、最佳实践总结

1. 1.

   ​​提交原则​​：

   • •原子化提交：一次提交只做一件事
   • •频繁提交：小步快走，避免大量更改一次性提交
   • •清晰描述：提交信息说明"为什么"而非"做了什么"
2. 2.

   ​​分支管理​​：

   • •主分支保持稳定
   • •特性开发使用功能分支
   • •定期合并和删除已合并分支
3. 3.

   ​​文件管理​​：

   • •使用 .gitignore 忽略不需要版本控制的文件
   • •大文件使用 Git LFS 管理
   • •定期清理历史大文件
4. 4.

   ​​协作流程​​：

   • •提交前先拉取最新代码
   • •使用 Pull Request 进行代码审查
   • •遵循团队统一的工作流规范

八、附录：常用命令速查

基础操作

git init          # 初始化仓库
git add .         # 添加所有文件到暂存区
git commit -m "描述"  # 提交更改
git status        # 查看状态
git log           # 查看提交历史

分支管理

git branch        # 查看分支列表
git checkout -b 新分支名  # 创建并切换到新分支
git merge 分支名   # 合并指定分支
git branch -d 分支名  # 删除分支

远程协作

git remote add origin 远程地址  # 添加远程仓库
git push -u origin 分支名  # 推送分支到远程
git pull origin 分支名  # 拉取远程分支更新
git clone 远程地址  # 克隆远程仓库

撤销操作

git restore <文件>    # 撤销工作区修改
git restore --staged <文件>  # 取消暂存
git reset --soft HEAD^  # 撤销提交但保留更改