Cursor 编辑器使用指南

一、什么是Cursor

Cursor是AI原生代码编辑器，基于VS Code构建，内置：

Claude和GPT等顶级模型
智能代码补全（Tab）
AI对话助手（Chat）
多文件编辑（Composer）
Agent模式（自主编程）

2025年更新亮点：

Cursor 2.0引入全新Agent界面
自研代码模型，接受率提升28%
Browser Controls支持网页操作

二、安装配置

下载安装

访问 cursor.com 下载
支持 Windows / macOS / Linux
可一键导入VS Code配置和扩展

首次设置

1. 登录/注册Cursor账号
2. 选择AI模型偏好（Claude/GPT）
3. 配置快捷键风格
4. 导入VS Code设置（可选）

三、核心功能详解

1. Tab补全

输入代码时，Cursor会自动预测并建议补全。

快捷键：

Tab - 接受建议
Esc - 拒绝建议
Ctrl+→ - 部分接受（逐词）

技巧：写好注释，Tab补全更准确

// 验证邮箱格式是否正确
function validateEmail(email) {
  // Tab会补全完整实现
}

2. Cmd+K 内联编辑

选中代码后按 Cmd+K（Win: Ctrl+K），直接在代码中对话修改。

使用场景：

> 改成async/await写法
> 添加错误处理
> 优化性能
> 添加TypeScript类型

3. Cmd+L 侧边聊天

按 Cmd+L（Win: Ctrl+L）打开侧边AI对话。

特点：

可以@引用文件和代码
保持对话上下文
支持多轮对话

4. Cmd+I Composer（2025重点功能）

按 Cmd+I（Win: Ctrl+I）打开Composer，实现多文件AI编辑。

能力：

> 创建完整的用户注册流程
> 重构整个认证模块
> 将项目迁移到TypeScript

Composer会自动：

分析需求
规划修改文件
逐个文件修改
展示diff预览

5. Agent模式（Cursor 2.0）

让AI自主完成复杂任务：

> 修复这个Issue：用户登录后不跳转

Agent会自动：

分析问题根因
定位相关代码
编写修复代码
运行测试验证

四、@引用系统

Cursor的强大之处在于精确的上下文引用：

引用方式	说明	示例
@file	引用整个文件	@src/utils.ts
@folder	引用文件夹	@src/components
@codebase	搜索代码库	@codebase 认证逻辑
@web	联网搜索	@web Next.js 15新特性
@docs	引用文档	@docs React
@git	Git历史	@git 最近的提交

示例对话：

@src/api/auth.ts 这个handleLogin函数有bug，
用户输入错误密码时没有正确处理。
请帮我修复。

五、快捷键速查

功能	Mac	Windows
Tab补全	Tab	Tab
内联编辑	Cmd+K	Ctrl+K
侧边聊天	Cmd+L	Ctrl+L
Composer	Cmd+I	Ctrl+I
接受编辑	Cmd+Enter	Ctrl+Enter
拒绝编辑	Cmd+Backspace	Ctrl+Backspace
切换AI模型	Cmd+/	Ctrl+/

六、高级技巧

1. 自定义Rules

在项目根目录创建 .cursorrules 文件：

# 项目规范
- 使用TypeScript严格模式
- 组件使用函数式写法
- 状态管理使用Zustand
- 样式使用Tailwind CSS

# 代码风格
- 使用2空格缩进
- 函数必须有JSDoc注释

2. 多模型切换

不同任务选择不同模型：

Claude Opus：复杂代码、长文件
GPT-4o：快速问答、简单修改
Claude Sonnet：日常编程（性价比）

3. 代码库索引

Cursor会自动索引代码库，提供更准确的建议：

设置 → Features → Codebase Indexing → Enable

七、定价

计划	价格	包含
Free	免费	有限的AI请求
Pro	$20/月	无限AI请求、高级功能
Business	$40/月	团队功能、管理控制

八、常见问题

Q: Cursor和VS Code有什么区别？

Cursor基于VS Code，保留所有功能，额外加入AI能力。可以一键迁移。

Q: 支持哪些编程语言？

支持所有主流语言，对Python、JavaScript/TypeScript、Go、Rust优化最好。

Q: 代码会被上传吗？

敏感代码可开启隐私模式，不会用于训练。企业版支持私有部署。