.cursorrules 配置
.cursorrules 用来定义项目级别的长期规则,让 Cursor 在每次对话中都遵循你的技术栈、代码风格和约束。
#规则层级
Cursor 的规则优先级为:
Team Rules → Project Rules → User Rules
.cursorrules 属于 Project Rules,作用于当前项目。
#规则类型
在 Cursor 中可以创建两种规则:
- Always Apply:每次对话都生效
- Apply Manually:需要手动选择后才生效
你可以在 Cursor Settings > Rules, Commands 中创建、管理规则。
#快速创建规则
在命令面板搜索并执行:
New Cursor Rule
或在 Rules 页面点击 + Add Rule 创建规则。
#.cursorrules 示例
markdown# Project Rules ## Tech Stack - Next.js 14 App Router - TypeScript - Styled-components - Jest for tests ## Code Style - Use functional components with hooks - Prefer named exports - Use async/await for async logic ## Testing - Add unit tests for new utilities - Avoid snapshot tests unless necessary ## Output - Respond in Chinese - Keep code comments concise
#最佳实践
- 规则写得越具体,输出越稳定
- 只写项目长期约束,避免临时需求
- 对团队项目,优先用 Team Rules 统一规范