Cursor Rules 示例 2026：Python、React、数据工程的 12 条真实规则

人人都在说写规则，但好的规则到底长什么样？这 12 条真实示例覆盖 Python、React 和数据工程，抄下来改改就能用。

💡 你将学到

人人都在说写规则，但好的规则到底长什么样？这 12 条真实示例覆盖 Python、React 和数据工程，抄下来改改就能用。

📜 目录

• 规则也是代码，抄好的部分
• Python
• React / TypeScript
• 数据工程
• 怎么改造
• 格式要点

规则也是代码，抄好的部分

awesome-cursorrules（40,569 stars，2026-08-13 实测）里全是可用示例，但大多太长。下面 12 条是从真实项目里提炼的短规则，按技术栈分组。

Python

1. 强制类型注解：每个公开函数都有类型提示，内部辅助函数也不例外——这一条就能消灭一整类评审意见
2. DTO 用 dataclass：请求/响应载荷用 dataclass，超过 3 个键的 dict 升级为 dataclass
3. 异步边界：视图和处理函数都是 async，阻塞调用放线程池并注释原因
4. 测试命名：只用 pytest，test_功能_行为，用 parametrize 代替复制测试

React / TypeScript

1. 服务端组件优先：新页面默认 RSC，除非需要客户端状态；use client 只在边界显式声明
2. 禁止内联样式：用 Tailwind 类名，复用两次以上用 CSS Modules，不用 style prop
3. 每屏一个查询 hook：数据获取统一走 features/ 下的 React Query hook，组件里不写 fetch
4. 类型化 API 契约：每个 API 响应都有 zod schema，边界处解析，之后信任类型

数据工程

1. 一切幂等：每个管道任务都能安全重跑，按自然键 upsert，绝不盲目 insert
2. 代码里写血缘：每个转换函数 docstring 里声明输入/输出表名，不写魔法 SQL 字符串
3. 大数据小测试：单元测试用 10 行 fixture，集成测试标 @pytest.mark.integration 每晚跑
4. 代码里没有凭据：所有密钥来自环境变量或密钥管理，硬编码密钥直接 CI 失败

怎么改造

规则只有在匹配团队真实痛点时才有效。对 12 条逐条问：最近一个月评审有没有人说过这话？说了就留，没说就删。十条符合你历史的规则胜过五十条听起来不错的。

格式要点

新版 Cursor 把每条规则放 .cursor/rules/名称.mdc，frontmatter 里写 description 和 globs。glob 决定哪些文件看到这条规则——Python 规则不该出现在 .tsx 编辑会话里。

最快的路径：选 4 条符合你技术栈的，加进去，前后跑同一个任务对比。不改变输出的规则就是噪音，删掉。