7.6 KiB
7.6 KiB
Git 高级用法
标签管理
版本号规范
采用 语义化版本（Semantic Versioning）：
主版本号.次版本号.修订号[-预发布标识]
MAJOR.MINOR.PATCH[-PRERELEASE]
| 版本变化 | 说明 | 示例 |
|---|---|---|
| 主版本号 | 不兼容的 API 修改 | v1.0.0 → v2.0.0 |
| 次版本号 | 向下兼容的功能新增 | v1.0.0 → v1.1.0 |
| 修订号 | 向下兼容的问题修正 | v1.0.0 → v1.0.1 |
预发布标识
alpha- 内测版本beta- 公测版本rc- 候选版本
v1.0.0-alpha.1 # 第一个内测版本
v1.0.0-beta.1 # 第一个公测版本
v1.0.0-rc.1 # 第一个候选版本
v1.0.0 # 正式版本
标签操作
创建附注标签（推荐）
git tag -a v1.0.0 -m "release: v1.0.0 正式版本
主要更新:
- 新增用户管理模块
- 新增支付功能
- 优化查询性能"
推送标签
# 推送单个标签
git push origin v1.0.0
# 推送所有标签
git push origin --tags
查看标签
git tag
git tag -l "v1.*"
git show v1.0.0
删除标签
# 删除本地标签
git tag -d v1.0.0
# 删除远程标签
git push origin :refs/tags/v1.0.0
Git 性能优化
大型仓库优化
# 浅克隆（只获取最近的提交）
git clone --depth 1 https://github.com/repo/project.git
# 部分克隆（按需获取）
git clone --filter=blob:none https://github.com/repo/project.git
# 稀疏检出（只检出需要的目录）
git clone --filter=blob:none --sparse https://github.com/repo/project.git
cd project
git sparse-checkout init --cone
git sparse-checkout set src/frontend
清理仓库
# 查看仓库大小
git count-objects -vH
# 清理无用对象
git gc --aggressive --prune=now
# 清理远程已删除的分支引用
git remote prune origin
# 清理本地已合并的分支
git branch --merged master | grep -v "\\*\\|master\\|develop" | xargs -n 1 git branch -d
提升操作速度
# 启用文件系统缓存
git config --global core.fscache true
# 启用并行获取
git config --global fetch.parallel 4
# 启用未跟踪文件缓存
git config --global core.untrackedCache true
Git 安全规范
敏感信息保护
# 检查历史提交中的敏感信息
git log -p | grep -E "(password|secret|api_key)"
# 从历史记录中删除敏感文件
git filter-branch --force --index-filter \
'git rm --cached --ignore-unmatch config/secrets.yml' \
--prune-empty --tag-name-filter cat -- --all
# 使用 git-secrets 预防敏感信息提交
git secrets --install
git secrets --register-aws
签名验证
# 配置 GPG 签名
git config --global user.signingkey YOUR_KEY_ID
git config --global commit.gpgsign true
# 创建签名提交
git commit -S -m "feat: 签名提交"
# 验证签名
git log --show-signature
仓库权限控制
| 规则 | master | develop | feature/* |
|---|---|---|---|
| 禁止强制推送 | ✅ | ✅ | ❌ |
| 禁止删除 | ✅ | ✅ | ❌ |
| 必须 Code Review | ✅ | ✅ | ❌ |
| 必须通过 CI | ✅ | ✅ | ❌ |
| 必须签名提交 | ✅ | ❌ | ❌ |
子模块管理
添加子模块
git submodule add https://github.com/user/repo.git libs/repo
# 克隆包含子模块的项目
git clone --recurse-submodules https://github.com/user/project.git
# 初始化已有项目的子模块
git submodule init
git submodule update
更新子模块
# 更新单个子模块
cd libs/repo
git pull origin main
# 更新所有子模块
git submodule update --remote
# 提交子模块更新
cd ..
git add libs/repo
git commit -m "chore: 更新子模块版本"
删除子模块
# 删除子模块条目
git submodule deinit -f libs/repo
# 删除 .git/modules 中的缓存
rm -rf .git/modules/libs/repo
# 删除子模块目录
git rm -f libs/repo
常见问题解决
1. 修改最后一次提交
# 修改提交内容（未推送）
git add forgotten-file.ts
git commit --amend --no-edit
# 修改提交消息
git commit --amend -m "新的提交消息"
# 回滚最后一次提交，保留更改
git reset --soft HEAD~1
2. 推送被拒绝
# 先拉取再推送
git pull origin master
git push origin master
# 使用 rebase 保持历史清晰
git pull --rebase origin master
git push origin master
3. 回滚到之前版本
# 重置到指定提交（丢弃之后的提交）
git reset --hard abc123
# 创建反向提交（推荐，保留历史）
git revert abc123
4. 恢复误删的分支
# 查看操作历史
git reflog
# 恢复分支
git checkout -b feature/xxx def456
5. 合并多个提交
# 交互式 rebase（只能合并未推送的提交）
git rebase -i HEAD~5
# 在编辑器中将要合并的提交标记为 squash
6. 暂存当前工作
git stash save "工作进行中"
git stash list
git stash pop
git stash apply stash@{0}
7. 查看文件修改历史
git log -- <file> # 提交历史
git log -p -- <file> # 详细内容
git blame <file> # 每行修改人
8. 处理大文件
# 使用 Git LFS
git lfs install
git lfs track "*.zip"
git add .gitattributes
实用技巧
配置别名
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.st status
git config --global alias.lg "log --graph --oneline --all"
美化日志
# 图形化历史
git log --graph --oneline --all
# 搜索提交消息
git log --grep="用户管理"
# 搜索代码变更
git log -S"function_name"
快速操作
# 放弃所有未提交更改
git reset --hard HEAD
# 放弃某个文件更改
git checkout -- filename
# 删除未跟踪文件
git clean -fd
# 批量删除已合并分支
git branch --merged master | grep -v "\* master" | xargs -n 1 git branch -d
安全操作
# 查看将要推送的内容
git push --dry-run
# 安全的强制推送
git push --force-with-lease
# 备份分支
git branch backup-master master
查找问题提交
# 二分查找引入Bug的提交
git bisect start
git bisect bad # 标记当前有问题
git bisect good v1.0.0 # 标记某版本是好的
# Git会自动切换提交，测试后标记 good/bad
git bisect reset # 结束查找
CHANGELOG 管理
自动生成 CHANGELOG
使用 conventional-changelog 自动生成：
# 安装
pnpm install -D conventional-changelog-cli
# 生成 CHANGELOG
npx conventional-changelog -p angular -i CHANGELOG.md -s
CHANGELOG 格式
# 更新日志
## [1.2.0] - 2024-01-15
### 新增
- 新增用户导出功能 (#123)
- 新增数据备份模块
### 修复
- 修复登录验证码不刷新问题 (#456)
- 修复列表分页异常
### 变更
- 优化用户查询性能
- 调整菜单权限校验逻辑
### 移除
- 移除废弃的API接口
## [1.1.0] - 2024-01-01
...