Cursor 新手入门使用教程，AI 赋能的下一代 IDE

一、Cursor 是什么？

Cursor 是一款集成了 GPT-4、Claude 3.5 等先进大语言模型的智能编程环境，基于现代化的编辑器架构打造。从界面设计和功能布局来看，Cursor 与 Visual Studio Code 高度一致，但它的核心价值在于深度整合了 AI 辅助编程能力。

对于 VSCode 用户而言，迁移到 Cursor 几乎无需学习成本。它支持相同的快捷键操作、扩展生态系统（可通过 Marketplace 下载扩展）、语言配置（如 Python 解释器设置）、远程开发（SSH／容器／WSL 连接）以及高度可定制化的设置。如果你日常使用 PyCharm，也能快速适应 Cursor 的工程管理方式和交互逻辑。

Cursor 不仅保留了传统 IDE 的高效编码体验，更重要的是通过 AI 能力实现了编程范式的突破——从“人编写代码”逐渐转向“人与 AI 协同创作代码”。

二、详细使用指南

1. 下载、安装与注册

访问 Cursor 官网可以下载适用于 Windows、macOS 或 Linux 的安装包。首次启动需注册账号，目前支持邮箱注册或第三方身份验证（如 GitHub 账号）。

关于免费额度，GPT-4 和 Claude 3.5 模型每月提供 50 次免费调用，而其他模型（如 o1-mini、o1-preview）无使用次数限制。

如果需要将界面切换为简体中文，可以使用快捷键 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板，输入 "Configure Language"，选择"简体中文"并重启生效。

2. 内置模型与选择策略

Cursor 集成了多个顶尖大语言模型，可在右上角 Settings → AI Models 中选择。Claude 3.5 Sonnet 综合代码能力极强，长上下文支持佳，适合复杂系统设计和跨文件推理。GPT-4 在算法实现和代码优化表现优异，尤其适合机器学习、数值计算类任务。o1-preview 和 o1-mini 是 OpenAI 推出的推理优化模型，擅长逻辑严谨的任务（如单元测试生成、代码纠错）。

建议日常开发以 Claude 3.5 为主，遇到复杂算法问题时切换至 GPT-4。

3. 核心快捷键详解

Cursor 设计了四个智能快捷键，它们是 AI 编程的核心入口。

Tab 键用于智能代码补全。在编码时，Cursor 会实时推荐代码（灰色字体显示），按 Tab 直接采纳。该功能支持多行补全、函数级生成，甚至可根据上下文生成测试用例。

Ctrl + K（Mac 上为 Cmd + K）用于编辑选区代码。在空白行按下，输入功能描述即可直接生成完整代码。选中代码段后按 Ctrl + K 输入指令，AI 会重构代码。选中代码后输入"添加详细注释"，可生成文档字符串或行内注释。

例如选中以下代码并按 Ctrl + K，输入"转换为列表推导式"：

squares = []
for i in range(10):
    squares.append(i**2)

AI 会生成：

squares = [i**2 for i in range(10)]

Ctrl + L 支持对话式编程与知识库问答。可针对代码片段、当前文件或整个项目提问。输入 @Files 可指定其他文件进行问答；输入 @Codebase 可基于整个项目上下文提问。结合上传的文档，输入 @docs 可进行基于知识的问答。

Ctrl + I 支持全项目自动化开发。在空目录按 Ctrl + I，输入项目描述，Cursor 会自动生成项目结构、实现代码甚至数据库配置。此功能还支持跨文件修改，如提出"将所有 API 路由从 /api/v1 改为 /api/v2"的需求，AI 会全局重构。还可以在对话中持续提出要求，AI 会逐步完善项目。

4. 外部文档作为知识库

Cursor 允许导入外部文档作为项目的背景知识，包括产品需求文档、技术规范、API 手册等。前往 Settings → Documents 可以上传 PDF、MD、TXT 等格式的文档。在使用 Ctrl + L 提问时，通过 @docs 指定文档，例如："@docs 根据架构文档，我们应该如何实现身份验证模块？"

此功能特别适合企业内部开发或复杂开源项目，能确保 AI 的理解与团队知识保持一致。

5. 自定义 System Prompt

通过设定 System Prompt，你可以让 AI 更贴合你的编码风格或项目规范。打开 Settings → Rules for AI 可以输入定制化的指令，例如："你是一名高级 Python 后端工程师，遵循 Google 代码风格规范"，或者"所有生成的函数必须包含类型注解和 Docstring"，还可以指定"优先使用 async/await 而不是回调函数"。

这能显著提升生成代码的一致性和可用性。

三、进阶应用场景

Cursor 支持多种进阶应用场景。代码审查功能可以通过选中代码后按 Ctrl + L 输入"检查代码风格和潜在 bug"来实现。技术债务清理可以使用 @Codebase 提问"项目中有哪些重复代码可以重构？"。迁移助手可以输入"将这段 jQuery 代码转换为 React Hooks 形式"。测试覆盖可以通过按 Ctrl + K 选中函数后输入"生成 pytest 单元测试"来完成。

四、结语：为什么你应该尝试 Cursor？

Cursor 代表了编程范式的进化方向：它并非要取代开发者，而是将程序员从重复性劳动中解放出来，更专注于架构设计和创新任务。对于 VSCode 用户，迁移成本几乎为零；对于 PyCharm 或其他 IDE 用户，也能通过其直观的设计快速上手。

免费额度（50 次/月 GPT-4/Claude 3.5）足以让你充分体验 AI 编程的潜力。无论是快速原型构建、遗留代码维护还是技术学习，Cursor 都能带来显著的效率提升。

建议从一个小型个人项目开始，全程使用 Cursor 开发，感受 AI 在代码生成、审查、重构全流程中的助力。相信你会重新思考"编程"的未来形态。

附：资源链接

• 官方文档：https://docs.cursor.com/
• 快捷键速查表：https://cursor.sh/docs/shortcuts
• 社区用例分享：https://twitter.com/cursor