使用 Git 工作树
标准 Git 仓库通常只使用一个工作树。 在此设置下切换分支时,您必须先 提交或 储藏未完成的工作。 Git 工作树允许您在不同目录下同时检出多个分支,并且都关联到同一个 .git 目录。
什么是 Git 工作树?
Git 工作树允许您在同一个仓库的多个分支上,同时在不同的目录中检出。 使用 Git 工作树的常见用例如下:
AI 驱动开发:在独立工作树中运行 AI 代理,以防止其覆盖本地未保存的更改。
紧急漏洞修复:在独立目录中处理关键问题,不会打断当前的进度。
并行代码审查:在本地检出和测试拉取及合并请求,而不影响现有环境、数据库状态或构建产物。
长时间运行的任务:在一个工作树中执行大量测试套件或复杂构建,同时在另一个工作树中继续编写代码。
多分支环境切换:无需储藏更改,或者等待切换分支后大量文件的重新索引,即可管理多个长期分支。
Git 工作树是您的项目的一个关联副本。 与 git clone 不同,后者会创建仓库的完整副本,而所有工作树共享同一个中心 .git 历史记录。
创建工作树时,Git 会为您的文件生成一个新目录。 该目录不是完整的 .git 文件夹,而是包含一个 .git 文件,文件中的纯文本路径指向原始仓库。 这样可以保证所有工作树保持同步,同时又能维持各自独立的工作环境。

有关 Git 工作树的更多信息,请参阅 官方 Git 文档。
创建和管理 Git 工作树
如果项目已包含多个 Git 工作树,则默认会显示 工作树 选项卡。 否则,可以在 Git 工具窗口 Alt+9 中,通过点击 并选择 工作树 来打开。

创建 Git 工作树
在 Git 工具窗口 Alt+9 中,打开 工作树 选项卡,然后点击
新建工作树。
或者,在主菜单中选择 。
这会打开 新建工作树 对话框。

在 新建工作树 对话框中,指定以下内容:
从分支 :选择源分支。
请注意,不能同时在两个工作树中检出同一个分支。 如果您想将当前检出的分支用作新工作树的来源,可以从该分支创建另一个本地分支,并在新工作树中使用。 为此,请选择 新建分支 选项。
项目名称 :新工作树的名称。
位置 :存放工作树的目录。
避免嵌套工作树:不建议在当前项目的目录下创建工作树(例如
Projects/mainProject/linkedWorktree)。 当前,IntelliJ IDEA 会将此类项目误识别为多根项目,从而导致工作树集成失效。
创建新工作树后,IntelliJ IDEA 会将其作为单独的项目打开。
在不同工作树之间切换
首次打开工作树后,其行为与其他项目一样。 您可以在主菜单的 最近的项目 中,或在窗口标头工具栏的项目微件中找到它。
若要切换到某一工作树,包括在 IntelliJ IDEA 外部创建的工作树,请执行以下操作:
在 Git 工具窗口 Alt+9 中,打开 工作树 选项卡。
或者,在主菜单中选择 。
双击目标工作树。

工作树将根据系统设置在新窗口或现有窗口中打开。
删除工作树
在删除工作树前,请确保已提交所有更改。
在 Git 工具窗口 Alt+9 中,打开 工作树 选项卡。
或者,在主菜单中选择 。
选择工作树并点击
删除。
请注意,不能删除主工作树或当前打开的工作树。