Skip to content

管理扩展

在 Trae 中,您可以安装、禁用或卸载扩展。

安装扩展

您可以从 Trae 的扩展商店或 VS Code 的市场安装扩展,也可以通过将本地 .vsix 文件安装到 Trae IDE 中来直接安装扩展。

从 Trae 扩展商店安装

  1. 在左侧导航栏中,点击扩展商店图标。
  2. 扩展商店出现在左侧。
  3. 搜索您想要安装的扩展,并从可用列表中选择它。
  4. 选定扩展的详细信息窗口出现。您可以阅读其详细介绍、更新日志等。
  5. 点击安装按钮。
  6. Trae 开始安装扩展。安装完成后,扩展出现在已安装列表中。

从 VS Code 市场安装

注意:C/C++ 扩展和其他平台特定扩展无法使用此方法安装。您需要手动下载您正在使用的平台特定扩展的 VSIX 包。

如果 Trae 的扩展商店没有提供您想要的扩展,您可以从 VS Code 的市场将其安装到 Trae。

  1. 搜索您想要的扩展。例如,Deno。
  2. 从搜索结果中选择您想要的扩展。
  3. 这会将您导向扩展的详细信息页面。
  4. 在扩展的详细信息页面上,点击版本历史
  5. 选择您想要安装的版本。
  6. 点击下载按钮下载 .vsix 文件。
  7. 在 Trae 中,打开扩展商店。
  8. 点击右上角的更多操作(三个点)按钮。
  9. 选择从 VSIX 安装
  10. 选择您下载的 .vsix 文件。
  11. Trae 开始安装扩展。

从本地 VSIX 文件安装

  1. 在 Trae 中,打开扩展商店。
  2. 点击右上角的更多操作(三个点)按钮。
  3. 选择从 VSIX 安装
  4. 浏览并选择您的 .vsix 文件。
  5. 点击安装

扩展管理功能

扩展分类

扩展按以下类别组织:

  • 编程语言:语言支持和语法高亮
  • 调试器:调试工具和配置
  • 格式化程序:代码格式化工具
  • 键盘映射:键盘快捷键方案
  • 代码片段:代码模板和片段
  • 主题:颜色主题和图标主题
  • 其他:其他实用工具

扩展状态

  • 已安装:已安装并可用的扩展
  • 已启用:当前活动的扩展
  • 已禁用:已安装但未激活的扩展
  • 需要重新加载:需要重启 IDE 才能生效的扩展

禁用扩展

  1. 在 Trae 中打开扩展商店。

  2. 已安装列表中,找到您想要禁用的扩展。

  3. 将光标移动到扩展上,点击设置 > 禁用

    或者

    点击扩展打开其详细信息窗口,然后点击禁用

禁用选项

  • 禁用:在所有工作区中禁用扩展
  • 禁用(工作区):仅在当前工作区中禁用扩展

卸载扩展

  1. 在 Trae 中打开扩展商店。

  2. 已安装列表中,找到您想要卸载的扩展。

  3. 将光标移动到扩展上,点击卸载

    或者

    点击扩展打开其详细信息窗口,然后点击卸载

扩展设置

配置扩展

大多数扩展提供可配置的设置:

  1. 打开设置(Ctrl/Cmd + ,)
  2. 搜索扩展名称
  3. 修改扩展特定的设置
  4. 设置会自动保存

扩展数据

扩展可以存储以下类型的数据:

  • 全局状态:跨所有工作区的设置
  • 工作区状态:特定于当前工作区的设置
  • 密钥存储:安全存储敏感信息

扩展更新

自动更新

默认情况下,Trae 会自动更新扩展:

  • 检查更新频率:每天
  • 自动安装更新:是
  • 更新通知:显示

手动更新

  1. 打开扩展商店
  2. 查看已安装列表中的更新标识
  3. 点击更新按钮
  4. 或点击全部更新更新所有扩展

版本管理

  • 稳定版本:经过测试的稳定版本
  • 预发布版本:包含最新功能的测试版本
  • 特定版本:安装指定版本的扩展

扩展推荐

工作区推荐

在工作区根目录创建 .vscode/extensions.json 文件:

json
{
  "recommendations": [
    "ms-python.python",
    "ms-vscode.vscode-typescript-next",
    "esbenp.prettier-vscode"
  ],
  "unwantedRecommendations": [
    "ms-vscode.vscode-json"
  ]
}

扩展包

创建扩展包来组合相关扩展:

json
{
  "name": "my-extension-pack",
  "displayName": "我的扩展包",
  "description": "Web 开发必备扩展",
  "version": "1.0.0",
  "engines": {
    "trae": "^1.0.0"
  },
  "categories": [
    "Extension Packs"
  ],
  "extensionPack": [
    "ms-vscode.vscode-typescript-next",
    "esbenp.prettier-vscode",
    "bradlc.vscode-tailwindcss"
  ]
}

故障排除

常见问题

扩展无法安装

  • 检查网络连接
  • 验证扩展兼容性
  • 清除扩展缓存
  • 重启 Trae IDE

扩展无法启用

  • 检查依赖项是否满足
  • 查看错误日志
  • 验证扩展完整性
  • 重新安装扩展

性能问题

  • 禁用不必要的扩展
  • 检查扩展资源使用
  • 更新到最新版本
  • 报告性能问题

无法从市场安装特定版本的扩展

如果扩展的某个版本依赖于较新版本 VS Code 的某些 API,可能会导致与 Trae 的兼容性问题。您可以检查扩展的版本历史并下载较早的版本。

扩展冲突

当多个扩展提供相似功能时可能发生冲突:

  1. 识别冲突的扩展
  2. 禁用其中一个扩展
  3. 检查扩展设置
  4. 联系扩展开发者

调试扩展问题

  1. 打开开发者工具(F12)
  2. 查看控制台错误
  3. 检查扩展日志
  4. 启用详细日志记录

扩展开发

开发环境设置

bash
# 安装扩展开发工具
npm install -g @trae/extension-cli

# 创建新扩展项目
trae-ext create my-extension
cd my-extension

# 安装依赖
npm install

# 启动开发模式
npm run dev

扩展结构

my-extension/
├── src/
│   ├── extension.ts      # 主入口文件
│   ├── commands/         # 命令实现
│   └── providers/        # 语言服务提供者
├── package.json          # 扩展清单
├── tsconfig.json        # TypeScript 配置
└── README.md            # 说明文档

发布扩展

bash
# 打包扩展
npm run package

# 发布到市场
npm run publish

最佳实践

扩展选择

  1. 评估需求:只安装真正需要的扩展
  2. 检查评分:选择高评分和活跃维护的扩展
  3. 阅读文档:了解扩展功能和配置
  4. 测试兼容性:确保扩展与您的工作流兼容

性能优化

  1. 定期清理:卸载不再使用的扩展
  2. 监控性能:关注扩展对启动时间的影响
  3. 配置优化:调整扩展设置以提高性能
  4. 分组管理:为不同项目使用不同的扩展配置

安全考虑

  1. 验证来源:只从可信来源安装扩展
  2. 检查权限:了解扩展请求的权限
  3. 定期更新:保持扩展为最新版本
  4. 报告问题:及时报告安全问题

相关文章

您的终极 AI 驱动 IDE 学习指南