小帕鲁
什么是 Trae IDE？
Trae（/treɪ/）IDE 与 AI 深度集成，提供智能问答、代码自动补全以及基于 Agent 的 AI 自动编程能力。使用 Trae 开发项目时，你可以与 AI 灵活协作，提升开发效率。
完备的 IDE 功能
提供传统的 IDE 功能，包括代码编写、项目管理、插件管理、源代码管理等。
强大的 AI 助手
智能问答
在编写代码时，你可以随时与 AI 助手对话，获得代码解释、代码注释和错误修复等帮助。详情参考《侧边对话》和《内嵌对话》。
实时代码建议
AI 助手能够理解当前代码并在编辑器中实时提供代码建议，提升编程效率。详情参考《代码自动补全》。
代码片段生成
通过自然语言描述你的需求，AI 助手将生成相应的代码片段，甚至能够编写项目级或跨文件的代码。
从 0 到 1 开发项目
告诉 AI 助手你想开发的程序，AI 助手将根据你的描述提供相关代码或自动创建所需文件。详情参考《智能体》。
第一步：安装并启动 Trae
前往
https://www.trae.com.cn ，将 Trae 安装至电脑。启动 Trae。
Trae 首次启动时，你会进入以下页面。
点击 开始 按钮。
Trae 初始配置流程开始。
第二步：选择主题和语言
选择主题。可选项为 暗色、亮色 和 深蓝。
选择显示语言。可选项为 简体中文、English 和 日语。
若有需要，后续可以在设置中心修改主题和语言。
点击 继续 按钮。
第三步：从 VS Code 或 Cursor 中导入配置
若你的电脑中已安装并配置 VS Code 或 Cursor，你可以点击 从 VS Code 导入 或 从 Cursor 导入 按钮。系统将会从对应的 IDE 中获取插件、IDE 设置、快捷键设置等信息并一键导入到 Trae 中，帮助你快速从其他 IDE 切换到 Trae。
第四步：添加 Trae 相关的命令行
添加 Trae 相关的命令行后，你可以在终端中使用命令行更快速地完成 Trae 相关的操作。例如：
使用 trae 命令快速唤起 Trae。
使用 trae my-react-app 命令在 Trae 中打开一个项目。
点击 安装 trae 命令 按钮，然后完成授权流程。
若未在此处安装 Trae 相关的命令行，后续可在 IDE 中使用快捷键（macOS：Command + Shift + P；Windows：Ctrl + Shift + P）打开命令面板，然后使用 install 'trae' command in PATH 命令进行安装。
第五步：登录账号
使用手机号或稀土掘金帐号登录 Trae。完成登录后，你才可以在 Trae 中使用 AI 服务。
第六步：开始使用 Trae
在 Trae 中，开发你的项目，例如：
管理项目
你可以管理 Trae 中的项目，包括创建项目和切换项目。
什么是 “工作空间”？
“工作空间” 通常为一个在 Trae 中打开的文件夹。若你的项目较为复杂，也可以将多个文件夹添加至一个 “工作空间”。
创建项目
Trae 提供三种创建项目的方式：导入本地文件夹、从 GitHub 克隆仓库、从 Git 仓库的 URL 克隆。
方式一：导入本地文件夹
点击左侧面板中央的 打开文件夹 按钮，或在界面左上角点击 选择项目 > 打开文件夹。
选择文件夹并在 Trae 中将其打开。
你将看到以下授权弹窗：
根据提示完成授权。
文件夹已在 IDE 中打开，你可以开始编辑项目。
方式二：从 GitHub 克隆仓库
点击左侧面板中央的 克隆 Git 仓库 按钮，或在界面左上角点击 选择项目 > 克隆 Git 仓库。
点击 从 GitHub 克隆。
你将看到以下授权弹窗。
授权 GitHub 登录 Trae：
点击 允许。
你将看到以下展示授权码的弹窗：
点击 复制并继续访问 GitHub。
已复制授权码，然后你将看到以下弹窗：
点击 打开。
你将前往 GitHub 上的登录授权页面。
根据页面提示，完成授权。
返回 Trae。
弹框中展示可克隆的仓库列表。
直接从列表中选择一个仓库 / 输入期望克隆的仓库名称，然后点击 从 GitHub 克隆。
在弹窗中，选择该仓库的存储位置，然后点击 选择为存储库目标。
Trae 开始克隆该仓库。克隆完毕后，你会看到以下弹窗。
按需从以下操作中选择其一：
点击 打开，直接在 Trae 的当前窗口打开该仓库。
点击 在新窗口中打开，在 Trae 中用新窗口中打开该仓库。
你将看到以下授权弹窗：
根据提示完成授权。
仓库已在 IDE 中打开，你可以开始编辑项目。
方式三：直接从 Git 仓库的 URL 克隆
此方式无需授权 GitHub 登录 Trae，你可以直接使用目标仓库的 URL 来将其克隆至 Trae。
点击左侧面板中央的 克隆 Git 仓库 按钮，或在界面左上角点击 选择项目 >克隆 Git 仓库。
在 URL 输入框中，输入目标 Git 仓库的 URL，然后点击 存储库 URL {URL}。
在弹窗中选择该仓库的存储地址，然后点击 选择为存储库目标。
Trae 开始克隆该仓库。克隆完毕后，你会看到以下弹窗。
按需从以下操作中选择其一：
点击 打开，直接在 Trae 的当前窗口打开该仓库。
点击 在新窗口打开，在 Trae 中用新窗口中打开该仓库。
你将看到以下授权弹窗：
根据提示完成授权。
仓库已在 IDE 中打开，你可以开始编辑项目。
切换项目
当 Trae 中存在多个项目时，你可以切换不同的项目进行开发。
在界面左上角，点击当前项目的名称。
界面上显示如下面板，展示最近导入或使用的项目列表。
在 最近 列表中，选择需打开的项目。
Trae 打开一个新的窗口，加载并展示该项目。
管理插件
在 Trae 中，你可以安装、禁用和卸载插件。
安装插件
你可以从 Trae 或 VS Code 的插件市场安装插件，或直接将本地的 .vsix 文件导入至 Trae IDE。
从 Trae 的插件市场安装
在左侧导航栏中，点击 插件市场 图标。
界面左侧显示 插件市场 面板。
搜索你想要的插件并在 未安装 列表中将其选中。
界面上显示该插件的详情窗口，展示该插件的详细说明、变更日志等信息。
点击 安装。
Trae 开始安装该插件。安装完成后，该插件会出现在 已安装 列表中。
从 VS Code 的插件市场安装
C/C++ 插件等区分平台架构的插件无法使用此方法安装，需自行下载所使用的平台架构的 VSIX 文件。
如果 Trae 的插件市场未提供你所需的插件，可以将 VS Code 插件市场中的插件安装至 Trae。
前往 VS Code 的插件市场。
搜索你想要的插件，例如：Deno。
在搜索结果中，点击你所需的插件。
你会前往该插件的详情页。
在详情页中，点击 Version History。
结合插件页的 URL 和 Version History 中的信息，提取出以下信息（以 Deno 为例）：
itemName：URL Query 中的 itemName 字段，如截图中的 denoland.vscode-deno，并将小数点（.）前后的内容分成以下两个字段：
fieldA：denoland
fieldB：vscode-deno
version：如截图中的 3.43.3
使用提取出来的 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/denoland/vsextensions/vscode-deno/3.43.3/vspackage在浏览器中输入修改后的 URL，然后按下回车键。
浏览器开始下载该插件。
下载完成后，返回 Trae 并打开插件市场。
将下载的 .vsix 文件拖拽至 插件市场 面板中。
Trae 开始自动安装该插件。安装完成后，该插件会出现在 已安装 列表中。
导入本地 .vsix 文件
在左侧导航栏中，点击 插件市场 图标，打开 插件市场 面板。
在面板右上角，点击 ··· > 从 VSIX 安装。
在弹窗中，选择目标.vsix 文件导入至 Trae IDE。
禁用插件
在 Trae 中，打开插件市场。
在 已安装 列表中，找到需禁用的插件。
鼠标悬浮至列表中的插件，然后点击 设置 > 禁用 / 点击该插件以打开其详情窗口，然后点击 禁用。
卸载插件
在 Trae 中，打开插件市场。
在 已安装 列表中，找到需卸载的插件。
鼠标悬浮至该插件，然后点击 卸载 / 点击该插件以打开其详情窗口，然后点击 卸载。
常见问题
暂不支持安装 VS Code 插件市场中某个版本的插件
若 VS Code 插件市场中某个版本的插件依赖了新版 VS Code 中的某些接口，则可能会导致该插件与 Trae 不兼容。你可以查看该插件的 Version History，然后下载该插件的历史版本。
