技术文档中心

Appearance

Trae 开发者实战进阶指南 ​

任务提示词 ​

编写《Trae 开发者实战进阶指南》

Role / 角色设定 ​

你是一位全栈开发专家，同时是 AI IDE（如 Cursor, Trae, Copilot）的早期探索者。你对字节跳动的 Trae 编辑器有深入研究，擅长挖掘编辑器隐藏的配置项，并能总结出一套高效的“人机协作”流。

Task / 任务目标 ​

请为我编写一份针对 Trae 编辑器 的深度教程文档。重点在于如何通过优化设置和交互技巧，让 Trae 真正成为开发者的“副驾驶”而非简单的代码生成器。

Content Structure / 内容架构 ​

第一部分：环境优化——打造最强“战斗配置” ​

  • Context Selector 设置：如何配置 Trae 的上下文索引，确保它能理解整个代码仓库（Codebase）。
  • 自适应模式（Adaptive Mode）：详细解释如何开启并利用该模式让 AI 自动切换“思考”与“执行”状态。
  • 模型切换策略：针对不同任务（如逻辑重构 vs. 简单的 UI 调整），如何手动或自动选择最合适的底层模型。
  • 终端与编辑器联动：设置 Trae 自动捕获终端报错并尝试修复的配置技巧。

第二部分：交互艺术——如何给 Trae 下达“高质量指令” ​

  • Builder 模式 vs. Chat 模式：深度解析什么时候该用左侧聊天窗口，什么时候该用底部的全量构建模式（Composer 模式）。
  • 精准引用（The Power of @）：
    • @Files: 如何快速定位相关逻辑。
    • @Codebase: 处理跨模块引用时的最佳实践。
    • @Docs: 如何喂入第三方库的最新文档链接（尤其是不在训练集中的新框架）。
  • 多轮对话的“纠偏”技巧：当 Trae 理解偏离预期时，如何通过指令重新对齐（Re-aligning）目标。

第三部分：高阶技巧与隐藏玩法 ​

  • 一键式重构：利用 Trae 的全量编辑能力进行大规模目录结构调整。
  • 单元测试驱动开发 (TDD)：如何让 Trae 根据现有的 README.md 或需求文档直接生成测试用例并跑通逻辑。
  • Prompt 预设（.traerules）：编写一份通用的 .traerules 模板，规定 AI 必须遵循的命名规范、注释风格和架构原则。

第四部分：进阶补充（值得学习的额外维度） ​

除了基本交互，请深入探讨以下内容：

  • 多模态交互：如何利用截图/设计稿直接通过 Trae 生成前端代码。
  • 性能感知：如何提示 Trae 在生成代码时主动关注内存泄漏或 O(n) 复杂度问题。
  • 工作流集成：如何利用 Trae 辅助编写 Git Commit Message、生成 PR 描述或编写自动化脚本。

Format / 输出要求 ​

  • 使用 Markdown 格式，结构严谨，逻辑分明。
  • 所有的代码示例需支持语法高亮。
  • 包含具体的 Prompt 示例（例如：如何写一段完美的重构提示词）。
  • 对比表格：Trae 与传统 IDE 在某些场景下的效率对比。
  • 请在当前目录下添加一个文档（提示词文档.md），内容体为我这次输入的完整提示词
  • 同步更新到 themeConfig 里面的 sidebar 配置