Cursor 新手教程：从安装到用 AI 改一整个项目

你可能听说过 AI 写代码，但真正坐下来用的时候，往往不知道从哪里开始、该怎么配置才能高效。Cursor 是目前用得最广的 AI 代码编辑器，它基于 VS Code 改造，如果你之前用 VS Code，几乎零学习成本就能切换过来。这篇文章会从安装开始，带你走完配置、核心功能、到用 Agent 模式改一整个项目的完整路径。

安装与基本配置

下载安装

去 cursor.com 下载对应系统的安装包，Windows / macOS / Linux 都有。安装完打开，它会问你要不要导入 VS Code 的配置（插件、主题、快捷键），选"是"即可，无缝迁移。

选择 AI 模型

Cursor 支持多个模型：Claude Sonnet、Claude Opus、GPT-4o、Gemini 等。截至 2026 年，Claude Sonnet 系列在代码任务上综合表现最好，是多数开发者的默认选择。

打开设置（Cmd/Ctrl + ,），在 Models 里可以选择默认模型。Pro 套餐（每月 20 美元）有足量的高级模型调用额度，免费版有每月 2000 次的 Tab 补全和有限的聊天次数。

导入 VS Code 插件

你在 VS Code 里装的插件，在 Cursor 里基本都能用。如果有什么插件没自动迁移，手动在插件市场里搜索安装即可。

三种核心交互模式

Cursor 有三种和 AI 交互的主要方式，搞清楚它们的区别，才能选对工具用对场景。

Tab 补全：不打断思路的智能续写

这是用得最频繁、也最无感的功能。你在写代码的过程中，Cursor 会根据上下文预测你接下来要写什么，用灰色文字显示建议，按 Tab 接受。

和普通的代码补全不同，Cursor 的 Tab 补全会理解你的意图——比如你刚写完一个函数，它会预测你接下来可能要写同类型的下一个函数；你改了函数签名，它会自动建议把调用处也改掉。

实用技巧： 写代码时不要强迫自己总是接受补全。按 Esc 拒绝，Tab 接受，也可以只接受一个单词（Cmd/Ctrl + →）。用多了你会形成一种感觉，知道什么时候它猜对了。

Chat 模式（Ctrl+L）：对话式修改当前文件

按 Ctrl+L（macOS 是 Cmd+L）打开右侧 Chat 面板，可以针对当前文件或选中的代码进行对话。

比如：

• 选中一段函数，问"这里有没有性能问题？"
• 选中一段代码，说"把这段改成异步的"
• 打开一个出错的文件，描述报错，它会帮你找 bug

Chat 的修改会以 diff 形式展示，你可以逐块接受或拒绝，不会直接覆盖你的文件。

小技巧： 在对话框里用 @文件名 引用其他文件，比如"参考 @utils/auth.ts 的风格，重写这个函数"。AI 会把引用的文件内容加入上下文。

Inline Edit（Ctrl+K）：在光标处直接改

Ctrl+K（macOS Cmd+K）弹出一个小输入框，你在里面输入指令，AI 直接在光标位置生成或修改代码。适合快速的局部改动，比"说一段话让它改"效率更高。

比如：光标放在一个空函数体里，按 Ctrl+K，输入"用 try-catch 包裹，错误记录到 logger"，它直接就改完了。

Cursor Rules：让 AI 记住你的项目规矩

这是 Cursor 里最被新手忽视、也最值得配置的功能。Rules 是你写给 AI 的"项目规范说明书"，每次对话 AI 都会遵守。

配置 Rules

在项目根目录创建 .cursorrules 文件（旧版）或在 Cursor 设置里的 Rules 面板配置（新版 .mdc 格式）。

一个典型的 Rules 文件示例：

你是一个 Vue 3 + TypeScript 的专家开发者。
遵守以下规范：
- 组件使用 Composition API 和 <script setup> 语法
- 状态管理用 Pinia，不用 Vuex
- 样式用 Tailwind CSS，不写 scoped style
- 所有函数和变量有明确的 TypeScript 类型，不用 any
- 组件文件名用 PascalCase，工具函数文件用 camelCase
- 所有异步操作加错误处理
当你修改代码时，保持现有的代码风格，不要"改进"不需要修改的部分。

Rules 的几个原则：

