Cursor - AI 代码编辑器

Cursor 是一款现代的 AI 原生代码编辑器，内置了 GPT-4、Claude 及推理模型。它提供智能代码补全、对话驱动开发、多文件编辑和项目感知重构等功能。

🔗 官方网站 →

什么是 Cursor？

Cursor 是一款 AI 原生代码编辑器（兼容 VS Code），它能理解你的项目、根据上下文补全代码、进行行内对话，并能协调地编辑多个文件。它不仅仅是自动补全，更是一个集成在编辑器中的 AI 结对编程伙伴。

核心亮点

• 编辑器内的对话驱动式编程
• 项目感知的智能补全（按 Tab 键采纳）
• 全库理解（对你的代码仓库进行索引）
• 完全兼容 VS Code 扩展和快捷键

订阅方案

• 免费版 (Free)：核心功能，适用于学习和轻度使用
• 专业版 (Pro)（$20/月）：无限次补全、更快的模型、多文件编辑
• 企业版 (Business)（$40/用户/月）：管理控制、强制隐私模式、SSO、审计日志、优先支持

核心功能

1) Cursor Tab (智能补全)

# 你输入：
def calculate_fibonacci(

# Cursor 补全：
def calculate_fibonacci(n: int) -> int:
   """计算第 n 个斐波那契数。"""
   if n <= 1:
      return n
   return calculate_fibonacci(n-1) + calculate_fibonacci(n-2)

亮点：

• 理解文件和仓库上下文
• 预测意图并支持多行补全
• 具备竞争力的准确性和速度

2) Cmd/Ctrl + K (行内编辑)

选中代码 → Cmd/Ctrl + K → 输入指令

示例：
"添加错误处理"
"优化此函数"
"添加类型提示"
"转换为异步 (async)"
"添加单元测试"

Cursor 会直接在选中的代码上应用修改。

3) Cursor Chat (行内助手)

你：如何实现 LRU 缓存？

Cursor：
这是一个 LRU（最近最少使用）缓存的实现：

[生成的代码]

class LRUCache:
   def __init__(self, capacity: int):
      ...
    
   def get(self, key: int) -> int:
      ...
    
   def put(self, key: int, value: int) -> None:
      ...

需要我对这个方法进行解释吗？

高级提及 (@ 符号)：

• @codebase：询问关于整个仓库的问题
• @file：引用特定文件
• @web：搜索在线资源
• @docs：查阅框架/库的官方文档

4) Cmd/Ctrl + L (长会话模式)

专为多步骤任务和重构而设计：

你：我想将 auth 模块重构为更安全的 JWT 设计。

Cursor：
正在分析当前的 auth 模块...
有 3 个文件需要修改：
1. auth/jwt.py
2. middleware/auth.py
3. routes/login.py

建议方案：
[详细步骤]

是否继续？

5) 多文件编辑 (Composer)

你：将所有的类组件（class components）转换为函数组件（function components）。

Cursor：
发现 15 个类组件
已修改文件：
- components/Header.jsx ✅
- components/Footer.jsx ✅
- components/Sidebar.jsx ✅
...

所有编辑已应用。是否也更新相关测试？

6) 错误检测与修复

Cursor 检测到：

⚠️ TypeError: Cannot read property 'name' of undefined
   at UserProfile.render (UserProfile.jsx:25)

建议修复：
添加空值检查或使用可选链（optional chaining）

[应用修复]

使用技巧

提示词最佳实践

糟糕的指令：

"把它改进一下"

更好的指令：

"添加输入验证，处理空数组的边界情况，并优化错误信息"

项目全局指南

创建 .cursorrules 文件来设定规范：

# .cursorrules
我们使用：
- React 18 配合 TypeScript
- Tailwind CSS 进行样式开发
- React Query 进行数据获取
- Vitest 进行测试

规范：
- 使用函数组件和 Hooks
- 优先使用命名导出 (named exports)
- 为所有组件编写类型定义
- 优先使用 async/await 而非 .then()

Cursor 将在整个仓库中遵循这些规则。

常用快捷键

常见工作流

1) 快速原型开发

你：使用 React + TypeScript 创建一个 Todo 应用。

Cursor 生成结构：
- App.tsx (主组件)
- TodoList.tsx (列表)
- TodoItem.tsx (单项)
- types.ts (类型定义)
- hooks/useTodos.ts (Hook)
- styles/App.css (样式)

几分钟内即可获得可运行的原型。

2) 重构

你：将这个大组件拆分成几个小组件。

