mirror of
https://github.com/8butubb/8butubb.github.io.git
synced 2026-10-12 08:10:02 +08:00
update hugo config and update posts
This commit is contained in:
@@ -0,0 +1,570 @@
|
||||
---
|
||||
title: Git 完整教程指南
|
||||
tags: ["git", "版本控制", "教程"]
|
||||
date: 2025-10-08
|
||||
summary: "从零开始学习 Git 版本控制系统，包含基础概念、常用命令、分支管理、协作流程等完整内容。"
|
||||
---
|
||||
|
||||
> 本教程适用于 Git 初学者到进阶用户，涵盖日常开发中 90% 的使用场景。
|
||||
|
||||
## 什么是 Git
|
||||
|
||||
Git 是一个分布式版本控制系统，用于跟踪文件的修改历史。与集中式版本控制系统（如 SVN）不同，Git 的每个工作副本都是完整的仓库，包含项目的完整历史记录。
|
||||
|
||||
### Git 的核心概念
|
||||
|
||||
- **仓库（Repository）**: 项目的版本控制中心，包含所有文件的历史记录。
|
||||
- **工作目录（Working Directory）**: 你在本地进行修改的文件所在目录。
|
||||
- **暂存区（Staging Area）**: 一个中间区域，用于暂存你要提交的文件变更。
|
||||
- **本地仓库（Local Repository）**: 你在本地计算机上的仓库，包含完整的历史记录。
|
||||
- **远程仓库（Remote Repository）**: 托管在服务器上的仓库，用于与团队成员共享代码。
|
||||
|
||||
### Git 工作流程
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
subgraph "Git 工作区域"
|
||||
A[工作目录<br/>Working Directory]
|
||||
B[暂存区<br/>Staging Area]
|
||||
C[本地仓库<br/>Local Repository]
|
||||
D[远程仓库<br/>Remote Repository]
|
||||
end
|
||||
|
||||
A -->|git add| B
|
||||
B -->|git commit| C
|
||||
C -->|git push| D
|
||||
D -->|git pull| C
|
||||
C -->|git checkout| A
|
||||
|
||||
style A fill:#e3f2fd
|
||||
style B fill:#f3e5f5
|
||||
style C fill:#e8f5e9
|
||||
style D fill:#fff3e0
|
||||
```
|
||||
|
||||
## Git 安装与配置
|
||||
|
||||
### 安装 Git
|
||||
|
||||
**Windows**: 下载并安装 [Git for Windows](https://git-scm.com/download/win)
|
||||
|
||||
**macOS**:
|
||||
```bash
|
||||
# 使用 Homebrew
|
||||
brew install git
|
||||
|
||||
# 或者下载安装包
|
||||
# https://git-scm.com/download/mac
|
||||
```
|
||||
|
||||
**Linux (Ubuntu/Debian)**:
|
||||
```bash
|
||||
sudo apt update
|
||||
sudo apt install git
|
||||
```
|
||||
|
||||
**Linux (CentOS/RHEL)**:
|
||||
```bash
|
||||
sudo yum install git
|
||||
```
|
||||
|
||||
### 基础配置
|
||||
|
||||
```bash
|
||||
# 配置用户信息（必须）
|
||||
git config --global user.name "你的名字"
|
||||
git config --global user.email "[email protected]"
|
||||
|
||||
# 配置默认分支名（推荐）
|
||||
git config --global init.defaultBranch main
|
||||
|
||||
# 配置文本编辑器（可选）
|
||||
git config --global core.editor vim
|
||||
|
||||
# 查看配置
|
||||
git config --list
|
||||
```
|
||||
|
||||
## Git 基础操作
|
||||
|
||||
### 初始化仓库
|
||||
|
||||
```bash
|
||||
# 在当前目录初始化 Git 仓库
|
||||
git init
|
||||
|
||||
# 克隆远程仓库
|
||||
git clone https://github.com/username/repository.git
|
||||
|
||||
# 克隆并指定目录名
|
||||
git clone https://github.com/username/repository.git my-project
|
||||
```
|
||||
|
||||
### 文件状态管理
|
||||
|
||||
```bash
|
||||
# 查看文件状态
|
||||
git status
|
||||
|
||||
# 添加文件到暂存区
|
||||
git add filename.txt
|
||||
git add . # 添加所有文件
|
||||
git add -A # 添加所有变更（包括删除）
|
||||
|
||||
# 从暂存区移除文件
|
||||
git reset filename.txt
|
||||
|
||||
# 提交变更
|
||||
git commit -m "提交信息"
|
||||
git commit -m "标题" -m "详细描述"
|
||||
|
||||
# 跳过暂存区直接提交
|
||||
git commit -am "提交信息"
|
||||
```
|
||||
|
||||
### 查看历史
|
||||
|
||||
```bash
|
||||
# 查看提交历史
|
||||
git log
|
||||
|
||||
# 简洁查看
|
||||
git log --oneline
|
||||
|
||||
# 查看最近5次提交
|
||||
git log -5
|
||||
|
||||
# 查看文件修改历史
|
||||
git log --follow filename.txt
|
||||
|
||||
# 查看每次提交的差异
|
||||
git log -p
|
||||
|
||||
# 查看统计信息
|
||||
git log --stat
|
||||
```
|
||||
|
||||
### 撤销操作
|
||||
|
||||
```bash
|
||||
# 撤销工作区的修改
|
||||
git checkout -- filename.txt
|
||||
|
||||
# 撤销暂存区的文件
|
||||
git reset HEAD filename.txt
|
||||
|
||||
# 修改最后一次提交
|
||||
git commit --amend -m "新的提交信息"
|
||||
|
||||
# 回退到指定版本
|
||||
git reset --hard commit-hash
|
||||
|
||||
# 软回退（保留修改）
|
||||
git reset --soft commit-hash
|
||||
```
|
||||
|
||||
## 分支管理
|
||||
|
||||
### 分支概念
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
A[main分支] --> B[创建feature分支]
|
||||
B --> C[开发新功能]
|
||||
C --> D[合并回main]
|
||||
A --> E[创建hotfix分支]
|
||||
E --> F[修复bug]
|
||||
F --> D
|
||||
|
||||
style A fill:#4caf50
|
||||
style B fill:#2196f3
|
||||
style C fill:#2196f3
|
||||
style D fill:#4caf50
|
||||
style E fill:#ff9800
|
||||
style F fill:#ff9800
|
||||
```
|
||||
|
||||
### 分支操作
|
||||
|
||||
```bash
|
||||
# 查看分支
|
||||
git branch # 本地分支
|
||||
git branch -r # 远程分支
|
||||
git branch -a # 所有分支
|
||||
|
||||
# 创建分支
|
||||
git branch feature-login
|
||||
git checkout -b feature-login # 创建并切换
|
||||
|
||||
# 切换分支
|
||||
git checkout main
|
||||
git switch main # Git 2.23+ 新命令
|
||||
|
||||
# 合并分支
|
||||
git merge feature-login
|
||||
|
||||
# 删除分支
|
||||
git branch -d feature-login # 安全删除
|
||||
git branch -D feature-login # 强制删除
|
||||
|
||||
# 重命名分支
|
||||
git branch -m old-name new-name
|
||||
```
|
||||
|
||||
### 解决冲突
|
||||
|
||||
当合并分支时出现冲突：
|
||||
|
||||
```bash
|
||||
# 1. 查看冲突文件
|
||||
git status
|
||||
|
||||
# 2. 手动编辑冲突文件
|
||||
# 删除冲突标记，保留需要的代码
|
||||
|
||||
# 3. 标记冲突已解决
|
||||
git add filename.txt
|
||||
|
||||
# 4. 完成合并
|
||||
git commit
|
||||
```
|
||||
|
||||
## 远程仓库操作
|
||||
|
||||
### 连接远程仓库
|
||||
|
||||
```bash
|
||||
# 添加远程仓库
|
||||
git remote add origin https://github.com/username/repository.git
|
||||
|
||||
# 查看远程仓库
|
||||
git remote -v
|
||||
|
||||
# 重命名远程仓库
|
||||
git remote rename origin github
|
||||
|
||||
# 删除远程仓库
|
||||
git remote remove origin
|
||||
```
|
||||
|
||||
### 推送与拉取
|
||||
|
||||
```bash
|
||||
# 推送到远程仓库
|
||||
git push origin main
|
||||
|
||||
# 首次推送（设置上游分支）
|
||||
git push -u origin main
|
||||
|
||||
# 强制推送（谨慎使用）
|
||||
git push -f origin main
|
||||
|
||||
# 拉取更新
|
||||
git pull origin main
|
||||
|
||||
# 获取更新但不合并
|
||||
git fetch origin
|
||||
```
|
||||
|
||||
### 标签管理
|
||||
|
||||
```bash
|
||||
# 创建标签
|
||||
git tag v1.0.0
|
||||
git tag -a v1.0.0 -m "版本说明"
|
||||
|
||||
# 查看标签
|
||||
git tag
|
||||
|
||||
# 推送标签
|
||||
git push origin v1.0.0
|
||||
git push origin --tags
|
||||
|
||||
# 删除标签
|
||||
git tag -d v1.0.0
|
||||
git push origin --delete v1.0.0
|
||||
```
|
||||
|
||||
## 高级功能
|
||||
|
||||
### Stash（暂存）
|
||||
|
||||
```bash
|
||||
# 保存当前工作进度
|
||||
git stash
|
||||
|
||||
# 查看保存的进度
|
||||
git stash list
|
||||
|
||||
# 恢复最近保存的进度
|
||||
git stash pop
|
||||
|
||||
# 恢复指定的进度
|
||||
git stash apply stash@{1}
|
||||
|
||||
# 删除保存的进度
|
||||
git stash drop stash@{0}
|
||||
```
|
||||
|
||||
### Cherry-pick
|
||||
|
||||
```bash
|
||||
# 选择性地合并某个提交
|
||||
git cherry-pick commit-hash
|
||||
|
||||
# 合并多个提交
|
||||
git cherry-pick commit1 commit2
|
||||
|
||||
# 继续合并（解决冲突后）
|
||||
git cherry-pick --continue
|
||||
```
|
||||
|
||||
### Rebase
|
||||
|
||||
```bash
|
||||
# 交互式 rebase
|
||||
git rebase -i HEAD~3
|
||||
|
||||
# 继续 rebase
|
||||
git rebase --continue
|
||||
|
||||
# 中止 rebase
|
||||
git rebase --abort
|
||||
|
||||
# 跳过当前提交
|
||||
git rebase --skip
|
||||
```
|
||||
|
||||
### 子模块
|
||||
|
||||
```bash
|
||||
# 添加子模块
|
||||
git submodule add https://github.com/user/repo.git path/to/submodule
|
||||
|
||||
# 初始化子模块
|
||||
git submodule init
|
||||
|
||||
# 更新子模块
|
||||
git submodule update
|
||||
|
||||
# 递归更新
|
||||
git submodule update --recursive --remote
|
||||
```
|
||||
|
||||
## Git 工作流程
|
||||
|
||||
### Git Flow 工作流
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
A[main] --> B[develop]
|
||||
B --> C[feature/feature-1]
|
||||
B --> D[feature/feature-2]
|
||||
C --> B
|
||||
D --> B
|
||||
B --> E[release/v1.0]
|
||||
E --> A
|
||||
E --> F[hotfix/fix-1]
|
||||
F --> A
|
||||
F --> B
|
||||
|
||||
style A fill:#4caf50
|
||||
style B fill:#2196f3
|
||||
style C fill:#9c27b0
|
||||
style D fill:#9c27b0
|
||||
style E fill:#ff9800
|
||||
style F fill:#f44336
|
||||
```
|
||||
|
||||
### GitHub Flow
|
||||
|
||||
1. **创建分支**：从 main 分支创建功能分支
|
||||
2. **提交修改**：在功能分支上进行开发
|
||||
3. **创建 Pull Request**：提交代码审查
|
||||
4. **代码审查**：团队成员进行代码审查
|
||||
5. **合并分支**：审查通过后合并到 main 分支
|
||||
6. **部署**：自动或手动部署到生产环境
|
||||
|
||||
### GitLab Flow
|
||||
|
||||
结合 Git Flow 和 GitHub Flow 的优点，支持多环境部署。
|
||||
|
||||
## 实用技巧
|
||||
|
||||
### 配置别名
|
||||
|
||||
```bash
|
||||
# 配置常用别名
|
||||
git config --global alias.st status
|
||||
git config --global alias.co checkout
|
||||
git config --global alias.br branch
|
||||
git config --global alias.ci commit
|
||||
git config --global alias.unstage 'reset HEAD --'
|
||||
git config --global alias.last 'log -1 HEAD'
|
||||
git config --global alias.visual '!gitk'
|
||||
```
|
||||
|
||||
### 忽略文件
|
||||
|
||||
创建 `.gitignore` 文件：
|
||||
|
||||
```
|
||||
# 忽略所有 .log 文件
|
||||
*.log
|
||||
|
||||
# 忽略 node_modules 目录
|
||||
node_modules/
|
||||
|
||||
# 忽略 IDE 配置文件
|
||||
.vscode/
|
||||
.idea/
|
||||
|
||||
# 忽略操作系统文件
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
|
||||
# 忽略编译输出
|
||||
dist/
|
||||
build/
|
||||
*.exe
|
||||
*.dll
|
||||
```
|
||||
|
||||
### 查看文件差异
|
||||
|
||||
```bash
|
||||
# 查看工作区与暂存区的差异
|
||||
git diff
|
||||
|
||||
# 查看暂存区与仓库的差异
|
||||
git diff --staged
|
||||
|
||||
# 查看两个提交的差异
|
||||
git diff commit1 commit2
|
||||
|
||||
# 查看文件的历史修改
|
||||
git log -p filename.txt
|
||||
```
|
||||
|
||||
### 统计信息
|
||||
|
||||
```bash
|
||||
# 查看提交统计
|
||||
git shortlog -sn
|
||||
|
||||
# 查看代码行数统计
|
||||
git log --stat
|
||||
|
||||
# 查看贡献者
|
||||
git log --pretty=format:"%an" | sort | uniq -c | sort -nr
|
||||
```
|
||||
|
||||
## 常见问题解决
|
||||
|
||||
### 误提交大文件
|
||||
|
||||
```bash
|
||||
# 从仓库中删除大文件
|
||||
git filter-branch --force --index-filter \
|
||||
'git rm --cached --ignore-unmatch path/to/large-file' \
|
||||
--prune-empty --tag-name-filter cat -- --all
|
||||
|
||||
# 清理和垃圾回收
|
||||
git reflog expire --expire=now --all
|
||||
git gc --prune=now --aggressive
|
||||
```
|
||||
|
||||
### 修改历史提交信息
|
||||
|
||||
```bash
|
||||
# 修改最近一次提交
|
||||
git commit --amend
|
||||
|
||||
# 修改历史提交（交互式）
|
||||
git rebase -i HEAD~3
|
||||
```
|
||||
|
||||
### 找回丢失的提交
|
||||
|
||||
```bash
|
||||
# 查看引用日志
|
||||
git reflog
|
||||
|
||||
# 恢复到某个状态
|
||||
git reset --hard HEAD@{1}
|
||||
```
|
||||
|
||||
### 子模块问题
|
||||
|
||||
```bash
|
||||
# 更新子模块
|
||||
git submodule update --init --recursive
|
||||
|
||||
# 克隆包含子模块的仓库
|
||||
git clone --recursive https://github.com/user/repo.git
|
||||
```
|
||||
|
||||
## 最佳实践
|
||||
|
||||
### 提交信息规范
|
||||
|
||||
```
|
||||
类型(范围): 简短描述
|
||||
|
||||
详细描述（可选）
|
||||
|
||||
Fixes #123
|
||||
```
|
||||
|
||||
**类型说明**：
|
||||
- `feat`: 新功能
|
||||
- `fix`: 修复bug
|
||||
- `docs`: 文档更新
|
||||
- `style`: 代码格式调整
|
||||
- `refactor`: 代码重构
|
||||
- `test`: 测试相关
|
||||
- `chore`: 构建过程或辅助工具的变动
|
||||
|
||||
### 分支命名规范
|
||||
|
||||
- `feature/功能名称`：新功能开发
|
||||
- `bugfix/bug描述`：bug修复
|
||||
- `hotfix/紧急修复`：紧急修复
|
||||
- `release/版本号`：发布准备
|
||||
- `test/测试名称`：测试相关
|
||||
|
||||
### 工作流程建议
|
||||
|
||||
1. **频繁提交**：小而频繁的提交比大而少的提交更好
|
||||
2. **明确提交信息**：写清楚提交的目的和内容
|
||||
3. **及时拉取**：开始工作前拉取最新代码
|
||||
4. **使用分支**：不要在主分支上直接开发
|
||||
5. **代码审查**：提交前进行自我审查
|
||||
6. **保持同步**：定期与远程仓库同步
|
||||
|
||||
## 学习资源
|
||||
|
||||
### 官方资源
|
||||
- [Git 官方文档](https://git-scm.com/doc)
|
||||
- [Pro Git 书籍](https://git-scm.com/book/zh/v2)
|
||||
- [GitHub Guides](https://guides.github.com/)
|
||||
|
||||
### 交互式学习
|
||||
- [Learn Git Branching](https://learngitbranching.js.org/)
|
||||
- [GitHub Learning Lab](https://lab.github.com/)
|
||||
- [Git 小游戏](https://onlywei.github.io/explain-git-with-d3/)
|
||||
|
||||
### 可视化工具
|
||||
- [GitKraken](https://www.gitkraken.com/)
|
||||
- [SourceTree](https://www.sourcetreeapp.com/)
|
||||
- [GitHub Desktop](https://desktop.github.com/)
|
||||
|
||||
## 总结
|
||||
|
||||
Git 是现代软件开发中不可或缺的工具。掌握 Git 不仅能够提高开发效率，还能更好地与团队协作。本教程涵盖了 Git 的核心概念和常用操作，建议通过实践来加深理解。
|
||||
|
||||
记住 Git 的学习曲线可能有些陡峭，但一旦掌握，它将成为你开发工具箱中最强大的工具之一。持续练习，遇到问题不要害怕，Git 的强大功能值得你投入时间学习。
|
||||
|
||||
---
|
||||
|
||||
> 💡 **提示**：Git 命令很多，不需要全部记住。常用的命令熟练掌握即可，其他的可以按需查询。建议收藏本教程作为参考手册。
|
||||
Reference in New Issue
Block a user