Cursor 使用指南

Cursor 是一款基于 VS Code 的 AI 代码编辑器，集成了强大的 AI 编程能力，能够理解整个代码库上下文，帮助开发者更高效地编写代码。

什么是 Cursor

Cursor = VS Code + AI。它在 VS Code 的基础上深度集成了 AI 能力：

• 理解整个项目代码库（Codebase）
• 支持自然语言编写代码（Cmd+K）
• 支持对话式编程（Cmd+L）
• 支持自动补全（Tab）
• 支持代码库级别的检索（@Codebase）

安装

访问 cursor.sh 下载对应平台版本。

安装后可直接导入 VS Code 的配置和插件，迁移成本极低。

核心功能

1. Tab 自动补全

Cursor 的 Tab 补全不只是补全当前行，它能：

• 预测你下一步要改哪里（多位置编辑提示）
• 根据上下文理解你的意图
• 按 Tab 接受建议，Esc 拒绝

2. Cmd+K：内联编辑

选中代码后按 Cmd+K（Windows: Ctrl+K），用自然语言描述你想做什么：

选中一段代码，输入：
"把这个函数改成 async/await 写法"
"添加错误处理"
"优化性能，减少不必要的计算"

3. Cmd+L：对话式编程

打开 Chat 面板，可以：

• 问问题：这个函数的时间复杂度是多少？
• 写代码：帮我写一个 Redis 缓存工具类
• 调试：为什么这段代码会报 NPE？

使用 @ 引用上下文：

• @Codebase - 搜索整个代码库
• @Files - 引用特定文件
• @Folders - 引用整个目录
• @Web - 搜索网络文档

4. Composer（Cmd+I）

多文件编辑模式，适合较大规模的重构：

"把 user.service.js 和 order.service.js 里的数据库查询统一改成使用 Prisma"

实用技巧

编写 .cursorrules

在项目根目录创建 .cursorrules 文件，告诉 Cursor 你的编码规范：

# 项目规则

- 使用 TypeScript，禁止 any 类型
- 使用 async/await，禁止 .then()
- 函数名使用驼峰命名
- 每个函数不超过 50 行
- 使用 Prisma 作为 ORM

使用 @Codebase 提问

@Codebase 我们的认证逻辑是在哪里实现的？
@Codebase 找出所有操作 user 表的 API 接口

让 AI 先解释再修改

不要直接让 AI 改代码，先让它解释：

先解释一下这段代码的执行流程，然后帮我优化性能

与其他工具对比

功能	Cursor	GitHub Copilot	Claude Code
代码补全	✅ 强	✅ 强	❌
对话编程	✅	✅	✅
代码库理解	✅ 强	❌	✅ 强
多文件编辑	✅	❌	✅
免费额度	有限	付费	有限

注意事项

• Cursor 会将代码发送到云端处理，请勿在敏感项目使用
• Tab 补全有时会过度预测，保持警惕
• AI 生成的代码务必人工 review
• .cursorrules 文件可以显著提升生成质量

相关资源

• 官方网站
• 文档
• 变更日志