需在项目根目录创建.cursorignore文件排除node_modules/、dist/、.env、.pem等,并为monorepo添加packages//node_modules/;再建.cursor/rules目录,放入architecture.mdc、naming.mdc等规则文件,按globs匹配文件类型分角色启用frontend.mdc、backend.mdc、testing.mdc;最后将.cursor提交至git并文档说明。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

让团队里每个人的Cursor AI助手都按同一套规范写代码,避免合并时出现命名不一致、目录乱建、错误处理缺失等问题,需要把口头约定变成机器可执行的规则文件。
先排除干扰项:写好.cursorignore
第一步不是写规则,而是告诉Cursor哪些文件不该看。直接在项目根目录新建 .cursorignore 文件,粘贴以下内容:
【node_modules/、dist/、.env、*.pem 这几行必须保留】 ——漏掉任何一个,AI就可能参考构建产物或密钥生成危险代码。
这一步操作起来很简单,直接把文件拖进去就行。但要注意:monorepo 项目要额外加一行 packages/*/node_modules/,否则跨包索引会变慢且易出错。
再定义团队底线:用.cursor/rules目录固化规范
在项目根目录创建 .cursor/rules 文件夹(注意是 rules,不是 rules.json 或 .cursorrules),然后往里放几个关键规则文件:
方法一:复制开源模板快速启动
打开终端,执行:mkdir -p .cursor/rules && curl -sL https://raw.githubusercontent.com/Renvia-code/best-cursor-rules/main/en/.cursor/rules/architecture.mdc -o .cursor/rules/architecture.mdc
方法二:手写最小可行规则
新建 .cursor/rules/naming.mdc,内容如下:
---
description: "团队命名规范"
globs: ["src/**/*.{ts,tsx,js,jsx}"]
---
- 组件名用 PascalCase
- 工具函数用 camelCase
- 文件名与默认导出名严格一致
- 禁止使用下划线命名
这个文件必须放在 .cursor/rules/ 下,不能放在子目录里——Cursor只认这个路径。
分角色控制输出边界:按需启用不同规则
第一步:识别当前编辑的文件类型
Cursor 会自动匹配 globs 字段,比如你正在编辑 src/api/user.ts,它就会加载所有 globs 包含 **/*.ts 的规则文件。
第二步:给前端/后端/测试人员分配不同规则集
① 前端工程师:在 .cursor/rules/frontend.mdc 中写入:globs: ["src/components/**", "src/pages/**"]
并强制要求组件必须有 TypeScript 类型定义和 ARIA 属性。
② 后端工程师:新建 .cursor/rules/backend.mdc,设置:globs: ["src/server/**", "src/routes/**"]
并声明所有 API 返回值结构统一为 { error: 0, message: '', data: {} }。
③ 测试工程师:单独建 .cursor/rules/testing.mdc,要求:
“每个新功能必须先生成 Jest 测试用例,覆盖等价类和边界值”。
这些文件互不冲突,Cursor 会自动叠加生效。但注意:【同一目录下不能有两个 globs 完全相同的规则文件】,否则行为不可预测。
让新人立刻上手:把规则纳入 Git 提交流程
把整个 .cursor 文件夹提交到 Git,确保新成员克隆仓库后无需任何配置就能获得完整规则。
在 README.md 里加一句说明:“本项目使用 Cursor Rules 强制执行架构分层和命名规范,所有 AI 生成代码均受约束”。
这一步做完,团队协作时 AI 输出的代码风格、目录结构、错误处理方式就完全统一了。










