**📌 注意：** 有关详细的 Git 2.49+ 功能（git-backfill、path-walk API、zlib-ng），请参阅 git-2-49-features.md 技能。 ## 🚨 关键指南 ### Windows 文件路径要求 **强制：在 Windows 上始终使用反斜杠作为文件路径** 在 Windows 上使用编辑或写入工具时，必须在文件路径中使用反斜杠 (`\`)，而不是正斜杠 (`/`)。 **示例：** * ❌错误：`D:/repos/project/file.tsx` * ✅ 正确：`D:\repos\project\file.tsx` 这适用于： * 编辑工具file_path参数 * 写入工具file_path参数 * Windows系统上的所有文件操作 ### 文档指南 **除非用户明确请求，否则切勿创建新的文档文件。** * **优先**：更新现有的 README.md 文件而不是创建新文档 * **存储库清洁度** ：保持存储库根目录清洁 - 仅 README.md 除非用户另有要求 * **风格**：文档应该简洁、直接和专业 - 避免人工智能生成的语气 * **用户首选项** ：仅当用户明确要求提供文档时才创建额外的 .md 文件 ** ** # Git 2025 功能 - 高级功能 ## Git 2.49（2025 年 3 月）- 最新 **主要补充：** git-backfill、path-walk API、zlib-ng 性能、改进的增量压缩。 **请参阅 git-2-49-features.md 以获取完整的覆盖范围。** ## Git 2.48-2.49 功能 ### Reftables 迁移（2.48 完成） **内容：** 新的参考存储格式取代了松散参考文件和打包参考。 **好处：** * 更快的参考操作（提高 50-80%） * 原子引用更新 * 具有许多引用的存储库具有更好的可扩展性 * Reflogs 完全可迁移（在 2.48 中完成） **迁移：** # 检查当前引用存储格式 git 配置 core.refStorage # 迁移到可引用表 git refs migrate --ref-storage=reftables # 验证迁移 git fsck --完整 git log --oneline -5 # 如果需要的话回滚（在关键操作之前） git refs migrate --ref-storage=文件 **何时使用：** * 拥有 10,000 多个参考文献的存储库 * 高频分支操作 * CI/CD 系统创建许多临时引用 * Monorepos 具有广泛的分支 ### 性能里程碑 (2.48-2.49) **Git 2.48：** * 达到无内存泄漏状态 * 长时间运行操作中稳定的内存使用 **Git 2.49：** * zlib-ng 集成：压缩速度提高 20-30% * Path-walk API：增量压缩提高 50-70% * 新的名称哈希算法可实现最佳包文件自动带来的好处： * 大型存储库克隆 * 延长变基会话 *批量操作（过滤回购、GC、重新打包） ## 稀疏结账（2.48 中增强） **内容：** 仅从存储库中签出文件的子集。 **使用案例：** * Monorepos（致力于一项服务） * 大型存储库（减少磁盘使用） * 构建系统（仅获取需要的文件） **圆锥模式（默认 - 推荐）：** # 使用稀疏结帐进行克隆 git clone --filter=blob:none --sparse cd <仓库> # 在圆锥模式下初始化稀疏结帐 git稀疏结帐初始化--cone # 添加要签出的目录 git稀疏结帐设置src / api src /共享文档 # 添加更多目录 git稀疏结帐添加测试/集成 # 查看当前模式 git 稀疏结帐列表 # 检查匹配的内容 git稀疏结帐检查规则src / api / users.ts # 禁用稀疏检出 git稀疏结帐禁用 **高级模式（非锥体模式）：** # 启用模式模式 git稀疏结帐初始化--no-cone # 添加模式（每行一个） git稀疏结帐集\ “*.md”\ “src/api/*”\ “！src/api/legacy/*” # 从文件中读取模式 git稀疏结帐集--stdin # 没有大文件的克隆 git clone --filter=blob:limit=10m # 与稀疏结帐结合 git clone --filter=blob:none --sparse cd <仓库> git稀疏结帐设置src / api # 将现有存储库转换为部分克隆 git config extensions.partialClone 原点 git config remote.origin.promisor true git fetch --filter=blob:none # 预取所有丢失的对象 git fetch --unshallow **结合部分克隆+稀疏结账：** # 最终效率：仅针对特定目录的对象 git clone --filter=blob:none --sparse cd <仓库> git稀疏结帐集--cone src / api git checkout 主要 # 结果：只有 src/api 的对象 **检查承诺对象：** # 验证部分克隆状态 git config 扩展.partialClone # 查看承诺者包文件 ls -lah .git/objects/pack/*.promisor # 强制获取特定对象 git rev-list --objects --missing=打印头 |查找“^?” ## Git 工作树 **内容：** 一个存储库中的多个工作目录。 **好处：** * 同时在多个分支上工作 * 切换前无需存储/提交 * 并行工作（编码时审查 PR） * 共享.git（一次获取更新所有） **基本操作：** # 列出工作树 git 工作树列表 # 为现有分支创建工作树 git worktree add ../project-feature 功能分支 # 使用新分支创建工作树 git worktree add -b 新功能 ../project-new-feature # 从远程分支创建工作树 git worktree add ../project-fix origin/fix-bug # 删除工作树 git worktree 删除 ../project-feature # 清理陈旧的工作树引用 git worktree 修剪 **高级模式：** # 编码时用于 PR 审查的工作树 git worktree add ../myproject-pr-123 origin/pull/123/head cd ../myproject-pr-123 # 在单独的目录中查看 PR 光盘- # 继续在主工作树中编码 # 修补程序的工作树 git worktree add --detach ../myproject-hotfix v1.2.3 cd ../myproject-hotfix # 进行修补程序 git switch -c 修补程序/安全补丁 git commit -am“修复：修补漏洞” git push -u origin 修补程序/安全补丁 # 工作树组织 mkdir -p ~/worktrees/myproject git worktree add ~/worktrees/myproject/feature-a -b feature-a git worktree add ~/worktrees/myproject/feature-b -b feature-b git worktree add ~/worktrees/myproject/pr-review origin/pull/42/head **最佳实践：** 1. **整理目录结构：** 〜/项目/ myproject/ # 主工作树 myproject-feature/ # 功能工作树 myproject-review/ # 审查工作树 2. **定期清理：** # 删除合并的工作树 git 工作树列表 | grep 功能 | while read wt 分支提交；做如果 git 分支 --merged | grep -q“$branch”；然后 git worktree 删除“$wt” 菲完成 3. **共享配置：** * .git/config 适用于所有工作树 * .git/info/exclude 适用于所有工作树 * 每个工作树都有自己的索引和HEAD ## Scalar（大型存储库工具） **内容：** 用于优化大型存储库的工具（Microsoft 开发）。 # 安装标量（Git 2.47+ 附带）标量寄存器 <路径> # 使用标量优化进行克隆标量克隆 --branch main # 自动启用： # - 稀疏结帐（圆锥模式） # - 部分克隆（blob：none） # - 多包索引 # - 提交图 # - 后台维护 # 取消注册标量注销 <路径> # 删除存储库标量删除 <路径> ## Git 回填（实验） **内容：** 用于获取部分克隆中缺失对象的后台进程。 # 获取后台缺失的斑点 git 回填 # 配置批量大小 git backfill --min-batch-size=1000 # 尊重稀疏结账模式 git backfill --稀疏 ## 性能比较 **传统克隆：** git 克隆大型仓库 # 大小：5GB，时间：10 分钟 **稀疏结帐：** git clone --sparse large-repo git稀疏结帐设置src / api # 大小：500MB，时间：3 分钟 **部分克隆：** git clone --filter=blob:none 大型仓库 # 大小：100MB，时间：1 分钟 **部分克隆+稀疏签出：** git clone --filter=blob:none --sparse large-repo git稀疏结帐设置src / api # 大小：50MB，时间：30 秒 ## 何时使用每个功能 **稀疏结帐：** * ✓ 单一仓库 * ✓ 致力于特定服务/模块 * ✓ 磁盘空间有限 * ✗ 经常需要整个代码库 **部分克隆：** * ✓ CI/CD 管道 * ✓ 大型存储库 * ✓ 良好的网络连接 * ✗ 经常离线工作 **工作树：** * ✓ 并行开发 * ✓ 工作期间公关审查 * ✓ 多分支测试 * ✗ 磁盘空间不足 **合并所有：** * ✓ 大规模单一存储库（Google 规模） * ✓ 多个同时任务 * ✓ 最小本地存储 * ✓ 快速网络连接 ## 故障排除 **稀疏结帐不起作用：** # 验证配置 git config core.sparseCheckout git config core.sparseCheckoutCone # 重新应用模式 git稀疏结帐重新申请 # 检查模式 git 稀疏结帐列表 **部分克隆中缺少对象：** # 获取特定对象 git fetch origin <提交> # 获取所有缺失的内容 git fetch --unshallow # 验证承诺者配置 git config 扩展.partialClone **工作树问题：** # 锁定工作树 git worktree 解锁 <路径> # 损坏的工作树 git worktree remove --force <路径> git worktree 修剪 # 分支已经签出 git checkout --ignore-other-worktrees <分支> ## 迁移指南 **从传统工作流程到优化工作流程：** # 1.当前的大克隆 cd 大型项目 du -sh .git # 5GB # 2. 创建优化的新克隆光盘.. git clone --filter=blob:none --sparse large-project-new cd 大型项目-新 git稀疏结帐设置src / api src /共享 # 3. 验证大小杜 -sh .git # 50MB # 4.切换工作流程 cd ../大型项目-新 # 5. 方便时删除旧克隆 rm -rf ../大型项目 ## 资源 * [Git 部分克隆文档]() * [Git Sparse-Checkout 指南]() * [Git Worktree 最佳实践]() * [标量文档]()

Git 2025 功能

包含技能