Cursor 是一款基于 VS Code 构建的 AI 原生代码编辑器，它将大模型深度集成到编辑器中，提供代码补全、智能编辑、项目级问答和自动化重构等功能，旨在成为你的“AI 结对编程伙伴”。

本文将带你从零上手 Cursor，掌握其核心功能与高效用法。

---

🚀 一、部署 Cursor

1. 系统要求

项目	要求
操作系统​	Windows 10+、macOS 12+、Ubuntu 20.04+ 等主流发行版
内存​	建议 8GB 以上 (4GB 最低)
磁盘空间​	约 500MB 以上
网络​	需要联网以使用 AI 功能

2. 安装方式

Windows

• 官网安装包 (推荐)

  1. 访问 https://cursor.com/下载 .exe安装包。

  2. 双击运行，按提示完成安装。建议勾选“添加到 PATH”和“右键菜单”选项。

• 包管理器 (可选)

  powershell

  使用 winget

  winget install Anysphere.Cursor

  使用 scoop

  scoop bucket add extras

  scoop install cursor

macOS

• 官网安装包 (推荐)

  1. 访问 https://cursor.com/下载 .dmg文件。

  2. 将 Cursor.app拖入“应用程序”文件夹。

  3. 首次打开时，在系统弹窗中选择“打开”。

• Homebrew (可选)

  bash

  brew install --cask cursor

Linux

• AppImage (通用)

  1. 访问 https://cursor.com/下载 .AppImage文件。

  2. 赋予执行权限并运行：

     bash

     chmod +x Cursor-*.AppImage

     ./Cursor-*.AppImage

• 包管理器 (可选)

  bash

  Debian / Ubuntu

  sudo dpkg -i cursor_*.deb

  sudo apt-get install -f

  Fedora / RHEL

  sudo rpm -i cursor_*.rpm

  或使用 dnf

  sudo dnf install cursor_*.rpm

3. 首次启动与配置

1. 登录账号：使用邮箱或 GitHub 账号登录。新用户通常享有免费额度，之后可选择订阅 Pro 版。

2. 导入 VS Code 配置 (推荐)：首次启动时，向导会提示是否导入 VS Code 的扩展、主题和快捷键，可实现无缝切换。

3. 安装命令行工具：在命令面板 (Ctrl+Shift+P) 中运行 Shell Command: Install 'cursor' command in PATH，之后便可使用 cursor .命令在终端中快速打开项目。

---

⚙️ 二、基础配置

1. 界面与语言

• 主题与字体：在设置 (Ctrl+,) 中，通过 设置 → 颜色主题和 设置 → 字体进行个性化调整。

• 中文界面：在扩展商店 (Ctrl+Shift+X) 搜索并安装 Chinese (Simplified) Language Pack，然后按 Ctrl+Shift+P，输入 Configure Display Language并选择 zh-cn重启即可。

2. 开发环境配置

• 语言运行时：Cursor 会自动检测项目中的 Python、Node.js 等运行时。你可以在编辑器右下角状态栏手动切换版本，或指定虚拟环境路径。

• 调试器：内置对 Node.js、Python 等主流语言的调试支持。在代码中设置断点，然后按 F5即可启动调试。

3. 扩展生态

Cursor 兼容绝大多数 VS Code 扩展。你可以在扩展商店搜索并安装所需插件，如：

• 前端：Volar (Vue), ESLint, Prettier

• 后端：Java Extension Pack, Spring Boot Tools

• 通用：GitLens, Remote - SSH, Docker

---

💻 三、核心功能与快捷键

1. 智能代码补全 (Tab)

Cursor 的补全功能 (Cursor Tab) 能根据上下文预测并自动完成多行代码。当你编写注释或代码开头时，它会实时提供灰色文本建议，按 Tab键即可接受。

2. 代码生成与编辑 (Ctrl+K)

Ctrl+K是最核心的 AI 交互方式，允许你通过自然语言指令生成或修改代码。

• 从零生成：在空白文件中按 Ctrl+K，输入需求（如“写一个 Python Flask 接口”），AI 将生成完整代码。

• 修改已有代码：选中代码后按 Ctrl+K，给出指令（如“重构为异步函数，并添加错误处理”），AI 会提供修改建议，供你审查后接受。

3. 代码理解与问答 (Ctrl+L)

