Cursor 怎么用？10 分钟拿下 AI IDE 完整教程

30 秒了解：Cursor 怎么用，到底要按什么节奏

Cursor 怎么用其实就 4 步：装 → 登 → 打开项目 → 学会 3 个快捷键。 跟其他 AI IDE 比，Cursor 最大的好处是「像 VS Code 一样」——你之前装的扩展、配色、快捷键基本能直接用，10 分钟就能跑通核心玩法。

这篇按官方推荐 + 实战节奏写，从下载到第一次让 AI 改 5 个文件全程走一遍。如果你完全不知道 Cursor 是什么、跟 VS Code 有啥差别，先看 Cursor 是什么 再回来。

准备工作：3 个前置条件

• 一台 Mac / Windows / Linux 电脑：三个系统都有官方版本
• 一个真实项目：哪怕是 5 个文件的小仓库都行，纯空目录练不出感觉
• 能稳定连 cursor.com：模型调用默认走海外服务器，国内用户配好代理

下面 7 步带你从「没装过」到「能让 AI 改你代码」。

第 1 步：去官网下载安装

打开浏览器去 cursor.com，点右上角 Download，自动识别你的系统给安装包：

• Mac：下载 .dmg，拖进 Applications
• Windows：下载 .exe，双击安装
• Linux：下载 .AppImage 或 .deb

装完打开 Cursor，你会看到一个跟 VS Code 几乎一样的界面——左边文件树、中间编辑器、底下终端。

提示：如果你电脑里已经有 VS Code，Cursor 第一次启动会问要不要导入设置（扩展、快捷键、主题）。点 Yes 一键搬过来，10 秒搞定。

第 2 步：登录账号

第一次打开 Cursor 会让你登录。右上角点头像图标 → Sign In，浏览器弹出认证页：

• GitHub 登录：最简单，已有账号一键搞定
• Google 登录：海外邮箱可用
• Email 登录：填邮箱收验证码

登完回到 Cursor，右下角会显示你的账号和当前订阅档位（默认 Hobby 免费）。

是否要开 Pro

新手强烈建议先用 Hobby 免费档 跑 1 周。免费档每天有 50 次「premium 模型」调用（Claude Sonnet、GPT-4.1 之类），日常学习够用。如果天天被限速、想跑大任务，再升 Pro（约 20 美元每月）。

学生有专属 1 年免费 Pro：去 cursor.com/students 用学校邮箱认证，能拿。

第 3 步：打开你的第一个项目

跟 VS Code 一样：菜单 File → Open Folder，选你电脑上一个已有项目的根目录。

打开后 Cursor 会自动做 3 件事：

1. 索引项目：右下角会有进度条「Indexing codebase…」，跑完 AI 才能理解你整个项目
2. 读 .cursorrules：根目录有这个文件的话自动加载（项目级 AI 约定）
3. 加载扩展：你之前在 VS Code 装的扩展自动启用

重要：等右下角索引跑完再让 AI 干活。索引没好就让它干，它只能看到当前打开的那一两个文件，效果差很多。

第 4 步：学 3 个核心快捷键

Cursor 的精华就这 3 个键，记住就够日常 80% 的活：

还有两个辅助键：

• Cmd / Ctrl + L：打开右侧 Chat 面板，跟 AI 对话不改代码
• Esc：拒绝当前补全 / 关闭面板

Tab 补全实战

打开任一文件，开始打字。比如你写一个 React 函数组件：

