目录
一、什么是 Trae ?
Trae 是字节跳动推出的一款 AI 驱动的集成开发环境(IDE),主要面向开发者。它与 AI 深度集成,具备以下核心功能:
-
智能问答:开发者在编写代码时,可以随时与 AI 助手对话,获得代码解释、错误修复和需求生成等帮助。
-
代码自动补全:AI 助手能够理解当前代码,并在编辑器中实时提供代码建议,提升编程效率。
-
Builder 模式:从项目需求到代码、依赖、调试,Trae 都能全自动生成,还支持“对话式迭代”。
-
多模态开发:支持上传设计图或原型图,Trae 能直接生成代码,截图标注修改需求也无问题。
-
上下文引用:支持工作区、文件夹、文件、代码四级引用,终端报错也能直接关联。
Trae(/treɪ/
)是真正的 AI 工程师。它提供了 AI 问答、代码自动补全以及基于代理的 AI 编程能力等功能。在使用 Trae 开发项目时,您可以与 AI 协作,从而提升开发效率。目前Trae 有国内版和国际版。国内版使用国内模型,连接稳定快速,界面也根据国内用户习惯定制;国际版使用国外模型,对于国内用户可能存在连接问题。此外,Trae 国内版内置豆包 1.5 Pro 和 DeepSeek R1/V3 模型,国际版免费提供 Claude 3.5、GPT-4o等模型。
二、Trae 设置指南:安装、配置与开始开发
第一步:安装并启动Trae
到官网下载安装包
- 中文版官网地址:www.trae.com.cn
- 海外版官网地址:www.trae.ai
等待安装完成后启动 Trae ,在 Trae 首次启动时,会出现以下界面。
第二步:选择主题和语言
- 选择主题。可选项为 暗色、亮色 和 深蓝。
- 选择显示语言。可选项为 简体中文、English 和 日语。
- 提示:
- 默认语言为中文。
- 若有需要,后续可以在设置中心修改主题和语言。
- 提示:
- 点击“
继续
(Continue
)”按钮。
第三步:从VS Code或Cursor导入配置
如果您已经在电脑上设置了 VS Code 或 Cursor ,您可以点击“从 VS Code 导入
”或“从 Cursor 导入
”,系统将从这两个 IDE 中导入所有扩展、设置和快捷键配置到 Trae,使您能够快速从其他 IDE 切换到 Trae 进行开发。
第四步:安装 Trae 的命令
添加 Trae 相关命令后,您可以使用终端中的相关命令在 Trae 中更快速地执行相应任务。例如:
- 使用
trae
命令快速启动 Trae; - 使用
trae my-react-app
命令在 Trae 中打开一个项目。
点击 安装 trae
命令 按钮,然后完成授权流程。
第五步:登录账号
使用手机号或稀土掘金帐号登录 Trae。完成登录后,你才可以在 Trae 中使用 AI 服务。
第六步:开始使用Trae进行开发
在 Trae 中,您可以通过以下两种方式之一开始开发项目:
- 打开现有文件夹或克隆现有 Git 仓库。更多信息请参考《管理项目》。
- 使用 AI 助手从0到1开始创建一个新项目。更多信息请参考《Builder 模式》。
三、Trae 项目管理:创建、导入与切换项目指南
管理项目
您可以在 Trae 中管理项目,包括创建和切换项目。
什么是工作区?
工作区通常是一个在 Trae 中打开的文件夹。如果您的项目较为复杂,可以将多个文件夹添加到一个工作区中进行管理。
创建项目
您可以通过以下两种方式在 Trae 中创建项目:
- 通过导入本地文件夹
- 克隆 Git 仓库。
方法一:导入本地文件夹
-
点击屏幕中间的 “
Open a Folder
(打开文件夹)” 按钮,或者点击左上角的 “Select a Project
(选择项目) > 打开文件夹”。 - 选择一个文件夹并将其在 Trae 中打开。
-
在弹出的 “
"Trae" would like to access files in your Downloads folder
(Trae想要访问您下载文件夹中的文件)” 对话框中,点击 “Allow
(允许)”。 -
在 “您是否信任此文件夹中文件的作者” 对话框中: a. (可选)勾选 “
Trust the authors of all files in the parent folder "Downloads"
(信任下载文件夹中所有文件的作者)” 复选框。 勾选后,当您从下载目录中打开任何文件夹时,此弹出窗口将不再出现。 b. 点击 “Yes, I trust the authors.
(是,我信任作者)”。所选文件夹已在 Trae 中打开,您可以开始编辑。
方法二:从 GitHub 克隆仓库
-
点击屏幕中间的 “
Clone Git Repository
(克隆 Git 仓库)” 按钮,或者点击左上角的 “Select a Project
(选择项目) >Clone Git Repository
(克隆 Git 仓库)”。 -
点击 “
Clone from GitHub
(从 GitHub 克隆)”。此时将显示以下对话框
-
在弹出的对话框中,授权 GitHub 登录 Trae: a. 点击 “
Allow
(允许)”。 将出现显示授权码的对话框。b. 点击 “
Copy & Continue to GitHub
(复制并继续到 GitHub)”。 授权码已复制,将出现以下对话框。c. 点击 “
Open
(打开)”。 你将被定向到以下设备激活屏幕。d. 按照屏幕上的说明完成授权过程。
-
返回 Trae 屏幕顶部中间的框中显示可克隆的仓库列表。
- 从列表中选择一个仓库, 或者 输入您想要的仓库名称或关键词,点击 “
Clone from GitHub
从 GitHub 克隆”。 - 在弹出窗口中,选择一个位置保存仓库,并点击 “
Select as Repository Destination
选择为仓库目标位置”。 Trae 开始克隆仓库。完成后,将出现以下对话框。
- 根据需要执行以下操作之一:
- 点击 “
Open
(打开)”,直接在当前窗口的 Trae 中打开仓库。 - 点击 “
Open in New Window
(在新窗口中打开)”,在 Trae 的新窗口中打开仓库。
- 点击 “
-
在 “
Do your trust the authors of the files in this folder
(您是否信任此文件夹中文件的作者)” 对话框中: a. (可选)勾选 “Trust the authors of all files in the parent folder "Downloads"
(信任下载文件夹中所有文件的作者)” 复选框。 之后,当您在 Trae 的Downloads
目录中打开任何文件夹时,此弹出窗口将不会再次出现。 b. 点击 “Yes, I trust the authors
(是,我信任作者)”。所选文件夹已在 Trae 中打开,你可以开始编辑。
方法三:通过 URL 克隆 Git 仓库
此方法无需授权 GitHub 登录 Trae,您可以直接使用仓库的 URL 进行克隆。
- 点击屏幕中间的 “
Clone Git Repository
(克隆 Git 仓库)” 按钮,或者点击左上角的 “Select a Project
(选择项目) >Clone Git Repository
(克隆 Git 仓库)”。 - 在 URL 输入框中,输入目标仓库的 URL,并点击 “
Clone from URL {URL_name}
(从 URL 克隆 {URL_名称})”。 - 在弹出窗口中,选择一个位置保存仓库,并点击 “
Select as Repository Destination
(选择为仓库目标位置)”。 Trae 开始克隆仓库。完成后,将出现以下对话框。 - 根据需要执行以下操作之一:
- 点击 “
Open
(打开)”,直接在当前窗口的 Trae 中打开仓库。 - 点击 “
Open in New Window
(在新窗口中打开)”,在 Trae 的新窗口中打开仓库。
- 点击 “
- 在 “
Do your trust the authors of the files in this folder
(您是否信任此文件夹中文件的作者)” 对话框中: a. (可选)勾选 “Trust the authors of all files in the parent folder "Downloads"
(信任下载文件夹中所有文件的作者)” 复选框。 b. 点击 “Yes, I trust the authors
(是,我信任作者)”。
仓库已在 Trae 中打开,您可以开始编辑。
切换到另一个项目
当 Trae 中有多个项目时,您可以在它们之间切换。
- 在 Trae 的左上角,点击 “
Select Project
(选择项目)” 或当前窗口中打开的项目名称。 - 在 “
Recent
(最近)” 列表中,选择您想要切换到的项目。 Trae 将打开一个新窗口来加载并显示所选项目。
四、Trae 扩展插件:安装、禁用与卸载扩展指南
管理插件
在 Trae 中,您可以安装、禁用或卸载插件。
安装插件
您可以从 Trae 的插件商店或 VS Code 的市场中安装插件。
从 Trae 的插件商店安装
-
在左侧导航栏中,点击 插件市场 图标。
界面左侧显示 插件市场 面板。
-
搜索你想要的插件并在 未安装 列表中将其选中。
界面上显示该插件的详情窗口,展示该插件的详细说明、变更日志等信息。
-
点击“
Install
(安装)”按钮。Trae 开始安装插件。安装完成后,插件将出现在“
Installed
(已安装)”列表中。
从VS Code 的插件市场安装
如果 Trae 的插件市场未提供你所需的插件,可以将 VS Code 插件市场中的插件安装至 Trae。
- 访问 VS Code 的插件市场
-
搜索你想要的插件,例如:Pylance。
-
在搜索结果中,点击你所需的插件。
你会前往该插件的详情页。
- 在详情页中,点击 Version History。
-
结合插件页的 URL 和 Version History 中的信息,提取出以下信息(以 Pylance 为例):
itemName
:URL Query 中的itemName
字段,如截图中的ms-python.vscode-pylance
,并将小数点(.
)前后的内容分成以下两个字段:- fieldA:
ms-python
- fieldB:
vscode-pylance
version
:如截图中的2025.1.102
- 使用提取出来的 3 个字段的值替换下方 URL 中的同名字段。
模板: https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${itemName.fieldA}/vsextensions/${itemName.fieldB}/${version}/vspackage
示例:
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/vscode-pylance/2025.1.102/vspackage
-
在浏览器中输入修改后的 URL,然后按下回车键。
浏览器开始下载该插件。
- 下载完成后,返回 Trae 并打开插件市场。
-
将下载的
.vsix
文件拖拽至 插件市场 面板中。Trae 开始自动安装该插件。安装完成后,该插件会出现在 已安装 列表中。
禁用插件
- 打开 Trae 的插件商店。
- 在“
Installed
(已安装)”列表中,找到您想要禁用的插件。 -
将光标悬停在插件上,点击“
Settings
(设置) >Disable
(禁用)”。 或者 点击插件以打开其详细信息窗口,然后点击“Disbale
(禁用)”。
卸载插件
- 打开 Trae 的插件市场。
- 在“
Installed
(已安装)”列表中,找到您想要卸载的插件。 -
将光标悬停在插件上,点击“
Uninstall
(卸载)”。 或者 点击插件以打开其详细信息窗口,然后点击“Uninstall
(卸载)”。
暂不支持安装 VS Code 插件市场中某个版本的插件
若 VS Code 插件市场中某个版本的插件依赖了新版 VS Code 中的某些接口,则可能会导致该插件与 Trae 不兼容。你可以查看该插件的 Version History,然后下载该插件的历史版本。