什么是 Rules
Rules 是一项强大的代码规范管理工具,允许团队或开发者自定义并强制执行代码风格和最佳实践。
在使用 AI 编程时,你是否希望拥有一个专属的 AI 工程师?Rules 功能正是为了解决频繁重复输入同类指令的痛点——比如每次都要强调语言风格、框架约束、注释格式等。通过提前设定行为规范,AI 每次响应时会自动读取这些预设规则,无需反复提醒即可输出符合预期的内容。不同开发场景下,对应的 Rules 能让 AI 精准适配当前任务的技术要求,大幅提升效率。
使用说明
更新至 0.5.1 及以上版本后,Trae IDE 支持两种类型的规则:
个人规则
基于个人使用习惯和需求定制,旨在让 AI 的输出更符合用户的个性化要求。个人规则在所有项目中生效。
- 语言风格:偏好简洁、严谨或幽默等表达方式。
- 操作系统:提供针对 Windows 或 macOS 的回答。
- 内容深度:是否需要详细解释、示例或仅需结论。
- 交互方式:倾向于直接答案还是引导式提问。
项目规则
针对当前项目 AI 需要遵循的规则,仅在所配置的项目中生效。
- 代码风格:缩进(空格/制表符)、命名规范(驼峰式/snake_case)等。
- 语言与框架:优先使用的编程语言(如 Python/JavaScript)或框架(如 React/Django)。
- API 限定:勿使用某些 API。
下面我们来演示如何设定 AI 规则。
创建个人规则
- 在 AI 对话窗口右上角,点击
设置图标 >规则。 - 界面上显示
规则窗口,在个人规则部分,点击+ 创建 user_rules.md按钮。 - 系统自动创建 user_rules.md 文件并在编辑器中打开。
- 在文件中输入 AI 需要遵守的规则,保存后规则将应用于所有项目的 AI 行为。

创建项目规则
- 打开一个项目。
- 在 AI 对话窗口右上角,点击
设置图标 >规则。 - 在
项目规则区域,点击+ 创建 project_rules.md按钮。 - 系统自动在项目目录中创建
.trae/rules文件夹,并在该文件夹内创建 project_rules.md 文件。 - 在文件中输入 AI 需要遵守的规则,保存后规则将应用于当前项目的 AI 行为。

管理规则
在 规则 窗口中,你可以修改个人规则和项目规则,也可以删除规则文件。修改后 AI 将遵守新规则;删除规则文件后,原先定义的所有规则将失效。

实战演示
假设我们想要使用 Chakra 来优化 CSS,可以通过以下提示词配置项目规则和个人规则。
项目规则

个人规则

在完成设定后,使用 @Builder 对项目进行整体优化:

可以看到,Builder 已经按照设定的项目规则完成了优化改造。

应用场景
Rules 功能可以在各种开发场景中发挥作用,帮助团队和个人保持代码一致性、提高可维护性,并减少低级错误。
团队协作与代码审查
统一代码风格,减少审查争论。新加入的开发者可能不熟悉团队的代码风格,通过设定 Rules 可以实现检查变量名、强制使用团队代码架构、修正不合规代码。同时还能帮助团队成员代码格式化、禁止错误写法并强制注释规范。
项目维护与代码质量
检测代码错误,提高可维护性。针对遗留代码风格混乱的问题,通过逐步引入规则,配合 AI 对话指令可完成修复,并标记不符合新规范的代码以便后续重构。为防止低级错误,可通过强制 await 用 try-catch 包裹、检测未使用的 import 或变量、禁止使用 == 并强制使用 === 等规则,减少潜在问题。
特定技术栈优化
强化 React/Vue/Node 最佳实践。前端项目中组件写法不一致导致维护困难,通过设定 Rules 可以强制函数式组件(禁止 class 组件)、要求 props 必须做类型检查以及强制 useEffect 依赖项必须完整。针对 API 接口风格不统一的问题,Rules 可以强制 REST API 路径格式,要求错误处理必须标准化,并禁止 console.log,强制使用日志库。
安全与合规性
防止漏洞,满足行业规范。针对 SQL 注入、XSS 等安全隐患,Rules 可以通过禁止直接拼接 SQL(强制使用参数化查询)、检测未转义的 HTML 输出以及禁止使用 eval() 或 new Function() 等方式,有效防范安全漏洞。同时可检测敏感信息、强制加密存储密码并确保日志不记录个人身份信息。
个人开发习惯优化
保持一致性,学习新语言更高效。如果开发者希望保持一致的代码风格,可以通过设定 Rules 来实现。在初学 Rust/Go/Python 时,容易写出不符合语言习惯的代码,通过设定 Rules 强制 Rust 的 Result 处理、强制 Go 的错误处理和 Python 强制类型注解,可以帮助改善这一问题。

