Cursor 怎么用？从安装到写出第一个项目的保姆级教程
Cursor 是当下最受欢迎的 AI 代码编辑器之一，它基于 VS Code 改造，把 AI 对话、补全、多文件改动这些能力深度做进了编辑器里。本文带你从零上手，写出第一个能跑的项目，顺带把新手最容易踩的坑都标出来。
Cursor 是什么，适合谁
Cursor 的定位是「AI 原生的代码编辑器」。如果你用过 VS Code，会发现界面几乎一样——快捷键、插件、主题大多能直接迁移，甚至连你原来装的插件市场都能一键导入。区别在于它把 AI 当成一等公民：你可以一边写代码一边和 AI 对话，让它补全、解释、改写甚至跨多个文件重构，而不是像早期插件那样只能在侧边栏问答、自己手动复制粘贴。
它适合两类人：想用 AI 提速的开发者，以及想边学边做的新手。新手尤其受益，因为遇到不懂的代码可以直接选中问「这段在干嘛」，比翻文档、搜论坛快得多。如果你团队里已经有人用 VS Code 加 Copilot，切到 Cursor 基本零学习成本，唯一要适应的是它的对话面板和 Composer 面板的位置。
需要说明一点：Cursor 不是「魔法」，它本质是把大模型接入编辑器上下文，模型能力上限还是取决于你选的底层模型（比如 Claude、GPT 系列）。选错模型或者不给上下文，效果会明显打折扣，这个后面细讲。
安装与基础配置
- 到 Cursor 官网下载对应系统的安装包（Windows / macOS / Linux 都有），安装过程和普通软件一样，一路下一步即可。
- 首次启动时它会询问是否从 VS Code 导入配置，如果你之前用过，建议导入，插件、主题、快捷键一键迁移，不用重新配置一遍。
- 登录账号后即可使用。免费档位（Hobby）每月有一定次数的高级模型请求额度，通常够你先体验一到两周；用量上来后建议直接订阅 Pro（月费制），否则频繁遇到「额度用完降级到弱模型」会很影响体验。
- 打开设置里的 Models 面板，把默认对话模型切到 Claude Sonnet 或 GPT-4 系列的最新版本——默认模型不一定是当前最强的，这一步很多人会漏掉。
配置上对新手最重要的一点：把项目用「文件夹」整体打开（File → Open Folder），而不是单个文件，这样 AI 才能理解整个项目的结构、看到你的依赖清单和已有代码风格。只打开单文件时，AI 等于「失忆」地在孤立回答，给出的代码风格经常和项目其他部分对不上。
如果你的项目里有编译产物、node_modules、日志这类大文件夹，记得在根目录建一个 .cursorignore 文件，把它们排除掉。不排除的话，索引会很慢，AI 检索上下文时也容易被无关文件干扰，回答质量反而下降。
四个核心用法
掌握这四招，基本就会用 Cursor 了：
- 对话生成（Chat，快捷键 Cmd/Ctrl+L）：唤出对话框，直接用中文描述需求，比如「帮我写一个待办列表页面，用 React + Tailwind」，它会生成代码并可一键应用到文件。想只改一小段代码，也可以用 Cmd/Ctrl+K 唤出内联生成，选中代码后直接说「把这个函数改成异步」，改动会直接嵌在原地，不用跳去对话框来回切换。
- Tab 补全：写代码时它会预测你接下来要写的内容，按 Tab 接受，按 Esc 拒绝。它不只补全单行，常常能一次补好整段逻辑，甚至预判你下一步要改的相邻代码（多光标跳转补全），用顺手之后打字速度能提升不少。
- Composer 多文件改动（快捷键 Cmd/Ctrl+I）：当一个需求要改好几个文件时，用 Composer 模式描述整体目标，比如「给这个博客加一个评论功能，包括后端接口和前端表单」，它会跨文件协同修改，生成的 diff 会列出所有涉及的文件，你逐个审核再应用，适合做完整功能而不是单点补全。
- @ 引用上下文：在对话里用
@可以引用具体文件（@App.tsx）、整个文件夹（@src）、官方文档（@Next.js）甚至代码符号（@函数名），把准确的上下文喂给 AI，回答会精准很多。不加@时它只能根据你打开的标签页和最近编辑猜测上下文，命中率明显更低。
再补一个进阶技巧：在项目根目录建一个 .cursorrules 文件，写清楚项目的技术栈约定、代码风格、命名规范（比如「组件统一用函数式写法」「接口报错要抛自定义 AppError」），Cursor 之后的每次生成都会自动遵守这些规则，省得每次对话都重复交代一遍。
实战：跑通一个待办列表小项目
光看用法不如动手一遍。打开一个空文件夹，用对话框输入「用 Vite + React + Tailwind 初始化一个项目，做一个可以增删改的待办列表」。它会先给出初始化命令，你在终端里执行（Cursor 内置终端，Ctrl+` 唤出），装完依赖后再回到对话框说「继续」，它会接着写组件代码。
生成完第一版后，先跑起来看效果（npm run dev），大概率会有小问题，比如样式没生效或者状态没更新。把报错或者你观察到的现象直接贴回对话框，比如「点击完成按钮没反应，控制台没报错」，它会检查逻辑并给出修复。这个「跑—反馈—修」的循环，比一次性要求它写「完美代码」效率高得多，也是用好 Cursor 的核心节奏。
新手常见坑
- 不给上下文就提问：AI 不知道你的项目细节，多用
@引用相关文件，效果天差地别；尤其是改 bug 时，一定要带上报错堆栈和相关文件，不要只丢一句「这里有问题」。 - 盲目「全部接受」：生成的代码要大致看懂再应用，否则后期难维护，也容易引入你看不懂的 bug。尤其是 Composer 一次改十几个文件时，先看 diff 摘要，重点检查数据库操作和权限相关代码，这类改动出错代价最高。
- 一句话想造完整系统：AI 擅长起步和提速，复杂业务仍需你拆解成小步，比如先做数据模型，再做接口，最后做界面，一步步验证比一口气让它「做一个完整电商后台」靠谱。
- 忽略报错信息：跑出错时把报错贴回对话框，让它读着错误改，比你干猜快得多；如果报错栈很长，优先贴最上面几行加上出错文件名，不用整段复制。
- 模型选错却怪工具不好用：免费额度用完后编辑器会自动降级到能力较弱的模型，生成质量下降容易被误以为是「Cursor 变差了」，实际去设置里看一眼当前用的模型就清楚了。
- 一直用 Chat 做大改动：Chat 面板适合问答和单文件小改，涉及多文件的功能改动应该切到 Composer，否则你要自己手动把生成的代码分别粘到各个文件里，费时又容易漏改。
和 Claude Code 怎么选
如果你纠结 Cursor 和终端派工具的差异，可以看这篇 Cursor vs Claude Code：简单说，Cursor 管「编辑器里的手感」，适合边写边改、随时肉眼审查每一处 diff；终端代理更适合大改动和自动化任务，比如一次性跑完整个重构或者批量生成测试文件，不需要你逐行盯着看。两者不是非此即彼，很多团队日常写代码用 Cursor，跑批量任务或者 CI 里的自动化改动用终端代理。
想系统学，奇连 AI 的 AI 编程课从 0 带你用 Cursor 做出第一个真正能上线的产品。