电影蓝皮书电影蓝皮书
首页文章电影合集文档

© 2026 电影蓝皮书

联系方式: moviebluebook@gmail.com

文章电影合集成为贡献者
Movie Bluebook · 电影蓝皮书
TRAE Work文档
  • TRAE Work 概述
  • 快速开始
    • TRAE Work 网页版与桌面版快速开始
    • TRAE Work 移动版快速开始
  • 最佳实践
    • TRAE Work 必装的的 14 个 Skill
  • 云端运行环境
  • 模型
  • 上下文
    • 技能
    • 规则
    • 模型上下文协议(MCP)
      • MCP概述
      • 添加 MCP Server
    • 命令
    • 内置工作流:Spec & Plan
  • 外部应用授权
    • GitHub
    • 飞书 / Lark
  • 工作树
  • 自动化
  • 语音讨论
  • 沙箱
  • 对话流设置
  • 隐私模式
  • 问题排查
  • 联系我们
  • 相关协议
    • 云端智能体的数据存储策略
    • TRAE Work 桌面版开源软件声明
  • 更新日志
阅读进度58%

工作树

2026-06-17·西山懒懒翁·9 次浏览

工作树(Worktree)功能可以让不同的任务在相互隔离的 Git 环境中执行。当你需要在同一个项目中并行处理多个任务(例如,在一个任务中开发新功能,同时在另一个任务中修复紧急漏洞)并希望避免代码冲突时,此功能是理想之选。

它为每个任务创建一个独立的目录,其中包含专属的文件、依赖项和代码变更,从而确保你的主工作目录保持整洁且不受干扰。

名词解释

名词描述
工作树Git 的一项原生机制,允许单个代码仓库同时拥有多个独立的工作目录,每个目录可以检出不同的分支。
工作树分支某个工作树当前检出的 Git 分支。它决定了这个工作树目录里显示的是哪条分支的代码,例如 feat-pet-shop-1sfbnt。
工作树目录与某个工作树关联的本地文件夹路径,即你在文件系统中能看到的、存放实际代码的目录。在 TRAE Work 中,此目录的名称与对应的工作树分支名称一致,格式为 /{worktree_branch_name}。

适用范围

此功能仅适用于在本地环境中运行的任务。

前置条件

确保你已在本地安装 Git。

创建工作树

发起任务前,在对话输入框左下角,将模式设置为 。

任务启动后,智能体将为此任务自动创建一个专属的工作树分支和对应的工作树目录。你可以在对话输入框顶部看到带工作树标记的新分支。

合并代码

当智能体在工作树中完成编码后,你可以将代码合并到主分支或其他目标分支。操作方式如下:

  • AI 自动合并:在对话框顶部的工作树分支栏中,点击 按钮。AI 将自动分析代码变更、解决冲突并完成合并。
  • 手动合并:在对话框顶部的工作树分支栏中,点击 ··· 并选择 选项,然后按照界面指引操作。若出现冲突,你需要先点击 按钮解决冲突,再继续该流程。

代码合并后,对话流底部将显示一条带有 “代码已合并“ 文案的分割线。请注意,由分割线上方的对话所产生的内容无法回退。

查看工作树的磁盘占用

你可以随时查看各工作树占用的本地磁盘空间。

  1. 前往 设置 > 。
  2. 在 区域,查看所有项目下各个工作树的磁盘空间占用。

清理工作树

清理工作树会将其对应的本地目录(工作树目录)彻底清除以释放磁盘空间,但该任务的对话历史和代码变更记录将被保留。此外,你可以选择是否保留该工作树的 Git 分支。

清理工作树的方式如下:

  • 方式一:从任务列表中清理
  1. 在左侧任务栏中,将鼠标悬停在目标任务上。
  2. 点击出现的 ··· 图标,然后选择 。
  3. 在弹窗中,根据需要勾选 选框,然后点击 按钮。
  • 方式二:从设置中心清理
  1. 前往 设置 > 。
  2. 在 区域,从列表中选择需要删除的工作树。
  3. 点击右下角的 按钮。
  4. 在弹窗中,根据需要勾选 选框,然后点击 按钮。
  • 方式三:从工作树分支栏中清理
  1. 在对话框顶部的工作树分支栏中,点击 ··· 图标,然后选择 。若代码合并已完成,分支栏将直接显示 按钮。
  2. 在弹窗中,根据需要勾选 选框,然后点击 按钮。

清理工作树时,如果你选择保留其 Git 分支,系统将只删除本地的工作树目录,而分支本身会保留下来。之后,你仍然可以前往 设置 > ,在 区域找到并彻底清理该分支。

相关设置

前往 设置 > ,在 区域,按需进行以下设

上一篇·飞书 / Lark下一篇·自动化