Cursor：
建议拆分为：
1. UserAvatar
2. UserStats
3. UserActions

已创建文件并更新了导入引用。

3) 调试

你：这段代码在生产环境中偶尔崩溃。

Cursor：
潜在问题：
1. 缺失空值检查
2. 异步竞态条件
3. 内存泄漏风险

建议修复：
[具体的代码更改]

4) 编写测试

你：@file UserService.ts 编写单元测试。

Cursor 生成：
- 正常路径测试
- 边界情况
- 错误处理
- Mock 和 Stub
- 以 95% 以上覆盖率为目标

5) 撰写文档

你：为所有公共方法添加 JSDoc。

Cursor：
已为 80 多个方法添加了包含参数、返回值和示例的文档。

与其他 AI 编程工具的对比

优点与局限性

优点

1. 深度集成（完整的编辑器，而非简单的插件）
2. 强大的项目理解力和连贯的代码编辑
3. 支持多种顶级模型（GPT-4, Claude 3.5, 推理模型）
4. Composer 功能适用于大型重构和保持代码一致性

局限性

1. 需要互联网连接
2. 提示词和工作流有一定的学习曲线
3. 建议重度用户使用专业版
4. 针对敏感代码库需评估隐私需求

隐私与安全

数据处理

• 免费/专业版：数据可能被用于改进模型（可选择退出/Opt-out）
• 企业版：数据不会被用于训练
• 隐私模式：禁用上传以实现更严格的控制

安全性

• 传输过程使用 TLS 加密
• 默认不长期保留代码
• 遵循 SOC 2 和 GDPR 规范

最佳实践

请勿包含：

• API 密钥和密钥 (Secrets)
• 客户敏感数据
• 公司机密信息

实际案例

案例 1：构建 REST API

你：使用 Express + TypeScript 创建一个用户管理 API。

Cursor 生成结构：
├── src/
│   ├── routes/users.ts
│   ├── controllers/userController.ts
│   ├── models/User.ts
│   ├── middleware/auth.ts
│   ├── utils/validation.ts
│   └── app.ts
├── tests/
│   └── users.test.ts
└── swagger.yaml

包含 CRUD、认证、验证、错误处理、测试和 API 文档。

案例 2：迁移至 TypeScript

你：将此项目从 JavaScript 迁移到 TypeScript。

Cursor：
1. 添加 tsconfig.json
2. 将 .js 重命名为 .ts
3. 添加类型定义
4. 修复类型错误
5. 更新 package.json

几分钟内完成了 50 多个文件的迁移。

案例 3：性能调优

你：@codebase 查找瓶颈并优化。

Cursor 分析：
1. components/DataTable.jsx - 不必要的重复渲染
2. utils/api.js - 缺少请求缓存
3. hooks/useData.js - 内存泄漏风险

应用优化后，预计提升 40%-60% 的性能。

常见问题 (FAQ)

Cursor 比 GitHub Copilot 更好吗？

Cursor 的范围更广。Copilot 专注于补全；而 Cursor 增加了对话、多文件编辑和全项目理解能力。

我的 VS Code 扩展能用吗？

可以。Cursor 与 VS Code 兼容，支持你现有的扩展和设置。

免费版够用吗？

对于学习和偶尔使用来说非常棒。专业开发者会从专业版（Pro）中获益更多。

我的代码会被用于训练吗？

免费/专业版默认允许（你可以选择退出）。企业版代码不会被用于训练。

支持哪些语言？

支持大多数主流语言：Python, JavaScript, TypeScript, Go, Rust, Java, C/C++, C#, 等等。

相关资源

• 文档：https://docs.cursor.sh
• 视频教程：在 YouTube 搜索 “Cursor AI tutorial”
• 社区：官方 Discord
• 示例仓库：GitHub 上的 cursor-examples

更新内容

Composer (多文件编辑)

• 同时编辑多个文件
• 保持代码风格一致
• 自动更新导入和引用

代理模式 (Agent Mode)

• 让 AI 运行命令和测试
• 针对复杂任务不断迭代直至成功

文档集成

• 行内查询官方文档
• 获取最新的框架用法和 API

总结

Cursor 是下一代 AI 编程环境，它能理解你的项目并帮助你更快地设计、实现、重构和修复代码。对于许多开发者来说，它能将生产力提高 2-5 倍。

专业版（$20/月）为职业开发工作提供了极佳的价值。如果你还在使用传统的编辑器，不妨试试 Cursor——它可能会改变你构建软件的方式。

开启使用：从 cursor.sh 下载并免费试用。