RustRover 2026.1 Help

使用 Git 工作树

一个标准的 Git 仓库通常只使用一个工作区。 要在此设置下切换分支,需先 提交贮藏未完成的工作。 Git 工作树允许你同时在不同目录中检出多个分支,所有这些分支都与同一个 .git 目录关联。

什么是 Git 工作树?

Git 工作树允许你在同一个仓库的多个分支上,同时在不同目录中检出。 使用 Git 工作树的常见用例包括:

  • AI 驱动的开发:在不同的工作树中运行 AI 代理,以防止其覆盖本地未保存的更改。

  • 紧急错误修复:在单独目录下修复关键问题,而不影响你当前的进度。

  • 并行代码审查:本地检出和测试拉取请求与合并请求,无需干扰现有环境、数据库状态或构建工件。

  • 长时任务:在一个工作树中执行大型测试套件或复杂构建,同时在另一个工作树中继续编码。

  • 多分支上下文切换:无需贮藏更改,也无需在切换分支后等待大量文件重新索引,便可管理多个长期运行的分支。

Git 工作树是你的项目的链接副本。 与 git clone 不同,后者会创建仓库的完整副本,而所有工作树则共享同一个中央 .git 历史。

当你创建工作树时,Git 会为你的文件生成一个新目录。 此目录不是完整的 .git 文件夹,而是包含一个包含纯文本路径并指向原始仓库的 .git 文件。 这样可以确保所有工作树保持同步,同时保持独立的工作环境。

主工作树中的 Git 文件夹和链接工作树中的 Git 文件

有关 Git 工作树的更多信息,请参阅 官方 Git 文档

创建和管理 Git 工作树

如果项目已有多个 Git 工作树,则 工作树 选项卡会默认显示。 否则,可在 Git 工具窗口 Alt+9 中,通过点击 下移按钮 并选择 工作树 来打开。

Git 工具窗口,其中包含打开工作树选项卡的选项

创建 Git 工作树

  1. Git 工具窗口 Alt+9 中,打开 工作树 选项卡并点击 新建工作树

    或者,在主菜单中选择 Git | 新建工作树

    这将打开 新建工作树 对话框。

    新建工作树对话框
  2. 新建工作树 对话框中,指定以下内容:

    • 从分支 :选择源分支。

      请注意,不能在两个工作树中同时检出同一分支。 如果你希望使用当前检出的分支作为新工作树的源分支,可以基于其创建另一个本地分支,并在新工作树中使用该分支。 为此,请选择 新建分支 选项。

    • 项目名称 :新建工作树的名称。

    • 位置 :存储工作树的目录。

      避免嵌套工作树:不建议在当前项目目录(如 Projects/mainProject/linkedWorktree )内创建工作树。 当前,RustRover 会将此类项目误识别为多根项目,从而导致工作树集成异常。

创建新工作树后,RustRover 会将其作为单独的项目打开。

在不同工作树之间切换

首次打开工作树后,其行为与其他项目相同。 你可以在主菜单的 最近的项目 中,或在工具栏窗口标题的项目微件中找到它。

要切换到某个工作树(包括在 RustRover 之外创建的工作树),请执行以下操作:

  1. Git 工具窗口 Alt+9 中,打开 工作树 选项卡。

    或者,在主菜单中选择 Git | 工作树

  2. 双击目标工作树。

    Git 工具窗口中的工作树选项卡,含多个工作树

    根据系统设置,工作树会在新窗口或现有窗口打开。

删除工作树

在删除工作树前,请确保你已提交所有更改。

  1. Git 工具窗口 Alt+9 中,打开 工作树 选项卡。

    或者,在主菜单中选择 Git | 工作树

  2. 选择工作树并点击 Delete

请注意,无法删除主工作树或当前已打开的工作树。

2026年 3月 25日