Git Worktree 详解：高效管理多分支的方案
在日常 Git 开发中，你是否遇到过这些痛点：开发新功能时需要临时修复线上 bug，切换分支会打乱当前工作区的修改；需要同时查看多个分支的代码对比，反复克隆仓库浪费磁盘空间；多分支并行开发，频繁 checkout 导致文件切换繁琐。
Git 从 2.5 版本（2015 年发布）开始提供了 git worktree 功能，有效解决了上述问题。它允许一个 Git 仓库关联多个工作区，每个工作区对应不同的分支，所有工作区共享同一个仓库的提交记录、分支、标签等元数据，既节省空间，又能实现多分支的无干扰并行开发。
本文将从核心概念、基本使用、高级用法、注意事项、最佳实践五个维度，全面讲解 git worktree，帮助你掌握这个高效的 Git 工具。
一、核心概念
在使用 git worktree 前，先理清两个核心概念，避免理解混淆：
1. 主工作区（Main Working Tree）
就是你最初通过 git clone 创建的仓库目录，也是 Git 仓库的主目录，包含完整的 .git 目录（仓库的核心元数据，存储所有提交、分支、标签等信息）。
2. 链接工作区（Linked Working Tree）
通过 git worktree add 创建的额外工作区，是轻量级的目录，内部没有完整的 .git 目录，只有一个 .git 纯文本文件，内容是指向主工作区 .git 目录的路径（如 gitdir: /Users/xxx/project/.git），表示该工作区关联的主仓库位置。
核心特性
- 所有工作区共享同一个 Git 仓库（主工作区的
.git），分支、提交、推送/拉取操作在任意工作区执行都互通； - 每个工作区独立对应一个分支，工作区的文件修改、暂存、提交互不干扰；
- 链接工作区是轻量级的，仅存储当前分支的文件，无需重复克隆仓库，大幅节省磁盘空间。
二、前置条件
- 主仓库要求：必须是一个完整的 Git 仓库（包含
.git目录），裸仓库（--bare）无法创建工作区。
Git 版本要求：必须是 Git 2.5 及以上版本，可通过以下命令检查版本：
git --version
若版本过低，可通过官网或包管理器升级（如 brew install git、yum install git -y）。
三、基本使用
git worktree 的核心命令仅有几个，add/ls/remove 是日常使用频率最高的，先掌握这三个基础命令，就能满足 90% 的使用场景。
3.1 查看所有工作区
查看当前 Git 仓库关联的所有工作区（包括主工作区和链接工作区），显示工作区路径、对应分支、提交哈希：
# 简写形式
git worktree list
# 详细形式（显示更多元数据，如锁定状态）
git worktree ls
：
