> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

TRAE 插件提供自动代码补全、代码生成、代码编辑等能力。你可以使用这些能力来提升开发效率。
## 前置条件 {#f2e4e853}
使用快捷键（Windows: Ctrl + U；macOS：Command + U）唤起侧边对话框。 
## 代码补全 {#dd703ab4}
TRAE AI 可以理解当前代码，然后提供建议补全的代码。
**场景一**：在对应代码处，敲击回车键换行。TRAE AI 会阅读并理解当前代码，然后自动补全后续代码。
![Image=400x125](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/195d6ca9df0144588a165c51ad550a2f~tplv-goo7wpa0wc-image.image)
**场景二**：在对应位置添加注释，然后敲击回车键换行。TRAE AI 会阅读并理解代码注释，然后直接生成代码。
![Image=400x170](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/bda5627f9915418791725ffbc40f5bce~tplv-goo7wpa0wc-image.image)
将鼠标悬浮至自动补全的代码区域，然后采纳或拒清除推荐的代码：

* 点击 **接受** 按钮或按下 Tab 键，添加所有推荐的代码。
* 点击 **接收 Word** 按钮或使用 Ctrl + → 快捷键，逐字添加推荐的的代码。
* 按下 Esc 键，清除推荐的代码。

![Image=400x95](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2997d1016c654e2da271b77aa4857514~tplv-goo7wpa0wc-image.image)
## Tab-Cue {#286810f1}
TRAE AI 支持基于上一次的编辑内容及当前代码情况，预测下一个代码改动点并提供推荐的代码。
将光标停在期望触发代码补全的位置后，你可以通过快捷键（macOS：Control + Shift + Enter；Windows：Ctrl + Shift + Enter）主动触发代码补全，并使用 Tab 键采纳推荐的代码。
当采纳了某处推荐的代码后，会触发下一个改动点的代码推荐，你可以先按下 Tab 键跳转到相应的代码行，然后再次按下 Tab 键采纳推荐的代码。
![Image=600x223](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4664bf05ad7049cc8fcd1a296bf524ba~tplv-goo7wpa0wc-image.image)
代码补全 Pro 默认自动启用，你可以在 **TRAE AI 设置** 面板中管理该功能。
![Image=400x451](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4ff5298140ae4d6e998ce345c485020e~tplv-goo7wpa0wc-image.image)
## 代码生成 {#a6f7236f}
 TRAE AI 可以根据你的自然语言描述生成对应的代码片段。

1. 在输入框中用自然语言描述你的需求。 
2. 点击 **发送** 按钮或敲击回车键。 
   TRAE AI 开始生成所需代码片段。 
   ![Image=2880x1800](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/29f58775d9754f9f95346b151f8e08f7~tplv-goo7wpa0wc-image.image)
3. 在 TRAE AI 生成的代码片段中，按需进行以下操作：
   * 点击 **复制** 按钮，复制代码框中的代码片段。 
   * 点击 **插入** 按钮，将代码片段插入至对应的位置。 
   * 点击 **添加文件** 按钮，将代码片段生成为一个单独的文件。 
   * 点击 **Apply** 按钮，将生成代码以 Diff 的形式展示在原文件中，然后选择采纳或拒绝新的代码。

## 代码编辑 {#405e05f3}
TRAE AI 可以编辑指定代码，包括重构、优化、修改部分逻辑等。你可以通过自然语言描述代码编辑需求。

1. 选中待修改的代码片段。
2. 在对话框中输入自然语言描述，例如 “优化选中的代码片段”。 
3. 点击 **发送** 按钮或敲击回车键。 
   TRAE AI 开始修改代码并生成新的代码片段。 
   ![Image=2880x1800](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0e6f2c20f4fe4979be4ae21474498973~tplv-goo7wpa0wc-image.image)
4. 在 TRAE AI 生成的代码片段中，按需进行以下操作：
   * 点击 **复制** 按钮，复制代码框中的代码片段。 
   * 点击 **插入** 按钮，将修改后的代码片段插入至对应的位置。 
   * 点击 **添加文件** 按钮，将修改后的代码片段生成为一个单独的文件。 
   * 点击 **Apply** 按钮，将修改后的代码以 Diff 的形式展示在原文件中，然后选择采纳或拒绝代码变更。

