Trae基本介绍
Trae是由字节跳动发布的一款编程开发工具, 于2025年3月3日发布第一个版本,是国内首个 AI 集成开发环境(IDE,Integrated Development Environment ),它可以深度理解中文开发场景,通过自然语言对话就可以完成需求的开发。AI 高度集成于 IDE 环境之中,为你带来比 AI 插件更加流畅、准确、优质的开发体验。官网地址:https://www.trae.com.cn/home。
全称为The Real AI Engineer,每个单词取第一个字母构成Trae,翻译为真正的人工智能工程师
Trae 基于人与 AI 协作开发的理念而打造。无论是人还是 AI , Trae 让恰当的对象,在恰当的时间接管工作,确保每一段代码都是人与 AI 共创的最优结果,为你带来更加高效、优质的开发体验。它提供智能问答、代码自动补全以及基于 Agent 的 AI 自动编程能力。使用 Trae 开发项目时,你可以与 AI 灵活协作,提升开发效率,可以说是程序员的编程最佳助手,快来一起使用体验~~~~~
发布变更记录时间线如下:
完备的 IDE 功能
提供传统的 IDE 功能,包括代码编写、项目管理、插件管理、源代码管理等。
强大的 AI 助手
- 智能问答
在编写代码时,你可以随时与 AI 助手对话,获得代码解释、代码注释和错误修复等帮助。 - 实时代码建议
AI 助手能够理解当前代码并在编辑器中实时提供代码建议,提升编程效率。全面理解代码仓库,准确解决需求。Trae 可以深入理解你的代码仓库,并深度结合 IDE 内信息,更准确识别你的需求,为你提供更优质的解决方法。实时代码续写,极致提速。通过强大的上下文分析,Trae 可以实时预测和续写你的代码片段,快速无缝扩展你未完成的代码,数倍提升你的编码效率。 - 代码片段生成
通过自然语言描述你的需求,AI 助手将生成相应的代码片段,甚至能够编写项目级或跨文件的代码。 智能 AI 协作,畅享丝滑体验。你可以将 AI 生成的代码一键应用到多个模块,还可以随时调整指令,实时预览 AI 生成代码的前端效果 - 从 0 到 1 开发项目
告诉 AI 助手你想开发的程序,AI 助手将根据你的描述提供相关代码或自动创建所需文件。全新 Builder 模式,快速从 0 到 1。Builder 模式下,Trae 会自主拆解需求并自动完成多轮编码任务。从想法描述到功能实现,Trae 为你一气呵成。
目前提供了Mac版本(macOS 10.15 及以上)和Windows版本(Windows 10、11),Linux开启了预约模式,目前还没上线,如果你对Linux版本的有兴趣,可以手机号进行订阅,后面上线会通知,就可以第一时间获取。
Trae基本操作
Trae下载与安装
安装并启动Trae
官网点击下载,等待下载完成,可以不用登录
这里以mac版本为例,双击下载之后的安装包,会跳出下面的安装页面,将其拖到Aoolications等待一会即可,桌面上会出现Trae软件。
然后双击即可打开Trae,第一次打开会弹出确认页面,点击打开即可。
点击开始
选择主题和语言
选择主题,这里主要有三种颜色,大家依据自己喜欢的主题选择即可。语言选择简体中文(如果想要英文,点击下拉框选择英文即可),然后点击继续
从 VS Code 或 Cursor 中导入配置
如果你想将之前在其他的IDE中配置过一些插件,设置以及快捷键等信息同步到Trae,在这里选择即可(目前只支持VS Code和Cursor),如果没有或者不需要,点击跳过即可
添加 Trae 相关的命令行
如果想要在命令中使用Trae,这里点击安装命令,否则跳过
然后到最后一步,就可以开始使用,如果你想要更好的体验,可以登录账号(没有需要先注册),也可以直接跳过
之后会进入开发页面
登录账号
可以看到,右边的区域需要登录才可以使用,所以建议大家还是登录。手机号验证码登录(会自动注册)或者掘金账号登号,选择自己的登录方式登录即可。
登录之后就可以使用对话能力了。
Trae使用
项目构建
开始使用Trae,在 Trae 中开发你的项目,可以通过以下三种方式构建项目:
打开文件夹:打开已有的本地项目
克隆Git仓库:从github代码库中克隆代码仓库
新建文件:新建一个文件,使用AI助手(借助Builder模式)从0到1创建一个新项目
另外导入项目的时候会有是否信任的弹窗,点击信任文件并继续即可
项目使用
项目创建好之后,就可以开始使用项目。目前有两种模式。
Chat模式
基本使用
进入 Trae 后,一般默认进入 Chat 模式。Chat 模式是编码过程中的全能 AI 伙伴,可以与Trae AI助手就当前需求进行沟通,可以用来回答编码问题、讲解代码仓库、生成代码片段、修复BUG等。类似于Cursor的Chat模式,适用于有一定编程基础的用户。
Chat 模式默认使用 “Doubao-1.5-pro”。你可以点击模型名称,然后选择切换至 DeepSeek-Reasoner (R1) 或 DeepSeek-Chat (V3) 模型。
选择 DeepSeek-Reasoner (R1) 模型会自动启用其深度思考模式,并展示其思考过程。
进阶使用
添加上下文
AI 助手可以理解当前项目中的上下文,包括代码、文件、文件夹和整个工作空间,从而更精确地协助你完成开发需求。
生成并处理代码变更
Chat 模式下,根据你的需求,AI 助手会自动创建新文件或编辑已有文件并自动保存生成的代码。你可以接受或拒绝变更,包括:处理多文件内的所有代码变更,处理单文件内的所有代码变更,处理单处代码变更。具体示例见Builder模式中的内容
若你选择接受代码变更,AI 助手会新建文件或将代码变更应用于已有的文件。应用的代码会以 Diff 的形式展示。
生成并运行命令
Chat 模式下,根据你的需求,AI 助手会提供可一键运行的 Shell 命令。具体示例见Builder模式中的内容
回退版本
你可以将项目回退至指定会话轮次发起前的版本。
回退操作不可撤销;
仅支持在最近活跃的 Builder 窗口中回退版本;
仅支持回退至最近 10 轮会话内的版本。
具体示例见Builder模式中的内容
管理历史对话
点击 Chat 窗口右上角的 历史会话 按钮后,左侧会显示 历史记录 窗口,展示 Chat 模式和 Builder 模式的所有对话记录。
● 若你需要查看某轮历史对话,点击该对话条目,你会跳转至该对话的位置。
● 若需要删除某轮对话,可以将鼠标悬浮至该对话,然后点击右侧的 删除 图标。
对话记录删除后无法恢复。
具体示例见Builder模式中的内容
Builder模式
基本使用
Builder 模式可以帮助你从 0 到 1 开发一个完整的项目,用户只需要输入一句需求描述,Trae会自主拆解需求并自动完成多轮编码任务,从想法描述到功能实现,Trae帮你一气呵成。你可以将它无缝融入到项目构建的流程中。 在 Builder 模式下,AI 助手在回答时会根据需求调用不同的工具,包括分析代码文件的工具、编辑代码文件的工具、运行命令的工具等等。从而让回答更精确、更有效。类似于Cursor的Compose模式,完全为0编程基础的小白设计。
首先使用需要开启
选择对话的大模型即可,目前支持DeepSeek-Reasoner (R1) 或 DeepSeek-Chat (V3) 模型。
Builder 模式下,AI 助手会主动读取当前项目中的文件内容,拆解任务并逐步执行,包括:
- 提取相关上下文
- 创建或修改文件
- 生成并运行终端命令
- 分析命令运行状态
进阶使用
添加上下文
AI 助手可以理解当前项目中的上下文,包括代码、文件和文件夹,从而更精确地协助你完成开发需求。具体可见高级操作中的上下文使用介绍。
输入多模态内容
你可以在会话中添加图片,例如报错截图、设计稿、参考样式等等,从而更加准确高效地表达需求。
生成并处理代码变更
根据你的需求,AI 助手会自动创建新文件或编辑已有文件,并自动保存生成的代码。你可以选择接受或拒绝代码变更,包括: 处理多文件内的所有代码变更。处理单文件内的所有代码变更:在编辑器内打开文件,点击上方提示条中的 接受,处理单处代码变更。点击待审查文件列表中的 全部接受 或 全部拒绝 按钮。
生成并运行命令
根据你的需求,AI 助手会适时推荐必要的 Shell 命令供你运行(以下图为例)。你可以选择运行或跳过某个命令,AI 助手会根据你的操作完成后续的工作。
点击 运行 后,终端将运行该命令。命令运行后,AI 助手会自动读取并分析运行结果。如果运行异常,AI 助手会自动分析原因,并给出建议解决方案。若命令运行成功,你可以点击命令卡片右上角的 终端 按钮,然后在终端中查看该命令的运行日志。
预览成果
AI 助手完成开发需求后,会提供 预览 按钮。点击后,Trae 会打开 Webview 窗口,用于展示开发成果。
预览过程中,若你继续与 AI 助手对话,修改需求,开发成果会在 Webview 窗中实时更新。
在 Webview 窗口的右上角,点击 在浏览器中打开 按钮,可在浏览器中打开窗口,预览开发成果。
回退版本
你可以将项目回退到指定会话轮次发起前的版本。
回退操作不可撤销;
仅支持在最近活跃的 Builder 窗口中回退版本;
仅支持回退至最近 10 轮会话内的版本。
使用以下步骤回退项目的版本:
- 鼠标放到之前对话上面,左边会出现对话气泡。
- 点击左侧的 回退 按钮,对话框中展示本次回退会影响的文件。
- 点击文件名,编辑器内会打开该文件,显示即将发生的变更。
- 确认本次回退的影响范围,若本次回退符合预期,点击 确定,则开始回退项目。
管理历史对话
点击 Builder 窗口右上角的 历史会话 按钮后,左侧会显示 历史记录 窗口,展示 Chat 模式和 Builder 模式的所有对话记录。
若你需要查看某轮历史对话,点击该对话条目,你会跳转至该对话的位置。
若需要删除某轮对话,可以将鼠标悬浮至该对话,然后点击右侧的 删除 图标。
对话记录删除后无法恢复。
Trae高级操作
内嵌会话
Trae 提供了内嵌在代码编辑器中的内嵌对话(Inline Chat)。你能够在编码的过程中随时唤起内嵌对话。使用内嵌对话可以让你在与 AI 助手对话的同时更好地保持编码心流。
唤起内嵌对话
你可以通过以下两种方式唤起内嵌对话:
- 在编辑器内的光标处
- 在编辑器内,选中任意代码,点击悬浮菜单中的 编辑 按钮
开始问答
在内嵌对话输入框中输入你的需求,包括为代码添加注释、解释选中的代码、优化选中的代码等等,然后点击右侧的 发送 按钮或敲击回车键。
处理结果
发送需求后,AI 助手生成的内容将以 Diff 的形式展示在编辑器内。你可以预览变更前后的代码,然后选择采纳或拒绝。 点击对话框左下角的 接受 按钮或 拒绝 按钮
重试对话
若 AI 助手生成的内容不符合你的要求,你可以点击对话框左下方的 重试 按钮,重新发起一轮同样的对话,让 AI 助手再次尝试回答。
上下文
与 AI 助手对话时,你可以指定 Trae 中的内容(包括代码、文件、文件夹、工作空间)作为上下文供 AI 助手阅读和理解,从而确保 AI 助手的答复更符合你的要求。本文介绍指定上下文的三种方式。
将编辑器内的内容作为上下文
当你的编辑器中存在正在编辑的代码文件时,AI 助手默认能够看到当前文件。你可以直接向 AI 助手提问与当前文件相关的问题。若期望对文件中的某一段代码进行提问,使用以下步骤:
- 选中代码
- 点击悬浮菜单中的 添加到对话 按钮,将选中的内容作为上下文添加至侧边对话框。 指定的上下文会显示在侧边对话底部的输入框。输入框内显示上下文的来源以及行号。
- 继续添加编辑器中的其他内容片段,或同时添加其他来源的上下文。
- 在上下文旁,输入你的问题,然后发送给 AI 助手。
将终端中的内容作为上下文
若你希望对终端中的输出内容进行提问(如帮助你修复报错),使用以下步骤:
- 在终端中,点击输出内容片段
- 在内容片段区域的右上角,点击 添加到对话 按钮,将选中的内容作为上下文添加至侧边对话框。 指定的上下文会显示在侧边对话底部的输入框。输入框内显示上下文的来源以及行号。
- 继续添加终端中的其他内容片段,或同时添加其他来源的上下文。
- 在上下文旁,输入你的问题,然后发送给 AI 助手。
使用 # 键添加上下文
在侧边对话的输入框中,你可以通过 # 符号添加多种类的上下文,包括代码、文件、文件夹和工作区。通常情况下,列表中将展示与编辑器中当前打开文件相关的内容作为推荐的上下文,但你仍然可以自行搜索所需的上下文并将其添加到输入框中。基于你的问题,你可以组合添加各种来源的相关上下文(例如同时添加代码和文件)。
Code:代码片段
File:单个文件
Folder:整个文件夹
Workspace:工作空间
#Code
通过 #Code,你可以将函数或类的相关代码作为与 AI 助手对话的上下文。列表中默认展示当前编辑器内打开的文件中的函数或类。选择前,你可以预览列表中推荐的函数或类的相关代码。若推荐的内容非你所需,你可以通过关键词搜索所需的函数或类。
若 Trae 中不存在对应语言的 LSP,请提前安装,否则可能导致无法识别代码符号。
- 在输入框中输入 #,或直接点击输入框左下角的 # 引用 按钮。 输入框上方显示上下文类型选择列表。
- 在列表中选择 Code(或在 # 符号后手动输入 Code),然后按下回车键。 列表将展示编辑器中当前打开的文件中存在的函数和类。将鼠标悬浮在列表中的某个条目后,左侧会展示该函数或类的代码内容,供你预览。
- 若推荐的函数和类非你所需,在 #Code: 后输入你想要的函数或类的名称或关键词。 AI 助手将在项目内搜索相关函数和类,并展示在列表中,你可以进行预览。
- 从列表中选择需指定为上下文的函数或类。
- 在输入框的代码标识后,输入你的问题并发送。
#File
通过 #File,你可以将指定文件中的所有内容作为与 AI 助手对话的上下文。列表中默认展示近期在编辑器中打开过的文件。你可以预览这些文件所在的目录,以免因存在同名文件而导致错选。若展示的文件非你所需,你可以通过关键词搜索所需文件。步骤与#Code一样,但这里展示的是文件。
#Folder
通过 #Folder,你可以将指定文件夹中的所有内容作为与 AI 助手对话的上下文。列表中默认展示与编辑器中当前所打开文件相关的文件夹。你可以预览这些文件夹所在的目录,以免因存在同名文件夹而导致错选。若展示的文件夹非你所需,你可以通过关键词搜索所需文件夹。步骤与上面类似,只是这里是文件夹。
#Folder 依赖项目代码索引(Project Code Index)是否构建完全。若索引暂未构建完全,可能会影响文件夹内容召回的效果,从而导致 AI 助手的回答不够完整。提问时,若索引从未构建或正在构建中,References 位置将出现 “索引构建中” 或 “索引暂未构建” 的提示,你可以根据引导在设置页管理索引。
#Workspace
你可以使用 #Workspace 来向 AI 助手提出有关整个工作空间的问题,AI 助手将自动在工作空间中查找与你的问题最相关的内容作为上下文进行回答。遇到不熟悉的项目时,该功能可以帮助你全局了解该项目所实现的功能和代码,从而使你快速上手该项目的开发。
仅支持在 Chat 模式中使用。Builder 模式会自动将整个工作空间作为上下文。
#Workspace 依赖项目代码索引(Project Code Index)是否构建完全。若索引暂未构建完全,可能会影响文件夹内容召回的效果,从而导致 AI 助手的回答不够完整。提问时,若索引从未构建或正在构建中,References 位置将出现 “索引构建中” 或 “索引暂未构建” 的提示,你可以根据引导在设置页管理索引。
- 在输入框中输入 #,或直接点击输入框左下角的 # 引用 按钮。
- 在列表中选择 Workspace(或在 # 符号后手动输入 Workspace)。
- 在输入框的 Workspace 标识后,输入你的问题并发送。
代码自动补全
Trae 内置原生的 AI 代码补全功能,无需手动开启。在编辑器内编写代码时,AI 助手会阅读并理解已编写的代码,然后自动续写代码。
自动补全代码
在光标所在位置,敲击回车键换行,AI 助手会阅读并理解当前代码,然后自动补全后续代码。
将鼠标悬浮至自动补全的代码区域后,你可以按下 Tab 键,接受所有自动补全的代码,或使用 Ctrl + → 快捷键,逐字接受代码。
根据代码注释补全代码
在对应位置添加注释,然后敲击回车键换行。AI 助手会阅读并理解代码注释,然后生成相关代码。
将鼠标悬浮至自动补全的代码区域后,你可以按下 Tab 键,接受所有自动补全的代码,或使用 Ctrl + → 快捷键,逐字接受代码。