Cursor 实战:让AI真正读懂你的项目
Cursor 的上限不取决于模型,而取决于你给它的上下文。用规则文件、精确引用与小步任务,把「AI乱改」变成「AI按你的规范改」。
AI之家X编辑部 2026/10/27 4 分钟阅读2 次阅读
先解决「乱改」问题
新手用 Cursor 最常见的挫败:让它改一个按钮样式,结果它顺手重构了三个文件。
原因通常有两个:你没告诉它项目规范,以及任务颗粒度太大。
一、写一份项目规则文件
在项目根目录建 .cursor/rules(或在设置里配置 Project Rules),写清楚:
技术栈:Next.js 14 App Router + TypeScript + Tailwind
目录约定:
- 页面放 src/app,组件放 src/components
- 数据访问统一走 src/lib/db.ts,禁止在组件里直接连数据库
- 所有接口返回 { ok, data, error } 结构
代码规范:
- 不使用 any,必要时用 unknown 收窄
- 组件使用函数式,props 显式定义类型
- 样式只用 Tailwind,不写内联 style
禁止:
- 不擅自新增依赖
- 不修改 .env 与数据库 schema
- 不删除已有注释
这份文件的价值在于:每次对话都自动带上,不用重复解释。
二、用 @ 精确指定上下文
不要让它「猜哪个文件相关」。手动引用:
@文件:指定具体文件@文件夹:指定目录@Code:选中代码片段@Docs:引入框架文档
一个任务只引用必要的 3–5 个文件。引用太多反而稀释注意力。
三、任务拆到「一次能验收」
不好的任务:
帮我做一个用户中心
好的任务:
在 src/app/account/page.tsx 新增用户中心页面。只做三件事:1)读取当前登录用户;2)展示昵称、邮箱、注册时间;3)提供「退出登录」按钮调用 /api/auth/logout。不要加其他功能,不要改布局组件。
每个任务都应该能用一句话说清「做完的标准」。
四、用 Composer 做多文件修改
Composer 适合「跨文件但边界清晰」的任务,比如:
把所有 API 路由的错误处理统一改成 try/catch + { ok:false, error } 格式,涉及 src/app/api 下的所有 route.ts。改完后列出修改的文件清单。
执行前先看它的计划,确认没有多余改动再点接受。
五、把测试当验收器
让 AI 写代码的同时写测试:
为 src/lib/search.ts 的 searchTools 函数补单元测试,覆盖:空关键词、特殊字符、分页边界、无结果四种情况。用项目已有的 vitest。
测试通过,才算完成。这比人眼 review 更可靠。
六、三个提效技巧
- Tab 补全用于重复模式:改完一个类似的函数,跳到下一个位置按 Tab,它会预测你的修改
- 对话中随时回滚:每次接受修改前,确认 git 是干净的,出问题直接 discard
- 长任务分阶段提交:每完成一个小目标就 commit,AI 出错时回退成本低
七、必须人工把关的地方
- 数据库迁移与索引变更
- 权限与鉴权逻辑
- 支付、计费、对账
- 涉及用户数据的删除操作
- 第三方 API 的密钥处理
这些地方的错误代价高,AI 的「看似合理」最危险。
一个心态
把 AI 当成一个速度很快但需要明确指令的初级工程师:它能高质量执行清晰的任务,但不能替你决定做什么、为什么做。
架构和取舍,仍然是你的工作。
文中提到的工具
#Cursor#AI编程#工作流
返回教程列表本文由 AI之家X编辑部撰写,基于实际使用与公开资料整理。文中涉及的第三方产品价格、功能与政策可能调整,请以官方页面为准。 如发现事实错误,欢迎通过反馈入口指正。