安装Trae入门教程文档

本文档介绍如何安装 Trae 并完成基础配置。

第一步：安装并启动 Trae

1. 前往 Trae 的官网，将 Trae 安装至电脑。
2. 启动 Trae。

Trae 首次启动时，你会进入以下页面。

1. 点击 开始 按钮。

Trae 初始配置流程开始。

第二步：选择主题和语言

1. 选择主题。可选项为 暗色、亮色 和 深蓝。
2. 选择显示语言。可选项为 简体中文、English 和 日语。

若有需要，后续可以在设置中心修改主题和语言。

1. 点击 继续 按钮。

第三步：从 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 以使用 AI 能力。Trae 提供了三种登录方式，分别为 Google 账号登录、Github 账号登录、邮箱登录。若你没有账号，也可以新注册一个账号。

点击 登录 按钮，然后根据页面引导完成登录流程。登录后，你将进入 IDE 界面，如下图所示。

第六步：开始使用 Trae

在 Trae 中，开发你的项目

你可以管理 Trae 中的项目，包括创建项目和切换项目。

什么是 “工作空间”？

“工作空间” 通常为一个在 Trae 中打开的文件夹。若你的项目较为复杂，也可以将多个文件夹添加至一个 “工作空间”。

创建项目

Trae 提供三种创建项目的方式：导入本地文件夹、克隆 Git 仓库。

方式一：导入本地文件夹

1. 点击左侧面板中央的 打开文件夹 按钮，或在界面左上角点击 选择项目 > 打开文件夹。

1. 选择文件夹并在 Trae 中将其打开。

你将看到以下授权弹窗：

1. 在 是否信任此文件夹中的文件的作者？ 弹窗中：
   1. (可选) 勾选 信任父文件夹“Downloads”中所有文件的作者。

此后，在 Trae 中打开任何 “Downloads”（下载） 目录下的文件夹将不再弹出该授权窗口。

1. 1. 点击 是，我信任此作者。

文件夹已在 IDE 中打开。你可以开始编辑项目。

方式二：从 GitHub 克隆仓库

1. 点击左侧面板中央的 克隆 Git 仓库 按钮，或在界面左上角点击 选择项目 > 克隆 Git 仓库。

1. 点击 从 GitHub 克隆。

你将看到以下授权弹窗。

1. 授权 GitHub 登录 Trae：
   1. 点击 允许。

你将看到以下展示授权码的弹窗：

1. 1. 点击 复制并继续访问 GitHub。

已复制授权码，然后你将看到以下弹窗：

1. 1. 点击 打开。

你将前往 GitHub 上的登录授权页面。

1. 1. 根据页面提示，完成授权。
2. 返回 Trae。

弹框中展示可克隆的仓库列表。

1. 直接从列表中选择一个仓库。

或

输入期望克隆的仓库名称，然后点击 从 GitHub 克隆。

1. 在弹窗中，选择该仓库的存储位置，然后点击 选择为存储库目标。

Trae 开始克隆该仓库。克隆完毕后，你会看到以下弹窗。

1. 按需从以下操作中选择其一：

• • 点击 打开，直接在 Trae 的当前窗口打开该仓库。
  • 点击 在新窗口中打开，在 Trae 中用新窗口中打开该仓库。

你将看到以下授权弹窗：

1. 在 是否信任此文件夹中的文件的作者？ 弹窗中：
   1. (可选) 勾选 信任父文件夹“Downloads”中所有文件的作者。

此后，在 Trae 中打开任何 “Downloads”（下载） 目录下的文件夹将不再弹出该授权窗口。

1. 1. 点击 是，我信任此作者。

仓库已在 IDE 中打开，你可以开始编辑项目。

方式三：直接从 Git 仓库的 URL 克隆

此方式无需授权 GitHub 登录 Trae，你可以直接使用目标仓库的 URL 来将其克隆至 Trae。

1. 点击左侧面板中央的 克隆 Git 仓库 按钮，或在界面左上角点击 选择项目 >克隆 Git 仓库。
2. 在 URL 输入框中，输入目标 Git 仓库的 URL，然后点击 存储库 URL {URL}。

1. 在弹窗中选择该仓库的存储地址，然后点击 选择为存储库目标。

Trae 开始克隆该仓库。克隆完毕后，你会看到以下弹窗。

1. 按需从以下操作中选择其一：

• • 点击 打开，直接在 Trae 的当前窗口打开该仓库。
  • 点击 在新窗口打开，在 Trae 中用新窗口中打开该仓库。

你将看到以下授权弹窗：

1. 在 是否信任此文件夹中的文件的作者？ 弹窗中：
   1. (可选) 勾选 信任父文件夹“Downloads”中所有文件的作者。

此后，在 Trae 中打开任何 “Downloads”（下载） 目录下的文件夹将不弹出该授权窗口。

1. 1. 点击 是，我信任此作者。

该仓库已在 IDE 中打开。你可以开始编辑项目。

切换项目

当 Trae 中存在多个项目时，你可以切换不同的项目进行开发。

1. 在界面左上角，点击当前项目的名称。

界面上显示如下面板，展示最近导入或使用的项目列表。

1. 在 最近 列表中，选择需打开的项目。

Trae 打开一个新的窗口，加载并展示该项目。