Cursor 使用指南：从安装到上手Cursor 是一款深度集成 AI 的代码编辑器，简单说就是一个会跟你聊天、帮你写代

Cursor 使用指南：从安装到上手

Cursor 是一款深度集成 AI 的代码编辑器，简单说就是一个会跟你聊天、帮你写代码的 VS Code。它的界面和 VS Code 几乎一模一样，如果你用过 VS Code，可以直接上手。

下面这份教程会从安装开始，带你快速掌握核心功能。

一、安装与初始设置

1. 下载安装

访问 Cursor 官网 cursor.com，下载对应你操作系统的版本（支持 Windows/macOS/Linux），然后正常安装即可。

2. 首次启动配置

首次启动时，Cursor 会引导你进行个性化设置：

快捷键方案：选择你习惯的（VS Code 风格或自定义）
主题：深色/浅色
终端环境：配置 Shell 类型和字体

3. 注册账号（推荐）

虽然可以匿名使用，但注册账号（支持 Google/GitHub 登录）才能解锁完整的 AI 功能。新用户通常有 14 天 Pro 版本免费试用期。

4. 汉化设置（可选）

如果希望界面是中文的：

打开扩展商店（Ctrl/Cmd + Shift + X）
搜索 Chinese，安装 Chinese (Simplified) Language Pack
按 Ctrl/Cmd + Shift + P，输入 Configure Display Language
选择 中文(简体)，然后重启编辑器

二、核心功能与快捷键（必学）

Cursor 的核心竞争力是三个 AI 交互功能，记住下面三个快捷键就能玩转：

快捷键	功能名称	一句话解释	使用场景
`Ctrl/Cmd + K`	Inline Edit（内联编辑）	选中代码，输入指令让 AI 修改	修改/重构代码、添加新功能、优化逻辑
`Ctrl/Cmd + L`	Chat（对话模式）	打开侧边聊天窗口，与 AI 讨论代码	解释代码、问问题、规划方案（Ask 模式）或让 AI 自动执行（Agent 模式）
`Ctrl/Cmd + I`	Composer	打开一个专用窗口，同时与 AI 协作	需要复杂上下文、多文件协作的开发任务

效率心法：看到要改的代码 → Cmd+L 选中 → Cmd+K 输入指令 → 审查 AI 修改 → 接受或调整。全程不到 30 秒。

三、场景实战：从 0 到 1 开发一个功能

我们用一个实际场景——创建一个简单的 Python Flask API，来演示具体怎么操作。

第一步：生成代码（Ctrl+K）

新建一个文件，命名为 app.py
按 Ctrl/Cmd + K，在弹出的输入框中输入：

"创建一个简单的Flask应用，有一个/hello的路由，返回JSON格式的欢迎信息。"
按回车，Cursor 会瞬间生成完整可运行的代码。

第二步：理解代码（Ctrl+L）

选中你不理解的某行代码（比如 @app.route('/hello')）
按 Ctrl/Cmd + L，侧边聊天框会自动附上这段代码
在聊天框问："这个装饰器的作用是什么？"
AI 会给出清晰的解释。

第三步：修改代码（Ctrl+K）

在文件末尾新建一行
再次按 Ctrl/Cmd + K，输入：

"添加一个POST路由 /echo，接收JSON数据并原样返回。"
Cursor 会基于现有代码上下文，无缝添加新功能。

第四步：调试修复（Ctrl+L）

故意制造一个错误（比如删掉一个引号或括号）
选中报错的代码区域
按 Ctrl/Cmd + L，直接说："这段代码有什么错误？请修复它。"
AI 会指出问题并给出修复后的正确代码。

四、进阶技巧（用好能甩别人一条街）

1. `@` 引用：让 AI 精准理解上下文

在聊天框（Ctrl+L）中输入 @，可以引用项目中的特定内容，让 AI 的回复更有针对性：

引用方式	效果	示例
`@文件名`	AI 会读取该文件的完整内容	`@UserController.java 帮我优化这个Controller`
`@文件夹名`	AI 会理解整个模块的结构	`@/service 帮我为这个包生成单元测试`
`@代码片段`	先选中代码，AI 只关注这段	`@ 解释这段代码的逻辑`
`@Doc`	让 AI 读取在线文档（如 Vue/React 官方文档）后开发	`@Vue 参考官方文档，帮我实现登录注册`

2. Agent 模式：AI 自己动手干活

在聊天框（Ctrl+L）中，可以选择 Agent 模式（默认就是）。这个模式下，AI 可以：

自主探索你的项目代码
跨多个文件创建/编辑代码
运行终端命令
联网搜索文档
自动修复错误

你只需要提需求，Agent 会自己规划步骤并执行。比如可以说："帮我修复这个 bug，并运行测试"。

注意：Agent 能力很强，但建议先用小项目测试，熟悉其行为后再在重要项目中使用。

3. 让 AI 学会你的代码规范

在项目根目录创建一个 .cursorrules 文件，写下你的编码规范。从此 AI 生成的代码会自动遵循这些规则。例如：

# 本项目使用 TypeScript 严格模式
# 组件使用函数式组件而非类组件
# API 调用统一使用 /api 目录下的封装

五、重要提醒

虽然 Cursor 很强大，但请记住以下原则：

AI 是助手，不是替代品：生成的代码需要你人工审查，特别是涉及业务逻辑、安全性、性能的关键代码。
注意隐私安全：不要在对话中上传公司核心代码或敏感信息（如 API 密钥、数据库密码）。建议启用 Cursor 的敏感数据检测功能。
描述越清晰，效果越好：尽量给 AI 提供详细的上下文和明确的要求，而不是笼统的指令。比如："用 Python 写一个快速排序，使用递归方法，添加时间复杂度注释"，比"写个排序"好得多。

六、费用说明

免费版：每月 500 次 GPT-4/Claude 调用，其他基础模型不限
Pro 版：$20/月，无限调用高级模型
Pro+ 版：$40/月，更快响应
Ultra 版：$50/月，最强性能

新用户有 14 天免费试用期。

七、进一步学习

官方文档：cursor.com
命令行工具（CLI）：高级用户可以尝试 Cursor Agent CLI，在终端中直接调用 AI 能力
扩展市场：Cursor 兼容 VS Code 扩展，可以按需安装 GitLens、ESLint、SonarLint 等增强功能

用了一年多，最大的感受是：它不是替代你写代码，而是让你把精力放在真正需要思考的地方。重复性工作丢给它，创造性工作留给自己。

Cursor 使用指南：从安装到上手