## 代码解释 {#eedf0b37}
选中代码片段后，你可以向 TRAE AI 发送代码解释指令。编程助手将解释选中的代码片段。发送指令方式如下：

* 在侧边对话视图的输入框中输入自然语言描述，例如：解释选中的代码片段；
* 在侧边对话视图的输入框中输入 /explain 指令；
* 选中代码片段后右键，然后在快捷菜单中选择 **Trae AI** > **代码解释**；
* 点击代码文件顶部的 **解释代码** 按钮。

![Image=2880x1800](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/1db0c25c53364a3e971e4dbda7d5bf7c~tplv-goo7wpa0wc-image.image)
## 单元测试生成 {#c0f676c4}
选中代码片段后，向 TRAE AI 发送单元测试生成指令。编程助手将为选中的代码片段生成单元测试。发送指令的方式如下：

* 在侧边对话视图的输入框中输入自然语言描述，例如：为所选代码片段生成单元测试；
* 在侧边对话视图的输入框中输入 /test 指令；
* 选中代码片段后右键，然后在快捷菜单中选择 **Trae AI** > **单测生成**；
* 点击代码文件顶部的 **生成单测** 按钮。

![Image=2880x1800](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c943a3c6ea78453ab68832a7e1b67f64~tplv-goo7wpa0wc-image.image)
## 代码注释生成 {#b637b4b4}
选中代码片段后，向 TRAE AI 发送代码注释生成指令。编程将为选中的代码片段生成代码注释。
:::tip 提示
TRAE AI 默认生成函数级注释，你可以通过自然语言指定生成更详细的行间注释。
:::
发送指令的方式如下：

* 在侧边对话视图的输入框中输入自然语言描述，例如：为所选代码片段生成注释；
* 在侧边对话视图的输入框中输入 /doc 指令；
* 选中代码片段后右键，然后在快捷菜单中选择 **Trae AI** > **注释生成**；
* 点击代码文件顶部的 **生成注释** 按钮。

在 TRAE AI 生成的代码片段中，按需进行以下操作：

* 点击 **复制** 按钮，复制代码框中的包含注释的代码片段。 
* 点击 **插入** 按钮，将注释插入至代码文件中对应的位置。 
* 点击 **添加文件** 按钮，将包含注释的代码片段生成为一个单独的文件。 
* 点击 **Apply** 按钮，将代码注释以 Diff 的形式展示在原文件中，然后选择采纳或拒绝代码注释。

![Image=2880x1800](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/125acb339b8247eb96d77ed8b16c737c~tplv-goo7wpa0wc-image.image)
## 智能修复 {#3e23182a}
当代码中存在错误时，窗口中的代码文件名称会高亮，名称右侧会提示错误数量。
选中有问题代码片段后，在对话框中输入自然语言描述（例如：修复选中的代码片段）或  /fix 指令，然后点击右侧的 **发送** 按钮或敲击键盘上的回车键。TRAE AI 将为选中的代码片段进行智能修复。
在 TRAE AI 生成的智能修复后的代码片段后，你可以按需进行以下操作： 

* 点击 **复制** 按钮，复制修复后的代码片段。 
* 点击 **插入** 按钮，将修复后的代码片段插入原代码对应的位置，并替换原代码。
* 点击 **添加文件** 按钮，将修复后的代码片段生成为一个单独的文件。 
* 点击 **Apply** 按钮，将修复后的代码以 Diff 的形式展示在原文件中，然后选择采纳或拒绝新的代码。

![Image=2880x1800](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8ab744451bd846aab705b2f6af9547f2~tplv-goo7wpa0wc-image.image)
## **智能问答**  {#e719ccb2}
唤起对话框后，你可以在输入框中输入你的问题，然后点击 **发送** 按钮或敲击回车键，TRAE AI 将回答你的问题。你可以进行多轮问答，不断补充细节，从而使插件的回答更加准确。
## 切换对话语言 {#1fc1b4fb}
点击对话框右上角的设置按钮，然后在 **Trae AI 设置** 面板中设置 AI 对话语言。
![Image=400x328](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/945deebfd0534e739d110b0f3d64f99f~tplv-goo7wpa0wc-image.image)