function UserCard({ name, email, avatar }) {

按个回车，下一行 Cursor 直接给你灰色的整段补全——return 语句、JSX 结构、className 全帮你猜出来。觉得对就按 Tab 接受，不对按 Esc 拒绝继续自己写。

Cmd+K 改代码实战

选中一段已写好的函数，按 Cmd+K（Mac）或 Ctrl+K（Windows / Linux），弹一个小输入框。输入你的需求：

加上错误处理，捕获 fetch 失败，console.error 后返回空数组

按 Enter，Cursor 在原位置直接改完，旁边显示 diff（红绿对比）让你审。点 Accept 接受、Reject 拒绝。

Composer 改多文件实战

按 Cmd+I（Mac）或 Ctrl+I（Windows / Linux）打开 Composer，输入：

把当前项目的 UserCard 组件拆成 Avatar + UserInfo 两个子组件，更新所有引用

Cursor 会同时改 3-5 个文件，每个文件都给你 diff 让你逐个审。详细玩法看 Cursor Composer 实战。

第 5 步：换一个适合你的模型

右下角点 模型名（默认 cursor-small），下拉菜单能选：

• Claude Sonnet 4.5：当下最强的「日常代码」模型，平衡速度和聪明度
• Claude Opus 4.5：最聪明，跑大重构 / 复杂逻辑用
• GPT-5：OpenAI 旗舰，逻辑推理强
• GPT-5 mini：便宜版，高频小任务用
• Gemini 2.5 Pro：Google 旗舰，超长上下文适合大项目
• cursor-small：Cursor 自家小模型，Tab 补全专用，免费无限用

新手推荐组合：日常 Tab 补全用 cursor-small（无限），Cmd+K 改代码切到 Claude Sonnet，Composer 跑重活切到 Claude Opus 或 GPT-5。

想接国产模型省钱看 Cursor 切换模型完整教程。

第 6 步：写一份 .cursorrules 让 AI 懂你项目

跟 CLAUDE.md 一个原理：在项目根目录建一个 .cursorrules 文件，告诉 Cursor 这个项目的约定。每次 AI 操作都会读它。

打开 Cursor 的 Chat（Cmd+L），让它帮你生成草稿：

请帮我生成一份 .cursorrules 文件，给当前这个项目用。
步骤：

先扫描项目根目录，识别技术栈（package.json / pyproject.toml / go.mod 等）
看 src 目录结构，识别架构风格
找 README 和已有文档，提取项目约定
输出一份 .cursorrules 草稿，包含：

技术栈说明
命名规范
文件组织约定
测试和构建命令
我特别想让 AI 注意的点（留空给我填）


写完不要创建文件，先在 Chat 里贴出来让我审。

它会输出草稿，你审一遍、改掉它猜错的、加上它不知道的，再保存到项目根目录 .cursorrules。下次打开这个项目，Cursor 立刻按你的约定干活。

第 7 步：跑完一段活的善后习惯

写完一段代码不要直接关 Cursor，养成 3 个收尾动作：

1. 审 diff：点底下 Source Control 面板看所有改动，确认没改坏不该动的文件
2. 跑一遍测试：终端跑 npm test / pytest / go test，绿了再 commit
3. git commit：让 Composer 帮你写 commit message：

帮我看当前所有未 commit 的改动，按 Conventional Commits 格式（feat / fix / refactor / docs / test 等）写一条 commit message。
要求：

主题行用英文，不超过 72 字符
正文用中文，3-5 行说明改了什么、为什么
如果改动太杂涉及超过 3 个主题，建议先拆成多个 commit
不要执行 git 命令，只输出 message 让我复制。

Cursor 的 5 个高级技巧

技巧 1：用 @ 精准喂上下文

跟 Cursor 对话时输入 @，能引用：

• @file 某个文件
• @folders 整个文件夹
• @codebase 整个项目（基于索引）
• @docs 在线文档（如 @react）
• @web 让 AI 搜网页

例：@components/Button.tsx 这个按钮的样式搬到 @components/Card.tsx 同样的 hover 效果。精准的上下文 = 精准的输出。

技巧 2：Shadow Workspace 后台跑任务

新版 Cursor 支持「Shadow Workspace」——让 Agent 在后台跑长任务，你继续写别的。适合：

• 让 AI 写一组单测，跑 10 分钟
• 让 AI 重构一个老模块，跑 20 分钟

底下任务进度条会更新，跑完通知你 review。

技巧 3：@docs 添加自定义文档

如果你在用一个 Cursor 没收录的库（比如内部 SDK），可以手动加文档：

设置 → Features → Docs → Add new doc → 贴文档 URL，Cursor 会爬下来索引。之后聊天里 @your-sdk-name 就能直接引用。

技巧 4：用 Ctrl+→ 部分接受补全

灰色补全有时候只对前半截。按 Ctrl+→（Windows / Linux）或 Cmd+→（Mac）一次只接受一个词或一行，比直接 Tab 全收然后删多余更顺。

技巧 5：Chat 里粘报错

跑代码出错，整段报错粘到 Chat 里加一句「为啥报错？怎么修」。Cursor 会读完报错 + 当前文件 + 项目上下文，给你具体修复建议。比自己 Google 快得多。

常见的 4 个坑

一个完整实战：让 Cursor 帮你给项目加 i18n

假设你接手一个英文版 React 项目，老板说「下周给我加中英切换」。用 Cursor 的完整流程：

第 1 步：在 Chat 里先看现状

我要给当前项目加国际化（i18n）。
先帮我分析：

当前项目用的什么框架（Next.js / Vite / CRA）
UI 文案分散在哪些文件里、大概有多少处
推荐用什么 i18n 方案（i18next / next-intl / react-i18next）
给我一个分步骤的实施 plan（不要动文件，只输出 plan）
我希望 plan 包含 5-8 步，每步标注预估改动文件数。

第 2 步：审完 plan，用 Composer 跑第一步：

按我们刚才讨论的 plan，执行第 1 步：

安装 i18next 和 react-i18next
在 src 下新建 locales / zh.json 和 locales / en.json
创建 i18n 配置文件 src / i18n.ts
在 main.tsx 引入 i18n
只做这 4 件事，不要动任何已有 UI 组件。改完跑一次构建确认没报错。

第 3 步：一步步执行，每步都先 commit、再让 Composer 跑下一步。

跑完整套你会发现：Cursor 的优势是「IDE 内全程透明」——每个文件改动你都能审 diff、随时 reject、随时 git reset。这就是 AI IDE 比「让 ChatGPT 写代码再复制粘贴」靠谱的根本原因。

下一步

• 想深入 Composer → Cursor Composer 实战
• 想接国产模型省钱 → Cursor 切换模型全教程
• 想看 Cursor vs Copilot → Cursor vs Copilot 终极对比
• 想看更猛的 CLI → Claude Code 怎么用
• 想看 AI 编程全景 → AI 写代码完全指南
• 想搞懂 vibe coding → vibe coding 是什么

常见问题

Q：Cursor 跟 VS Code 能同时装吗？ A：能。两个是独立软件，互不冲突。很多人保留 VS Code 写不需要 AI 的项目、用 Cursor 写新项目。

Q：第一次用就让它改大项目可以吗？ A：可以，但务必：1) 项目是干净的 git 状态（所有改动都已 commit），2) 先用 Chat 让它输出 plan 你审过，3) 再用 Composer 一步步执行，4) 每步审 diff 后再下一步。万一出问题 git reset --hard 就回来了。

Q：Cursor 能离线用吗？ A：不能。所有 AI 功能都要请求远端模型，没网络只能当普通 VS Code 用（写代码、跑终端、git 操作可以，AI 全部不可用）。

Q：Cursor 的代码会被拿去训练吗？ A：默认不会。设置里开启 Privacy Mode（隐私模式）后 Cursor 承诺不存储、不训练。但代码还是会发到模型方（Anthropic / OpenAI）的 API 做推理，敏感代码建议看最新 privacy policy 或用本地模型方案。

Q：怎么从 VS Code 迁过来不丢插件？ A：Cursor 第一次启动会问要不要导入。如果当时跳过了，可以在设置里搜「Import VS Code」手动触发，几乎所有扩展都能直接搬过来。