为什么 Cursor 不仅仅是"更好的 Copilot"
Cursor 基于 VS Code 深度改造，将 LLM 深度嵌入编辑器工作流。与 GitHub Copilot 的补全模式不同，Cursor 的 Agent 模式可以自主理解需求、读写多个文件、执行终端命令——更像一个能看懂你代码库的协作者。
技巧一：用 .cursorrules 定义 AI 的编码风格
在项目根目录创建 .cursorrules 文件，约束 AI 的输出行为：
# .cursorrules 示例
- 使用 TypeScript 严格模式，禁止 any 类型
- 函数必须添加 JSDoc 注释
- 优先使用函数式写法，避免 class
- 错误处理统一使用 Result 类型而非 throw
- 测试文件放置在 __tests__ 目录，使用 Vitest
这相当于给 AI 设置了团队编码规范，让每次生成的代码风格一致。
技巧二：精准引用上下文（@符号体系）
| 引用方式 | 示例 | 作用 |
|---|---|---|
@文件 | @src/utils/api.ts | 引入特定文件内容 |
@目录 | @components/ | 引入整个目录结构 |
@代码 | @getUserById | 引入特定函数/类 |
@文档 | @Docs | 引入自定义文档 |
@Web | @Web | 实时搜索网络 |
@Git | @Git | 引入 Git 变更记录 |
根据 @src/types/user.ts 的类型定义，为 @src/api/users.ts 补全所有缺失的 CRUD 方法技巧三：Agent 模式处理跨文件重构
按 Cmd+I 启动 Agent 对话，让 AI 自主完成多文件操作：
将项目中所有使用 axios 的地方替换为 fetch API，
保持相同的错误处理逻辑，更新对应的类型定义
Agent 会自动扫描文件、批量修改、并在终端验证结果。
技巧四：Ctrl+K 内联编辑精准修改
选中一段代码后按 Ctrl+K，可以对选中区域进行精准指令修改，不影响周围代码：
// 选中这个函数后按 Ctrl+K：
// "将此函数改为异步，添加错误处理，返回 Result 类型"
技巧五：Tab 补全的多行跳转
Cursor 的 Tab 不只是当前行补全——它会预测你接下来要做的事情，按 Tab 直接跳转到下一个编辑位置，形成连续的编辑流。
技巧六：在 Chat 中运行并调试
在 Cursor Chat 中可以直接让 AI 分析终端错误：
@terminal 报了以下错误，帮我找到根本原因并修复：
[粘贴错误信息]
技巧七：自定义 AI 文档（Docs）
在设置中添加自定义文档 URL（如内部 API 文档、框架文档），AI 会实时检索：
Settings → Features → Docs → Add new doc之后通过 @Docs 引用，AI 就能基于你的私有文档回答问题。
技巧八：Notepads 跨对话记忆
Notepads 是 Cursor 的持久化笔记本，可以跨会话保留项目背景、架构决策、技术债务等：
# 项目背景.md
- 后端：FastAPI + PostgreSQL
- 前端：Next.js 14 App Router
- 部署：Vercel + Railway
- 关键约束：API 响应必须 < 200ms
在每次对话开头引用 @Notepad/项目背景，AI 始终了解项目全貌。
技巧九：Shadow Workspace 安全测试
Agent 模式下，Cursor 会先在影子工作区（Shadow Workspace）执行危险操作，通过 lint/test 后再应用到真实文件，有效避免误操作。
技巧十：结合 Git 做 Code Review
@Git 分析最近 3 次提交的变更，识别潜在的性能问题和安全风险，
输出结构化的 Code Review 报告
小结
Cursor 的核心价值在于将 AI 从"行级补全"提升到"项目级协作"。善用 .cursorrules 统一风格、用 @ 精准提供上下文、用 Agent 模式处理跨文件任务，是提升效率的三个关键杠杆。