08 - 使用Trae开发Python

Trae是字节跳动发布的AI原生编程工具，2025年1月19日，字节跳动发布了一款面向专业的开发者提供服务的全新AI Coding产品Trae；2025年2月，该工具上线Windows版；3月3日，字节跳动发布AI编程工具Trae国内版，

Trae本质上是AI原生集成开发环境工具，有一体化的原生AI体验。新发布的Trae国内版模型搭载doubao-1.5-pro，支持切换满血版DeepSeek-R1,DeepSeek-V3；3月12日，硅基流动宣布，字节跳动发布的AI原生集成开发环境已预置硅基流动SiliconCloud平台作为模型提供方。

Trae提供Trae IDE和Trae插件两种形式的产品，Trae插件是一个 AI 编程插件，提供以智能代码补全为代表的 AI 功能，能在开发过程中提供单行或整个函数的编写建议，同时支持在用户开发过程中提供代码解释、代码审查、问题修复等辅助功能，提升开发效率与质量；Trae IDE是一个与 AI 深度集成，提供智能问答、代码自动补全以及基于 Agent 的 AI 自动编程能力开发工具。在笔者看来，Train IDE就是Visual Studio Code+Trae插件。

安装Trae IDE

为了后续用上Trae的智能化能力，我们进入官网（https://www.trae.com.cn/）后先注册一个账号吧。在官网页面中点击”登录“按钮进入登录页面：

填入手机号，获取验证码并填入后勾选”我已阅读并同意服务条款和隐私协议“再点击“登录”按钮完成注册（没有账号会自动注册账号）登录进入工作台页面：

选择左侧的“立即获取Trae IDE”按钮开始下载。下载完成点击下载。

"Trae IDE"安装比较简单，下载完成后，双击刚下载的安装包进入安装向导，然后根据向导提示按部就班点击“下一步”按钮到安装页后，点击安装即可完成安装：

开始使用IDE

如果第一次安装使用，启动Trae IDE时会出现提示向导，指导你进一步初始化IDE如选择语种，导入配置、安装Trae命令行工具以及是否登录等。根据需要，一步一步操作完即可。完成后进入主界面：

惊不惊喜？界面的布局，快捷功能栏、菜单项和Visual Studio Code一模一样。也就是说可以把Trae IDE看作是在Visual Studio Code基础上集成了Trae插件的IDE。因此，针对具体计算机语言的开发，该安装插件还是继续安装插件，以前在VsCode上如何用还是如何用，除了AI能力这块。

因此，传统的操作就不讲解了，我们具体来了解使用Trae IDE对AI编程的赋能吧。

Trae IDE的AI能力来源于Trae插件。

上图中，左侧是VsCode安装了Trae插件后的AI助手，右侧是Trae IDE的AI助手。

AI代码能力

代码补全

Trae AI可以理解当前代码，然后提供建议补全的代码。

• 在对应代码处，敲击回车键换行。Trae AI会阅读并理解当前代码，然后自动补全后续代码。
  
• 在对应位置添加注释，然后敲击回车键换行。Trae AI会阅读并理解代码注释，然后直接生成代码。
  
  将鼠标悬浮至自动补全的代码区域，然后采纳或拒清除推荐的代码：

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

代码补全Pro

Trae AI支持基于上一次的编辑内容及当前代码情况，预测下一个代码改动点并提供推荐的代码。

将光标停在期望触发代码补全的位置后，你可以通过快捷键（macOS：Control + Shift + Enter；Windows：Ctrl + Shift + Enter）主动触发代码补全，并使用Tab键采纳推荐的代码。

当采纳了某处推荐的代码后，会触发下一个改动点的代码推荐，你可以先按下Tab键跳转到相应的代码行，然后再次按下Tab键采纳推荐的代码。

上图中，按下快捷键后，则出现左侧图标表示正在预测补全代码。

代码补全 Pro 默认自动启用，你可以在Trae AI设置面板中管理该功能。

代码生成

Trae AI可以根据你的自然语言描述生成对应的代码片段。

1. 在输入框中用自然语言描述你的需求。
2. 点击发送按钮或敲击回车键。

如下图，Trae AI根据输入的需求，开始生成所需代码片段。

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

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

代码编辑

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