1. 只写真正重要的规则，不要把 Rules 写成一本说明书。规则太多，AI 反而抓不住重点。
2. 规则要具体可执行，"写好代码"不是规则，"所有接口函数必须有 JSDoc 注释"才是。
3. 发现 AI 重复犯同一个错误，就把对应的规则加进去。

Agent 模式：让 AI 自主改一整个项目

这是 Cursor 最强大的功能，也是 2026 年最值得掌握的用法。在 Agent 模式下，Cursor 可以：

• 自主读取多个文件
• 执行终端命令
• 运行测试
• 根据结果自我修正
• 一次性完成跨多个文件的复杂任务

启动 Agent

在 Chat 面板顶部切换到 Agent 模式（或直接按 Ctrl+Shift+I），然后描述你的任务。

示例任务：

"我需要把项目里的用户鉴权从 session-based 改成 JWT。请先分析影响范围，告诉我需要改哪些文件，然后逐步实施修改，每改完一批相关文件跑一次测试确认没有破坏现有功能。"

Agent 会先列出修改计划，你确认后它开始逐步执行，遇到问题会报告给你。

Agent 的最佳实践

任务拆分，不要一步到位。 "帮我做一个完整的电商系统"注定失败。改成"先帮我搭商品列表页的骨架，只要展示功能，不用样式"，一步一步来。

给 Agent 明确的验证标准。 "做完之后跑 npm test，全绿才算完成"——有了明确的完成标准，Agent 会持续修复直到达到目标。

保持 Git 干净基线。 让 Agent 开始大范围修改前，先 git commit 一次。出了问题可以随时 git diff 查看改动，或 git checkout . 回退。

分阶段检查。 复杂任务里，每完成一个自然边界（比如改完所有后端接口），暂停下来检查一遍，再让 Agent 继续下一阶段。不要让它一口气改几十个文件都不看。

一次完整的实战流程

下面用一个真实场景串起来，把前面讲的内容都用上。

场景： 老项目重构，把一堆原生 JavaScript 文件迁移到 TypeScript。

第一步： 在 Rules 里配置 TypeScript 规范（不用 any、接口要命名、泛型要显式等）。

第二步： 打开 Chat，问："帮我分析这个项目，列出迁移到 TypeScript 的优先级顺序，从影响最小的工具函数开始。" 这是探索阶段，先不动代码。

第三步： 切到 Agent 模式，说："按照刚才的优先级，先把 src/utils/ 下所有文件迁移到 TypeScript，保持原有逻辑不变，只加类型，完成后跑 npm run typecheck。"

第四步： 检查 Agent 的改动，确认没有逻辑变更，只是加了类型定义。如果有问题，直接在 Chat 里指出让它修正。

第五步： 对下一批文件重复。

整个过程中，Tab 补全一直在发挥作用，帮你在自己手动调整的地方补全代码。

常见问题与避坑

Q：AI 改出的代码我看不懂怎么办？ 先不要直接接受，在 Chat 里问"解释一下你为什么这样改"。理解了之后再决定接受还是要求换一种更简单的写法。

Q：AI 总是不遵守我的规范怎么办？ 先检查 Rules 文件是否生效（Cursor 设置里可以查看）。如果规则太模糊，AI 会选择性遵守。把规则写得更具体，或者在对话里显式提醒"按照项目 Rules 里的要求"。

Q：上下文太长，AI 开始乱改怎么办？ 新开一个 Chat 对话，重新描述当前状态和下一步任务。不要让一个对话线程拖得太长。

Q：免费版够用吗？ 入门阶段够用。每月 2000 次 Tab 补全对轻量用户足够；Chat 和 Agent 的免费额度有限，深度使用建议升级 Pro。Pro 每月 20 美元，日常开发够用。

结语

Cursor 的价值不在于它能替代你写代码，而在于它能大幅压缩你在"知道要做什么"和"代码真正写好"之间的距离。掌握好 Tab 补全、Chat、Inline Edit 三种模式，配置好 Rules，会用 Agent 处理较大任务——这四件事做到，你的编码效率会有质变。

如果你是前端或全栈开发者，Cursor 是 2026 年最值得投资的工具之一。如果你已经是 VS Code 用户，几乎没有切换成本，今天就可以开始用。