为什么选择 Cursor？
Cursor 是一款基于 VS Code 构建的 AI 驱动 IDE，它把 AI 能力深度集成到编辑器的每个角落。与 GitHub Copilot 相比，Cursor 的 AI 理解整个代码库的上下文，而不只是当前文件。对于日常开发者来说，Cursor 能让你的编码效率提升 2-3 倍。
本教程将带你完成安装配置，并掌握 Cursor 最核心的 AI 功能。
安装与初始配置
### 下载安装
- 访问 cursor.com，点击「Download」
- 选择对应操作系统（Windows/Mac/Linux）下载安装包
- 安装完成后，Cursor 会提示你导入 VS Code 配置
### 从 VS Code 迁移
如果你之前用 VS Code，Cursor 支持一键导入： 1. 打开 Cursor，进入 `File > Preferences > Import VS Code Settings` 2. 选择导入插件、快捷键、主题等配置 3. 你的 VS Code 插件会自动安装到 Cursor
Cursor 完全兼容 VS Code 插件市场，所有你熟悉的插件都能继续使用。
### 登录账号
Cursor 需要账号才能使用 AI 功能： 1. 点击右上角头像，选择「Sign In」 2. 使用 GitHub 或 Google 账号登录 3. 免费版每月有一定的 AI 使用额度，Pro 版 $20/月无限使用
核心功能一：Tab 补全
这是 Cursor 最基础也最常用的功能。当你输入代码时，Cursor 会自动预测你接下来要写什么，按 Tab 键接受建议。
与普通代码补全不同，Cursor 的 Tab 补全理解你的意图： - 你写了函数签名，它会补全整个函数体 - 你修改了一处逻辑，它会预测其他需要同步修改的地方 - 它会根据你的代码风格和项目约定来生成代码
**技巧**：按 Tab 接受整个建议，按 `Ctrl+→` 只接受一个词。
核心功能二：Cmd+K（行内编辑）
`Cmd+K`（Mac）或 `Ctrl+K`（Windows）是 Cursor 最强大的功能之一。选中一段代码，按下快捷键，输入你的指令，AI 会直接修改代码。
**常用场景：**
选中一个函数，按 Cmd+K，输入： - 「添加错误处理」→ 自动加上 try-catch - 「添加 TypeScript 类型」→ 自动推断并添加类型注解 - 「优化性能」→ 重构为更高效的实现 - 「添加单元测试」→ 生成对应的测试代码 - 「翻译注释为中文」→ 批量翻译代码注释
不选中代码直接按 Cmd+K，可以让 AI 在光标位置生成新代码。
核心功能三：Chat 面板
按 `Cmd+L`（Mac）或 `Ctrl+L`（Windows）打开 Chat 面板，这是一个了解整个代码库的 AI 助手。
### 引用代码
在 Chat 中，你可以用 `@` 符号引用： - `@文件名` — 引用特定文件 - `@文件夹` — 引用整个目录 - `@代码库` — 引用整个项目 - `@文档` — 引用官方文档（支持 React、Next.js 等）
### 实用问法
``` @src/api/users.ts 这个文件的 getUserById 函数有什么潜在的安全问题？
@整个代码库 帮我找出所有没有错误处理的 async 函数
@src/components 帮我分析这些组件的依赖关系，画出依赖图 ```
核心功能四：Composer（多文件编辑）
按 `Cmd+I`（Mac）或 `Ctrl+I`（Windows）打开 Composer，这是 Cursor 最强大的功能——它可以同时修改多个文件。
**典型使用场景：**
- 「帮我添加用户认证功能」— Composer 会同时修改路由、中间件、数据库模型等多个文件
- 「把这个 JavaScript 项目迁移到 TypeScript」— 批量转换所有文件
- 「按照 @设计稿.png 实现这个页面」— 根据截图生成完整页面代码
Composer 会展示所有计划修改的文件，你可以逐一审查后再应用。
自定义规则（.cursorrules）
在项目根目录创建 `.cursorrules` 文件，可以告诉 Cursor 你的项目规范：
``` 你是一个 TypeScript 专家，遵循以下规范： - 使用函数式组件，不使用 class 组件 - 所有异步操作使用 async/await，不使用 .then() - 错误处理使用 Result 类型，不抛出异常 - 变量命名使用 camelCase，组件使用 PascalCase - 每个函数必须有 JSDoc 注释 ```
这样 AI 生成的所有代码都会自动遵循你的规范。
常用快捷键速查
| 功能 | Mac | Windows | |------|-----|---------| | 接受 Tab 补全 | Tab | Tab | | 行内 AI 编辑 | Cmd+K | Ctrl+K | | 打开 Chat | Cmd+L | Ctrl+L | | 打开 Composer | Cmd+I | Ctrl+I | | 接受 Diff | Cmd+Y | Ctrl+Y | | 拒绝 Diff | Cmd+N | Ctrl+N |
小结
Cursor 的核心价值在于 AI 对整个代码库的理解能力。建议按照 Tab 补全 → Cmd+K → Chat → Composer 的顺序逐步上手，每个功能都熟练后再学下一个。配置好 `.cursorrules` 文件，能让 AI 生成的代码更符合你的项目规范，减少后期修改。