Ctrl+L会打开右侧聊天面板，用于进行项目级问答、代码解释或优化。你可以直接提问（如“解释这段代码的作用”），或将代码拖入对话框，AI 会基于上下文进行解答。

4. 自动化重构与测试

• 代码重构：选中冗长函数，按 Ctrl+K并指令“重构，使其更易读，并拆分函数”，AI 会提供重构方案。

• 生成测试：选中函数或类，通过聊天指令（如“为这个函数生成 pytest 单元测试”），AI 会自动生成测试代码。

5. 复杂项目开发 (Composer / Agent)

Ctrl+I启动 Composer / Agent 模式，通过自然语言驱动跨文件、跨模块的复杂开发任务。

1. 启动：在编辑器空白处按 Ctrl+I。

2. 描述需求：用自然语言描述功能（如“实现一个用户登录功能，包含手机号验证和密码加密”）。

3. Agent 执行：Agent 会自动规划、创建/修改多个文件，并运行命令。你只需审查变更并决定接受或回滚。

---

🧩 四、高级技巧：上下文、文档与规则

1. @符号：精准控制上下文

在聊天或 Ctrl+K指令框中输入 @，可以引入丰富的上下文，让 AI 更懂你的项目：

• @文件/ @文件夹：引用特定文件或整个模块的代码。

• @Codebase：让 AI 基于整个项目代码库进行搜索和分析。

• @Docs：将外部文档（如 API 文档链接）作为知识库，让 AI 依据文档生成代码。

• @Web：让 AI 联网搜索最新信息来辅助回答。

• @Git：结合 Git 提交历史进行提问，如“这次提交主要改了什么？”

2. 项目规则 (Rules)：让 AI 遵循规范

通过项目规则，你可以将团队的编码规范、架构约束等告知 AI，确保生成的代码风格统一。

• 配置方式：在项目根目录创建 .cursor/rules/文件夹，并添加 .mdc规则文件。

• 规则内容：使用 Markdown 编写，可包含 globs（适用文件）、alwaysApply（是否始终生效）以及具体的代码风格、架构要求等。

3. 外部模型接入

除了内置模型，你还可以接入自己的 API Key 或本地模型（如 DeepSeek），以降低成本或满足私有化部署需求。

• 配置路径：Settings → Models / AI Provider。

• 配置方式：填入你的 API 地址和 Key，即可在 Cursor 中使用自定义模型。

---

💡 五、实战演练：从 0 到 1 开发一个 TodoList

1. 创建项目

1. 打开 Cursor，通过 File → Open Folder选择一个空文件夹作为项目目录。

2. 在 AI 面板 (Ctrl+L) 中输入：“请帮我创建一个 React TodoList 项目的基本结构，使用 TypeScript 和 Vite。”

2. 实现核心功能

1. 状态管理：选中 src目录，按 Ctrl+K，输入：“请创建一个 Todo 状态管理的 Hook，包含添加、切换、删除任务和 localStorage 持久化。”

2. 主组件：选中 src/App.tsx文件，按 Ctrl+K，输入：“创建主 App 组件，包含任务列表展示、添加任务表单，并使用上面创建的 useTodos Hook。”

3. 样式：选中 src/App.tsx文件，按 Ctrl+K，输入：“为上面的 TodoList 添加美观的 CSS 样式。”

3. 运行与调试

1. 在 AI 面板中提问：“请告诉我如何运行这个 React 项目。”

2. 根据 AI 提供的指令（通常是 npm install和 npm run dev）在终端中执行。

3. 如果遇到错误，直接将错误信息和相关代码粘贴给 AI，它会帮助你分析和修复。

---

⚠️ 六、实用建议与注意事项

1. 审查与测试：AI 生成的代码可能包含错误或不安全逻辑，务必逐行审查并充分测试，尤其是在涉及支付、权限等核心业务时。

2. 指令要具体：提问越清晰，结果越准确。避免“优化一下”这类模糊指令，应具体说明优化目标（如“优化性能，将时间复杂度降到 O(n)”）。

3. 保护敏感信息：切勿将公司核心代码、密钥、数据库密码等敏感信息发送给 AI。可开启隐私模式或利用 .cursorignore文件排除敏感目录。

4. 拥抱迭代：将 AI 视为一个优秀的“实习生”，它的初稿通常需要你来迭代和完善。多使用“再简单一点”、“用更基础的方法实现”等指令来引导。