1. 选中待修改的代码片段。
2. 在对话框中输入自然语言描述，例如 “优化选中的代码片段”。
3. 点击发送按钮或敲击回车键，Trae AI开始修改代码并生成新的代码片段。
4. 在Trae AI生成的代码片段中，按需进行以下操作：

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

代码解释

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

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

单元测试生成

选中代码片段后，向Trae AI发送单元测试生成指令。编程助手将为选中的代码片段生成单元测试。发送指令的方式如下：

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

代码注释生成

选中代码片段后，向Trae AI发送代码注释生成指令。编程将为选中的代码片段生成代码注释。

💡提示

Trae AI默认生成函数级注释，你可以通过自然语言指定生成更详细的行间注释。

发送指令的方式如下：

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

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

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

智能修复

当代码中存在错误时，窗口中的代码文件名称会高亮，名称右侧会提示错误数量。

选中有问题代码片段后，在对话框中输入自然语言描述（例如：修复选中的代码片段）或 /fix 指令，然后点击右侧的发送按钮或敲击键盘上的回车键。Trae AI将为选中的代码片段进行智能修复。

在Trae AI生成的智能修复后的代码片段后，你可以按需进行以下操作：

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

智能问答

唤起对话框后，你可以在输入框中输入你的问题，然后点击发送按钮或敲击回车键，Trae AI将回答你的问题。你可以进行多轮问答，不断补充细节，从而使插件的回答更加准确。

切换对话语言

点击对话框右上角的设置按钮，然后在Trae AI设置面板中设置 AI 对话语言。

模型嵌入

Trae预置了一系列业内表现比较出色的模型，你可以直接切换不同的模型进行使用。此外，Trae还支持通过API密钥（API Key）接入自定义模型，从而满足个性化的需求。

切换模型

在 AI 对话输入框的右下角，点击当前模型名称，打开模型列表，然后选择你想使用的模型。各个模型的能力不同，你可以将鼠标悬浮至模型名称上，然后查看该模型支持的能力。

添加自定义模型

添加自定义模型能力只有Trae IDE才提供，Trae插件没有该能力！

如果你希望使用预置模型之外的其它模型，或者想使用自己的模型资源，则可以通过 API 密钥连接你自己的模型资源或其他第三方模型服务商。

1. 在 AI 对话框右上角，点击设置图标 >模型。

界面上显示模型窗口。

1. 点击+ 添加模型按钮。

界面上显示添加模型窗口。

1. 选择服务商。可选项有：Anthropic、DeepSeek、OpenRouter、火山引擎、硅基流动、阿里云、腾讯云、模力方舟、BytePlus。
2. 选择模型：

• • 直接从列表中选择Trae为每个服务商预置的模型（均为默认版本）。
  • 若你希望使用其他模型或使用特定版本的模型，点击列表中的使用其他模型，然后在输入框中填写模型 ID。

1. 填写API 密钥。

若你希望在服务商平台上管理 API 密钥，可以点击获取 API 密钥按钮，Trae 会为你打开对应服务商的 API 密钥配置页面。

1. 点击添加模型按钮。

Trae将调用服务商的接口来检测 API 密钥是否有效。可能的结果如下：

• • 若连接成功，该自定义模型会被添加。
  • 若连接失败，添加模型窗口中展示错误信息和服务商返回的错误日志，你可以参考这些信息排查问题。

管理自定义模型

对应的，管理自定义模型能力只有Trae IDE才提供，Trae插件没有该能力！

在模型窗口中，你可以管理自定义模型。

操作类型	说明
编辑模型	点击编辑图标，然后在弹窗中修改服务商、模型名称、API 密钥等信息。
删除模型	点击删除图标，然后在弹窗中二次确认。删除后，当前模型将被从列表里移除，不可被继续使用。
启用/禁用模型	若你不希望删除模型，但在一段时间内无需使用这个模型，你可以禁用该模型。被禁用的模型将保留在设置页面的列表中，但不会出现在 AI 对话框的模型选择列表中。

Trae指令

/指令

• /explain：解释选中的代码
• /doc：生成注释
• /test：生成单测
• /fix：智能修复
• /clear：清除当前会话
• /help：学习如何使用AI助手

#指令

• #code：添加代码符号作为上下问
• #files：添加文件作为上下文
• #folder：添加文件夹作为上下文
• #workspace：使用工作区代码作为上下文