管理扩展
在 Trae 中,您可以安装、禁用或卸载扩展。
安装扩展
您可以从 Trae 的扩展商店或 VS Code 的市场安装扩展,也可以通过将本地 .vsix 文件安装到 Trae IDE 中来直接安装扩展。
从 Trae 扩展商店安装
- 在左侧导航栏中,点击扩展商店图标。
- 扩展商店出现在左侧。
- 搜索您想要安装的扩展,并从可用列表中选择它。
- 选定扩展的详细信息窗口出现。您可以阅读其详细介绍、更新日志等。
- 点击安装按钮。
- Trae 开始安装扩展。安装完成后,扩展出现在已安装列表中。
从 VS Code 市场安装
注意:C/C++ 扩展和其他平台特定扩展无法使用此方法安装。您需要手动下载您正在使用的平台特定扩展的 VSIX 包。
如果 Trae 的扩展商店没有提供您想要的扩展,您可以从 VS Code 的市场将其安装到 Trae。
- 搜索您想要的扩展。例如,Deno。
- 从搜索结果中选择您想要的扩展。
- 这会将您导向扩展的详细信息页面。
- 在扩展的详细信息页面上,点击版本历史。
- 选择您想要安装的版本。
- 点击下载按钮下载 .vsix 文件。
- 在 Trae 中,打开扩展商店。
- 点击右上角的更多操作(三个点)按钮。
- 选择从 VSIX 安装。
- 选择您下载的 .vsix 文件。
- Trae 开始安装扩展。
从本地 VSIX 文件安装
- 在 Trae 中,打开扩展商店。
- 点击右上角的更多操作(三个点)按钮。
- 选择从 VSIX 安装。
- 浏览并选择您的 .vsix 文件。
- 点击安装。
扩展管理功能
扩展分类
扩展按以下类别组织:
- 编程语言:语言支持和语法高亮
- 调试器:调试工具和配置
- 格式化程序:代码格式化工具
- 键盘映射:键盘快捷键方案
- 代码片段:代码模板和片段
- 主题:颜色主题和图标主题
- 其他:其他实用工具
扩展状态
- 已安装:已安装并可用的扩展
- 已启用:当前活动的扩展
- 已禁用:已安装但未激活的扩展
- 需要重新加载:需要重启 IDE 才能生效的扩展
禁用扩展
在 Trae 中打开扩展商店。
在已安装列表中,找到您想要禁用的扩展。
将光标移动到扩展上,点击设置 > 禁用。
或者
点击扩展打开其详细信息窗口,然后点击禁用。
禁用选项
- 禁用:在所有工作区中禁用扩展
- 禁用(工作区):仅在当前工作区中禁用扩展
卸载扩展
在 Trae 中打开扩展商店。
在已安装列表中,找到您想要卸载的扩展。
将光标移动到扩展上,点击卸载。
或者
点击扩展打开其详细信息窗口,然后点击卸载。
扩展设置
配置扩展
大多数扩展提供可配置的设置:
- 打开设置(Ctrl/Cmd + ,)
- 搜索扩展名称
- 修改扩展特定的设置
- 设置会自动保存
扩展数据
扩展可以存储以下类型的数据:
- 全局状态:跨所有工作区的设置
- 工作区状态:特定于当前工作区的设置
- 密钥存储:安全存储敏感信息
扩展更新
自动更新
默认情况下,Trae 会自动更新扩展:
- 检查更新频率:每天
- 自动安装更新:是
- 更新通知:显示
手动更新
- 打开扩展商店
- 查看已安装列表中的更新标识
- 点击更新按钮
- 或点击全部更新更新所有扩展
版本管理
- 稳定版本:经过测试的稳定版本
- 预发布版本:包含最新功能的测试版本
- 特定版本:安装指定版本的扩展
扩展推荐
工作区推荐
在工作区根目录创建 .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 的兼容性问题。您可以检查扩展的版本历史并下载较早的版本。
扩展冲突
当多个扩展提供相似功能时可能发生冲突:
- 识别冲突的扩展
- 禁用其中一个扩展
- 检查扩展设置
- 联系扩展开发者
调试扩展问题
- 打开开发者工具(F12)
- 查看控制台错误
- 检查扩展日志
- 启用详细日志记录
扩展开发
开发环境设置
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最佳实践
扩展选择
- 评估需求:只安装真正需要的扩展
- 检查评分:选择高评分和活跃维护的扩展
- 阅读文档:了解扩展功能和配置
- 测试兼容性:确保扩展与您的工作流兼容
性能优化
- 定期清理:卸载不再使用的扩展
- 监控性能:关注扩展对启动时间的影响
- 配置优化:调整扩展设置以提高性能
- 分组管理:为不同项目使用不同的扩展配置
安全考虑
- 验证来源:只从可信来源安装扩展
- 检查权限:了解扩展请求的权限
- 定期更新:保持扩展为最新版本
- 报告问题:及时报告安全问题