Trae Rules：一劳永逸的 AI 编程规范指南

用 Trae 写代码，AI 的效率确实高。但你是否也遇到这些烦恼？
• 每次新建对话，都要提醒：“注释请用中文！”
• 每次开始编码，都要强调：“遵守我们团队的命名规范！”
• 每次写新功能，都要补充：“别用已过时的 API！”
• 团队新人用 Trae，写出来的代码风格和老人完全不同。

一句话重复十遍，AI 记不住，人也嫌麻烦。

💡 今天要讲的 Rules，就是专注于解决 “按什么标准执行” 的问题。

💡 可以这样理解：Hook 是生产线上的插槽，让你能在特定环节插入操作；Rules 则是生产线上的模具，确保所有产出都符合统一规格。

01 什么是 Rules？

一句话定义

💡 Rules，就是预设给 AI 的行为规范。 一旦设置，打开 Trae 即自动生效，无需你再口头提醒。

你可以把它想象成公司的 《员工手册》。新员工入职第一天就要阅读，里面明文规定了着装、考勤和汇报格式。你不需要每天早晨对每位下属说“请穿工装”或“请准时上班”，因为规则已存在，入职就生效。Rules，就是你的 AI 助理的《员工手册》。

两种规则类型

Trae 支持两种规则，适用场景大不相同：

简单记忆：个人规则管理“你这个人”，项目规则管理“这个项目”。

02 个人规则：你的专属AI偏好设置

适合写什么？

个人规则解决的是 “无论在哪个项目，我都希望AI这样做” 的普遍性问题：
• 回答语言（恒定使用中文）
• 代码注释风格（例如，函数需有文档级注释，复杂逻辑加行内解释）
• 回复详细程度（直接给方案，还是详细解释原理）
• 操作系统适配（针对 Windows 或 macOS 给出特定命令）

怎么上手创建？

方法一：通过界面操作

1. 打开 Trae，进入任意项目。
2. 点击 AI 对话窗口右上角的 设置图标 → 规则。
3. 在“个人规则”区域，点击 + 创建 user_rules.md。
4. 在打开的文件写入你的规则。
5. 保存，规则立即生效。
   
   方法二：直接创建文件
   在你的用户主目录（如 ~/）下，直接创建一个名为 user_rules 的 .md 文件，写入规则即可。

推荐配置模板

你可以参考或直接使用下面的模板起步：

# 个人规则

## 基本偏好
1. 始终使用中文进行交流。
2. 生成代码时，为函数添加清晰的注释。
3. 单个函数代码超过20行时，应考虑拆分。

## 代码风格
4. 包管理工具优先使用 pnpm。
5. 项目语言优先选择 TypeScript。
6. 变量命名采用 camelCase，常量命名采用 UPPER_SNAKE_CASE。

## 回复风格
7. 请先总结结论，再展开解释过程。
8. 对于广为人知的基础概念，请直接给出解决方案。

03 项目规则：团队的“编码宪法”

为什么需要它？

个人规则管理“习惯”，项目规则则聚焦于“标准”。想象一下：如果团队里5个人各自使用 Trae，指令五花八门——
• 张三要求：“使用 Vue 3 组合式 API。”
• 李四要求：“使用 React Hooks。”
• 王五不提要求，让 AI “随机发挥”。
结果必然是：同一个项目，AI 生成的代码风格千差万别，难以维护。

项目规则正是为此而生：确保无论团队中谁来写代码，AI 产出都符合同一套团队标准。

怎么上手创建？

方法一：通过界面操作

1. 打开目标项目。
2. 点击 AI 对话窗口右上角的 设置图标 → 规则。
3. 在“项目规则”区域，点击 + 创建 project_rules.md。
4. 系统会自动在项目根目录创建 .trae/rules/project_rules.md 文件。
5. 写入团队规范后，将该文件提交到 Git 仓库，即可实现全组共享与同步。

方法二：让 AI 帮你生成
如果你已经有现成的团队规范文档，可以直接请 AI 协助转换：

💡 “我想把这份《XX团队规范文档》转化为 Trae 的项目规则。请帮我提炼核心、精简语言，并写入 project_rules.md 文件。”

AI 会自动提取关键规则，并生成格式化的规则文件。

推荐配置模板

下面是一个项目规则的示例框架：

# 项目规则

## 技术栈
- 框架：Vue 3 + TypeScript
- 状态管理：Pinia
- 样式方案：Tailwind CSS
- 包管理器：pnpm

## 代码规范
1. 强制使用组合式 API（`` 语法）。
2. 组件文件采用 PascalCase 命名（如 `MyComponent.vue`）。
3. 每个组件必须导出明确的 `Props` 类型定义。
4. 禁止使用 `any` 类型。

## Git 协作规范
5. 提交信息 (Commit Message) 必须遵循 Conventional Commits 格式。
6. 示例：`feat: 新增用户登录功能`

## 安全红线
7. 代码中禁止硬编码 API Key、密码等敏感信息。
8. 所有来自用户的输入，必须进行校验与清理。
9. 敏感配置信息必须使用环境变量。

04 进阶：灵活管理多条规则

单一巨型规则文件的瓶颈

许多初次使用者常犯一个错误：将所有规则堆砌在一个文件中。 这会导致三个典型问题：

解决方案：拆分为多个规则文件

建议按关注点将规则模块化：

.trae/rules/
├── project_rules.md          # 主规则（始终生效，定义基础架构与核心约定）
├── code-style.md             # 代码风格细则（编写代码时生效）
├── git-commit.md             # Git 提交规范（执行 git commit 操作时生效）
└── security.md               # 安全审查规则（进行安全相关操作时生效）

智能上下文感知

Trae 的规则加载并非“一股脑全上”，它支持上下文感知，能根据你当前的工作内容，智能匹配应生效的规则：

此外，规则支持使用 必须、应该、可以 三级指令关键词来。

好了，现在开始在你的Trae编辑器里给它设置规矩吧，祝您coding愉快！！！