如果你第一次打开 Cursor，最常见的感受是：
- 看起来像 VS Code，但按钮和交互又不完全一样
- AI 功能很多：Chat、Inline、Agent、多文件编辑…不知道先学哪个
- 有时它很聪明，有时又“跑偏”，尤其是项目一大就更明显
这篇教程面向新手，只做一件事：让你在 30 分钟内把 Cursor 稳定用起来。
你会得到：
- 安装与登录（订阅/团队/账号）
- 最重要的 3 个快捷键：
Cmd+K/Cmd+L/Cmd+I - 关键设置：模型、隐私、索引、上下文
- 一套日常工作流：需求 → 生成 → 修改 → 测试
- 常见问题排查：索引慢、回答跑偏、上下文不足
如果你想看更偏“高级玩法/多文件策略/规则文件”的深度文，也可以直接跳到：
- /topics/ai/cursor-editor-guide
Cursor 是什么？和 VS Code + AI 插件有什么区别
一句话：Cursor 是一款 AI 原生 IDE（基于 VS Code 的体验，但围绕 AI 工作流做了更深的整合）。
你会在三个方面明显感受到区别：
- 上下文获取更主动：它更倾向于“理解项目”，而不是只围绕当前文件
- 多文件修改更顺滑：对话驱动的改动更容易扩展到多个文件
- 工作流更完整：从提需求、生成代码、应用补丁到复盘更像一个闭环
但它也带来两个需要你管理的变量：
- 项目索引（Indexing）是否可用、是否准确
- 你的提示词是否把“范围/输出/约束”说清楚
安装与登录：账号、订阅、团队
1）安装
- 去官网下载并安装
- 首次启动时建议先完成基础设置（主题、字体、快捷键）
2）登录与订阅
- 登录后通常才能使用完整 AI 能力
- 如果你在团队使用，确认是否需要组织/团队的订阅或策略限制
3）一个重要认知：AI 能力 ≠ 永远联网可用
- 模型调用依赖网络与服务状态
- 在企业环境可能还有代理/访问策略
如果你遇到“AI 按钮灰色/不可用”，先从网络、登录状态、订阅状态排查。
基础设置：模型、语言、隐私/索引（新手最该先配这三项）
1）选择模型：优先“稳定 + 适合你任务”的
一般来说：
- 写代码/改 bug：优先更擅长代码理解与修改的模型
- 写文档/总结：选择更擅长语言表达的模型
不要一开始就纠结“哪个最强”，先保证：你能持续稳定产出。
2）语言与输出习惯
- 你希望它输出中文还是英文？
- 代码注释风格？
- 是否需要“先给方案再改代码”？
把这些写成固定指令（后面会讲）。
3）隐私与索引：决定“它能理解多少”和“会不会泄露”
你需要明确两件事：
- Cursor 是否会把你的代码用于索引/上下文
- 哪些文件不应该被纳入（例如
.env、私钥、商业敏感目录）
最佳实践：
- 用项目规则文件限制敏感目录（例如忽略
.env、node_modules、构建产物） - 只在必要时打开项目级索引
必学快捷键：Cmd+K / Cmd+L / Cmd+I
不同版本的命名可能有差异，但你可以把它们理解成三种场景：
1）Cmd+K：在当前代码附近“就地改”
适合：
- 选中一段代码，让它重构/改写/补类型
- 让它生成一个函数/组件
提示词模板：
- “把这段改成更可读的写法，不改行为”
- “给这个函数补齐边界处理，并保留现有 API”
2）Cmd+L：对话式解决问题（理解/方案/排查）
适合：
- 问“为什么报错”
- 让它解释代码结构
- 让它给你一个可执行的排查清单
提示词模板：
- “先列出可能原因（按概率排序），再给我最短排查路径”
3）Cmd+I：把“需求”变成“修改计划”，再应用改动
适合：
- 多文件改动
- 需要生成补丁/提交一组修改
提示词模板：
- “请先列出将修改的文件清单与改动点，确认后再生成补丁”
新手工作流：写需求 → 生成 → 修改 → 测试（最稳的一套）
Cursor 用得稳的人，通常不是“会写提示词”，而是有固定流程。
第 1 步：把需求写成约束清单
至少写清：
- 目标：要实现什么
- 范围：改哪些文件/模块，不改哪些
- 约束：代码风格、兼容性、性能、不能破坏 API
- 验证：怎么验证（命令/页面/用例）
第 2 步：让 AI 先给“改动计划”，不要直接出大段代码
这样可以避免跑偏和过度改动。
第 3 步：小步提交
一次只做一个小目标：
- 先让它把 bug 定位清楚
- 再改最小的代码
- 再跑一遍验证
第 4 步：复盘并固化成项目规则
你发现 AI 总犯同一类错（比如乱改目录/输出太长/风格不一致），就把规则写进项目规则文件。
常见问题与排查：索引慢、回答跑偏、上下文不足
1）索引很慢/一直在索引
可能原因：
- 项目太大（尤其 monorepo）
- 纳入了不必要的目录（
node_modules、构建产物）
排查与优化：
- 限制索引范围，只索引需要的目录
- 忽略构建产物与依赖目录
2）回答跑偏：它写了“看起来对但不符合你的项目”
典型原因：
- 你没有说明“基于当前仓库”
- 它在用通用模板回答
解决方法：
- 明确范围：
仅基于当前项目代码做修改，不要引入新框架 - 明确输出：
先给改动计划，再给补丁
3）上下文不足：它不知道你在说哪个文件/哪个函数
解决方法：
- 选中关键代码再提问
- 让它“列出它需要哪些信息”，你再提供
8 个常用提示词（直接复制）
- “先帮我定位问题：列 5 个可能原因，按概率排序，再给最短排查路径。”
- “只改最小范围，保持现有 API，不要做跨目录重构。”
- “把这段重构成可读性更强的版本，行为不变。”
- “补齐边界条件与错误处理，并解释为什么这样做。”
- “给我一个最小可复现示例（MRE）来验证这个 bug。”
- “请先给改动计划（文件列表 + 修改点），确认后再输出补丁。”
- “输出一个 checklist，方便我逐条验证。”
- “如果信息不足，请直接问我缺什么，不要猜。”
常见问题（FAQ）
Cursor 和 VS Code 有什么区别？
Cursor 更偏“AI 原生工作流”，对话、就地修改与多文件变更更顺滑；VS Code + 插件更自由，但需要自己拼装工作流。
Cursor 需要联网吗？会上传代码吗？
通常需要联网调用模型。是否上传代码取决于你的隐私设置与上下文/索引策略。建议在团队/公司场景明确策略并限制敏感目录。
为什么 Cursor 生成的代码不对？
多数是范围不清或上下文不足。先让它给“改动计划”，再小步应用，并把常见约束写进项目规则。
怎么让 Cursor 理解整个项目？
需要项目索引与正确的引用范围；但不要把不必要目录纳入索引，否则会变慢且更容易跑偏。
Cursor 如何管理上下文？
优先用“选中代码 + 提问”，并明确你希望它参考哪些文件/模块。必要时把需求拆成小任务。
Cursor 如何配置快捷键？
在设置里搜索快捷键映射，把 Cmd+K/Cmd+L/Cmd+I 固化成自己的习惯即可。
Cursor 免费吗？
通常有免费额度或试用，但更完整能力需要订阅。以官方定价为准。
Cursor 适合什么人？
最适合：需要频繁写代码、改代码、读代码，并希望把“需求→实现→验证”流程变快的开发者与技术团队。
下一步：把 AI IDE 的产出落到“可发布的网页”
如果你的目标不仅是写代码，而是把网页做出来并上线，可以继续看：
- 深度玩法：/topics/ai/cursor-editor-guide
- Copilot 对比与技巧：/topics/ai/github-copilot-tips
- 直接开始制作与发布：/builder
