turborepo 如何解决git管理包过大的问题
在 Turborepo 中管理大型 Monorepo 时，Git 仓库过大会导致克隆慢、操作卡顿等问题。以下是针对性的解决方案和最佳实践：
1. 优化 Git 历史（治本）
移除历史大文件
# 使用 BFG 工具清理历史大文件（比 git-filter-repo 更简单）
bfg --delete-files '*.zip' --no-blob-protection your-repo.git
bfg --delete-folders 'dist' --no-blob-protection your-repo.git# 或使用 git-filter-repo（官方推荐）
git filter-repo --path-glob '*.log' --invert-paths
分割大仓库
- 将非核心工具/文档拆分为独立仓库，用
git submodule或npm引用。 - 使用
lerna import或splitsh-lite工具迁移子目录历史。
2. 减少工作区体积（治标）
.gitignore 严格过滤
# 忽略所有 node_modules
**/node_modules/# 忽略构建产物
dist/
build/
*.log
pnpm 优化存储
# pnpm 设置共享 store (减少重复依赖)
pnpm config set store-dir ~/.pnpm-store
3. 高效克隆/拉取
浅克隆（Shallow Clone）
git clone --depth=1 https://github.com/your/repo.git
稀疏检出（Sparse Checkout）
git init your-repo
cd your-repo
git remote add origin https://github.com/your/repo.git
git config core.sparseCheckout true
echo "packages/frontend/*" >> .git/info/sparse-checkout
git pull origin main
4. 利用 Turborepo 缓存
跳过未变更构建
# turbo.json 配置
{"pipeline": {"build": {"outputs": ["dist/**"],"cache": true # 开启缓存}}
}
- 运行
turbo run build --filter=...[since main]仅构建修改过的包。
5. 存档历史大文件
- 使用 Git LFS (Large File Storage) 管理二进制文件：
git lfs install git lfs track "*.psd" git add .gitattributes
6. 自动化清理
定期清理本地仓库
# 删除历史松散对象
git gc --aggressive --prune=now# 重置 .git 指针 (危险操作！)
git reflog expire --expire=now --all
git gc --prune=now
7. 架构优化
| 策略 | 适用场景 |
|---|---|
| 拆分独立仓库 + Submodule | 低频变更的共享库（如设计系统） |
| 保留核心代码 + 归档旧项目 | 历史项目不再维护时 |
| 微前端独立部署 | 前端应用按业务拆分仓库 |
验证效果
# 查看仓库体积
git count-objects -vH# 分析大文件
git rev-list --objects --all \| git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' \| awk '/^blob/ {print substr($0,6)}' \| sort --numeric-sort --key=2 \| cut -c 1-12,41- \| $(command -v gnumfmt || echo numfmt) --field=2 --to=iec-i --suffix=B --padding=7 --round=nearest