术语图鉴/Vibe Coding/规则文件
切换Esc返回

规则文件 Rules File (.cursorrules / AGENTS.md)

你可能会说

写个项目规则文件,告诉 AI 代码风格和禁忌。

放在项目里的「说明书」,告诉 AI 这个项目的规矩——用什么框架、代码风格、禁忌事项。

放在项目里的「说明书」,告诉 AI 这个项目的规矩——用什么框架、代码风格、禁忌事项。AI 每次干活前都会先读它。

也常被叫作.cursorrules / AGENTS.md

生活类比

像新员工手册——入职第一天读一遍,就知道公司怎么做事、什么不能碰。

🎮 动手试试

# 项目规则
- 使用 TypeScript
- 组件: 函数式 + hooks
- 样式: Tailwind CSS
- 禁止: any, var, class组件
选择题选择一个你认为最合适的答案

关于「规则文件」,以下哪个描述最准确?

你可以这样告诉 AI

帮我写一份 AGENTS.md:项目用 Next.js 加 Tailwind,TypeScript 严格模式,命名用 camelCase,不要用 any 类型。

容易混淆?这样区分

规则文件 Rules File (.cursorrules / AGENTS.md)
提示 提示

规则文件是持久化的全局配置(每次对话都生效),提示是单次的即时指令(只对当前对话有效)。

什么时候用

新项目接入 AI 工具

在项目根目录放规则文件,告诉 AI 你的技术栈、代码风格和禁忌,每次对话自动生效。

和 AI 协作时

对 AI 说「先读一下 AGENTS.md,然后按项目规则实现这个功能。」

什么时候不用

过度约束

规则文件写太长反而让 AI 抓不住重点,控制在关键几条即可,不要写成流水账。

不使用 AI 编程工具的项目

不用 Cursor、Copilot 等 AI 工具的项目不需要规则文件。

组成结构 · Anatomy

1
核心概念Core

放在项目里的「说明书」,告诉 AI 这个项目的规矩——用什么框架、代码风格、禁忌事项。AI 每次干活

2
实际表现In Practice

像新员工手册——入职第一天读一遍,就知道公司怎么做事、什么不能碰。

3
与 AI 的关联AI Context

和 AI 沟通时提到「读一下 AGENTS.md」,就是让它遵守你定的项目规则。

典型使用场景

定项目规范
告诉 AI「帮我生成 .cursorrules 文件,规定用 pnpm 不用 npm、组件用函数式写法、提交前跑 lint」
想弄懂概念时
告诉 AI「用大白话给我解释什么是规则文件,举个生活中的例子」

延伸阅读