Cursor从零入门教程:安装、配置、高效使用全攻略(2026版)
半小时上手,一天变成效率高手。这是我写给每个新手的 Cursor 完全指南。
前言:你需要这篇教程吗?
如果你符合以下任何一条,这篇教程就是为你准备的:
- 😕 听说过 Cursor 但还没试过
- 😅 刚下载了 Cursor 但不知从何下手
- 🤔 用了两天觉得"和 VS Code 没啥区别"
- 💪 想系统性提升 AI 编程效率
这篇教程会带你: 从安装 → 配置 → 核心功能 → 实战 → 进阶技巧,一条龙搞定。
第一章:安装与首次启动
Step 1:下载
访问 cursor.sh 官网,点击 Download for Windows/Mac/Linux。
下载完成后直接安装,和装普通软件一样简单。
Step 2:首次启动
打开 Cursor,你会看到欢迎界面。
有两个关键选择:
1. 导入 VS Code 配置
▸ Import from VS Code (推荐)
▸ Start Fresh强烈建议选第一个 —— 你的插件、主题、快捷键全部无缝迁移。
2. 选择 AI 模型
▸ Use Claude 3.5 Sonnet (默认,推荐)
▸ Use GPT-4o
▸ Use Custom Model新手直接选 Claude 3.5 就行,这是目前性价比最高的编程模型。
Step 3:注册/登录
需要用邮箱注册一个 Cursor 账号。免费版有 2000 次补全和 50 次 Chat 额度——足够你体验一周。
第二章:界面速览
Cursor 的界面和 VS Code 几乎一模一样,多出来的就是几个 AI 入口:
┌────────────────────────────────────────────┐
│ 菜单栏 文件 编辑 选择 查看 ... │
├──────────┬─────────────────────────────────┤
│ 活动栏 │ 编辑器(中间) │
│ │ │
│ 📁 文件 │ ┌───────────────────────┐ │
│ 🔍 搜索 │ │ │ │
│ 🔄 Git │ │ 你的代码在这里 │ │
│ 🤖 Chat │ │ │ │
│ ⚙️ 设置 │ └───────────────────────┘ │
│ │ │ │
├──────────┴─────────────────────────────────┤
│ 状态栏 Ln 1 Col 1 UTF-8 模型: Claude │
└────────────────────────────────────────────┘3 个 AI 入口你必须要知道:
| 入口 | 快捷键 | 功能 |
|---|---|---|
| 🤖 Chat | Cmd/Ctrl + L | 对话式 AI 助手(带项目上下文) |
| ✏️ Inline Edit | Cmd/Ctrl + K | 选中代码用自然语言修改 |
| 🎯 Composer | Cmd/Ctrl + I | Agent 模式,跨文件操作 |
第三章:核心功能详解
功能 1:Tab 补全(最常用)
在敲代码时,Cursor 会自动预测你要写什么,按 Tab 接受。
// 你输入:
const getUserBy
// 按 Tab → 自动补全:
const getUserById = async (id: string): Promise<User | null> => {
const user = await db.collection('users').findOne({ id })
return user
}使用技巧:
- 写注释 → Tab → 自动生成代码
- 写函数名 → Tab → 补全完整实现
- 写测试 → Tab → 补全测试用例
功能 2:Ctrl+K 内联修改(最实用)
选中代码,按 Cmd/K + Ctrl + K(Mac/Win),输入自然语言指令:
选中这段代码 → Cmd+K → 输入 "加错误处理" → Enter常用指令示例:
| 选中内容 | 输入指令 | 效果 |
|---|---|---|
| 一个函数 | "优化性能" | 重构为更高效的版本 |
| 一个类 | "加JSDoc注释" | 自动生成文档注释 |
| 一段逻辑 | "改写成函数式" | 换种编程风格 |
| JSON数据 | "生成TS类型定义" | 自动推导类型 |
功能 3:Chat 对话
按 Cmd/Ctrl + L 打开侧边栏 Chat。
关键优势: 无需粘贴代码上下文,Cursor 自动知道你在编辑什么文件。
💬 你可以问:
- "这个函数是干什么的?"
- "这个项目的路由结构是怎样的?"
- "这段代码哪里有潜在bug?"
- "帮我重构一下这个模块"功能 4:Composer(Agent 模式)
按 Cmd/Ctrl + I 打开 Composer。
这是 Cursor 最强大的功能——可以跨多个文件完成任务。
📝 示例:
输入 "给用户表添加头像字段,同步更新API和前端"
Composer 会自动:
1. 修改数据库模型 → 添加 avatar 字段
2. 更新 API 路由 → 新增头像上传接口
3. 修改前端组件 → 显示头像
你只需要审查 diff → 点 Accept第四章:实战演练
实战 1:用 Cursor 写一个 Todo API
跟着我做,5 分钟搞定一个完整 API:
Step 1: 创建 todo.ts 文件,输入:
// 一个 Todo 的 Express CRUD APIStep 2: 按 Tab → Cursor 自动生成基础代码
Step 3: 选中全部代码,按 Cmd+K,输入:
添加 TypeScript 类型定义和错误处理Step 4: 再选中,按 Cmd+K,输入:
改成 Prisma 数据库版本完成!整个过程不到 3 分钟。
实战 2:修复一个 bug
场景: 用户列表页面报错,数据没显示出来
Step 1: 打开报错的文件,按 Cmd+L
Step 2: 输入:
这个页面报错了,看看哪里有问题Step 3: Cursor 分析代码后指出问题:map 前没检查数据是否为 null
Step 4: 选中那行代码,按 Cmd+K,输入:
加空值判断修复完成,全程不超过 30 秒。
第五章:进阶技巧
技巧 1:项目级上下文
想让 Cursor 理解更大范围的项目上下文?
在 Chat 或 Composer 中用 @ 引用:
- @文件路径 → 引用特定文件
- @文件夹路径 → 引用整个目录
- @Web → 联网搜索(Pro 功能)
- @Codebase → 搜索整个代码库技巧 2:自定义 Rules
Cursor 可以设置全局规则,让 AI 遵循你的编码风格:
设置路径: Cursor Settings → Rules → User Rules
例如:
- 使用 TypeScript 严格模式
- 优先使用 const 而非 let
- 函数命名使用 camelCase
- 组件使用箭头函数
- 错误处理使用 try-catch设置后,所有 AI 生成的代码都会遵循这些规则。
技巧 3:多行光标 + AI
Cursor 的多行光标(按住 Option/Cmd 点击多行)和 AI 可以组合使用:
选中多行 → Cmd+K → "统一变量命名风格"一次修改整个文件的所有变量名。
技巧 4:影子文件(Shadow Files)
Cursor 会为你的项目建立一个 影子索引(.cursor 目录),包含:
- 代码库的结构索引
- 最近的修改记录
- 常用的代码模式
不要删除 .cursor 文件夹 —— 删除后 Cursor 需要重新建立索引。
技巧 5:批量重构
这才是 Cursor 真正拉开差距的地方:
在 Composer 中输入:
"把项目中所有的 any 类型替换为具体类型"
→ Cursor 扫描整个项目 → 逐个文件给出修改建议
→ 你 review 后批量应用第六章:常见问题
Q1:Cursor 会泄露我的代码吗?
Cursor 有 隐私模式(Privacy Mode),开启后代码不会用于训练模型。企业版可以选择私有部署。
Q2:免费版够用吗?
日常轻度开发 够用。重度用户建议升级 Pro($20/月)—— 换算下来每天不到 7 毛钱。
Q3:和 GitHub Copilot 比怎么样?
两者不是一个级别的产品。Copilot 是"AI 辅助编程",Cursor 是"AI 原生编程"。具体的差异可以看这篇对比文章。
Q4:需要科学上网吗?
Cursor 本身需要联网使用 AI 功能。如果你在中国大陆,可能需要稳定的网络连接。
Q5:学完要多久?
基础操作 30 分钟 上手。熟练掌握高级功能大概需要 3-5 天 的日常使用。
写在最后
Cursor 不是一个"你装了就变强"的工具。
它是 你越会用,它就越强 的工具。
这篇教程给了你完整的入门路径,但真正重要的是——从今天开始,强制自己在日常开发中用 Cursor。哪怕是简单的变量重命名,也试试用 Cmd+K 来做。
一周后你会发现:回不去了。
相关文章:
最后更新:2026年6月19日