Git详细使用教程：从入门到精通的完整指南

引言

Git作为全球最流行的分布式版本控制系统，已成为开发者协作开发的标配工具。它不仅能高效管理代码版本，还能通过分支策略和远程协作功能大幅提升团队开发效率。本教程将从基础安装到高级技巧，系统讲解Git的核心功能与使用场景，帮助开发者构建完整的Git知识体系。

一、Git基础环境搭建

1.1 安装与配置

• Windows系统：通过Git官网下载安装包，安装时勾选”Git Bash Here”和”Use Git and optional Unix tools from the Command Prompt”选项，确保命令行工具可用。
• Mac/Linux系统：通过包管理器安装（如brew install git或sudo apt-get install git），安装后验证版本：git --version。
• 全局配置：设置用户名和邮箱（必须配置，否则无法提交代码）：

  git config --global user.name "Your Name"
  git config --global user.email "your.email@example.com"

1.2 初始化本地仓库

• 创建新仓库：git init（生成.git隐藏目录，存储版本历史）
• 克隆远程仓库：git clone <仓库URL>（如git clone https://github.com/user/repo.git）

二、核心操作：版本控制全流程

2.1 工作区与暂存区管理

• 文件状态：
  • git status：查看文件状态（未跟踪/已修改/已暂存）
  • git add <文件>：将修改添加到暂存区（如git add src/main.js）
  • git add .：添加所有修改文件（慎用，避免误提交）
• 提交规范：
  • 提交前通过git diff查看修改内容
  • 提交命令：git commit -m "描述性提交信息"（如git commit -m "修复登录页表单验证逻辑"）

2.2 查看版本历史

• git log：显示完整提交历史（按q退出）
• git log --oneline：简化版日志（每行显示哈希和提交信息）
• git show <哈希>：查看特定提交的详细修改（如git show a1b2c3d）

2.3 版本回退

• 软回退（保留修改在工作区）：git reset --soft <哈希>
• 混合回退（保留修改但取消暂存）：git reset --mixed <哈希>（默认模式）
• 硬回退（彻底丢弃修改）：git reset --hard <哈希>（慎用！）
• 撤销未提交修改：git checkout -- <文件>（恢复文件到最新提交状态）

三、分支管理：高效协作的核心

3.1 分支创建与切换

• 创建分支：git branch <分支名>（如git branch feature/login）
• 切换分支：git checkout <分支名>或git switch <分支名>（Git 2.23+推荐）
• 创建并切换：git checkout -b <分支名>（如git checkout -b hotfix/1.1）

3.2 分支合并策略

• 快进合并（Fast-forward）：直接移动分支指针（适用于无冲突场景）
• 三方合并（Merge）：生成新提交合并分支（git merge <分支名>）
• 变基合并（Rebase）：线性化历史记录（git rebase <分支名>，慎用于公共分支）

3.3 冲突解决流程

1. 合并时Git提示冲突后，使用git status查看冲突文件
2. 打开冲突文件，标记为<<<<<<< HEAD（当前分支）和>>>>>>> <分支名>（待合并分支）
3. 手动修改冲突部分，删除标记符号
4. 添加修改并提交：git add <文件> → git commit（无需-m参数，Git会自动生成合并信息）

四、远程仓库协作

4.1 关联远程仓库

• 添加远程仓库：git remote add origin <URL>（如git remote add origin git@github.com:user/repo.git）
• 查看远程信息：git remote -v

4.2 推送与拉取

• 首次推送：git push -u origin <分支名>（如git push -u origin main）
• 后续推送：git push
• 拉取更新：git pull（等价于git fetch + git merge）

4.3 协作规范建议

• 开发分支：主分支（main/master）仅用于稳定版本，开发在feature分支进行
• Pull Request：通过GitHub/GitLab等平台提交合并请求，进行代码审查
• Tag管理：发布版本时打标签：git tag -a v1.0.0 -m "发布1.0版本" → git push origin v1.0.0

五、高级技巧与最佳实践

5.1 .gitignore文件配置

• 排除文件示例：

  # 编译输出
  /dist/
  /build/
  # 依赖目录
  /node_modules/
  # 环境变量
  .env
  # IDE文件
  .vscode/

5.2 储藏临时修改

• 临时保存工作区：git stash（如紧急修复bug时）
• 查看储藏列表：git stash list
• 恢复储藏：git stash pop（恢复并删除储藏）或git stash apply（保留储藏）

5.3 子模块管理

• 添加子模块：git submodule add <仓库URL> <路径>
• 更新子模块：git submodule update --init --recursive

5.4 性能优化

• 大文件处理：使用Git LFS（Large File Storage）管理二进制文件
• 浅克隆：仅克隆最新提交：git clone --depth 1 <URL>
• 压缩历史：定期执行git gc（Git自动运行，无需手动触发）

六、常见问题解决方案

6.1 提交历史重写

• 修改最近提交：git commit --amend（可同时修改提交信息）
• 交互式变基：git rebase -i <哈希>（重新排序/合并/删除提交）

6.2 撤销远程提交

1. 本地回退到指定版本：git reset --hard <哈希>
2. 强制推送：git push -f origin <分支名>（⚠️ 仅限个人分支使用）

6.3 权限错误处理

• SSH密钥配置：
  1. 生成密钥：ssh-keygen -t ed25519 -C "your.email@example.com"
  2. 添加到SSH代理：eval "$(ssh-agent -s)" → ssh-add ~/.ssh/id_ed25519
  3. 将公钥（~/.ssh/id_ed25519.pub）添加到Git平台

七、学习资源推荐

• 官方文档：Git Book
• 交互式学习：Learn Git Branching
• 可视化工具：GitKraken（图形化操作）

结语

掌握Git不仅是技术要求，更是开发者职业发展的必备技能。通过系统学习版本控制、分支策略和远程协作，开发者能显著提升代码管理效率，减少协作冲突。建议从基础操作开始，逐步实践高级技巧，最终形成适合自己的Git工作流。