假设你今天打开 VSCode，写着写着代码，忽然脑子一热：“这段逻辑能不能交给 AI 写啊？”于是你上网一搜，看到了这个名字：Cursor。一个看起来有点像 VSCode 的编辑器，却号称“AI 编程工具的新王者”。

今天这篇教程，不整虚的，不炫酷词，咱们就像老朋友一样，从安装开始，一步一步带你把 Cursor 用好。放心，就算你是刚入门的新手，看完也能顺利跑起来；如果你是有经验的开发者，也能从后半段发现它不止是“补代码”这么简单。

1. 入门篇：装得上、跑得动、配得好

先看看你的电脑“带不带得动”这位 AI 小助手。

内存建议：8GB 起步（能跑得更流畅）

硬盘空间：留个 2GB 空着就行

1.1. 下载与安装：三步到位

1. 打开官网 https://cursor.com 。
2. 点击 download 按钮。
3. 选对应的系统版本下载（macOS/Windows/Linux 全覆盖）。
4. 按平台各自的步骤安装即可，跟 VSCode 类似，没太多坑：

• 💻 Windows 安装小贴士 下载 .exe 后一路“下一步”，选个安装路径就搞定。
• 🍎 macOS 安装注意点 下载 .zip 解压出来运行 Cursor，第一次打开可能被系统“嫌弃”不安全，记得去 “系统偏好设置 → 安全性与隐私” 给它放个行。
• 🐧 Linux 玩家也别急 下载 .AppImage 后终端执行：

chmod +x Cursor-x.x.x.AppImage
./Cursor-x.x.x.AppImage

1.2. 初次使用：登录与基础配置

首次启动后，Cursor 会请你“亮个身份”：

• 支持邮箱注册，也可以用 GitHub / Google 一键登录。
• 登录后可以选择导入 VSCode 设置：扩展、快捷键、主题，一键迁移，谁用谁知道。
• 初始配置里会问你要不要保留 VSCode 的快捷键布局，建议保留，毕竟肌肉记忆比什么都重要。

1.3. 连接 AI：设置 API Key（可选）

Cursor 自带模型已经能做不少事，但如果你想用自己的 OpenAI、Anthropic 或 Google Key，更进一步： 打开：Settings → Models 粘贴 API 密钥，保存，搞定 ✅ 举个栗子：

{
  "openai": "sk-xxxxxxx"
}

配完之后，你就能在编辑器里体验“自然语言驱动代码”的快乐了，比如：

写一个支持中英文互转的正则

回车，啪——Cursor 自动生成正则表达式，堪称“人类正则痛苦史终结者”。

1.4. 快捷键小抄：用得熟，效率飞

快捷键和 VSCode 差不多，但别小看 Ctrl+K ——这是你召唤 AI 小助手的主通道。

2. 进阶篇：AI 真会写代码吗？

这时候你可能好奇：Cursor 除了补全，到底还能做啥？一句话总结：“你可以用自然语言，让它写、改、查、讲代码。”

2.1. 智能补全：不仅仅是自动填空

Cursor 的补全不是机械式“代码提示”，而是会根据上下文跨行预测。 举个例子：你写了个函数头，它能把整段函数体给你补出来。 更狠的是，它还能自动修复 lint 错误，比如多了个分号、变量命名不规范等，这些原本要手动修的活，现在几乎“写完即规范”。

2.2. 代码生成与重构：用“人话”改代码

这个功能很多人一用就爱上了。

• 按下 Ctrl+K，输入：

实现一个 debounce 函数

• 或者选中一段旧代码，再 Ctrl+K 输入：

实现一个大小写转换函数

Cursor 会弹出一个 diff 视图，红绿分明，确认无误一键接受，完成代码重构。这比起在脑子里反复构思，不知道高效多少倍。

2.3. 聊天式调试：AI 找 Bug 不睡觉

虽然不是传统意义上的调试器，但你可以直接问：

Cursor 能结合全局上下文做出判断 (Features | Cursor - The AI Code Editor)，还能指出潜在性能问题，真·全场 MVP。 而且集成了基本的调试工具（变量观察、调用栈分析等） (Features | Cursor - The AI Code Editor)，写完就能顺手测，闭环体验非常流畅。

2.4. 代码导航：AI 帮你翻库找代码

你只要输入：

@Codebase 找出所有用到了 debounce 的地方

Cursor 就能从构建的向量索引中“秒查”项目内的相关片段，几乎是代码界的“Ctrl+F 超进化” (Features | Cursor - The AI Code Editor)。 还支持终端操作、依赖安装、脚本运行，等于是 VSCode + Copilot + DevTool 的合体。

3. 高手篇：精准定制让 cursor 更懂你

到这一步，如果你已经用得顺手，不妨试试进阶玩法。

3.1. 自定义规则：为你的项目“量身定制 AI”

可以指定哪些目录不参与 AI 建议，或设置常用模板，一次配置、终身受益。

3.1.1. 让 Cursor 成为你项目的“记性担当”：自定义系统提示

每次都要提醒 Cursor “我们用的是 Next.js + tRPC”？太低效了。直接编辑 .cursor/system-prompts.json，配置你的默认“人格提示”，像这样：

{
  "default": "你是一个严谨、偏好函数式风格的 TypeScript 工程师，我们使用的是 Next.js + tRPC + Tailwind，所有代码需符合 ESLint 规则。"
}

这样每次聊天，它都像带了预习笔记来上班。

3.1.2. 自定义指令（Custom Commands），让复杂任务一键搞定

常用的代码生成模板、脚手架命令、甚至“生成某种 PR 格式说明文档”都可以封装成 Custom Command，只需 / 一下就能复用，举个例子：

{
  "name": "generate-api-handler",
  "prompt": "根据以下 schema 生成一个 tRPC handler，需包括输入校验、错误处理和测试用例"
}

这样不仅提升效率，还能统一风格，减少人祸。

3.1.3. 多语言、多项目、多角色切换，自由如风

一个项目是 Node.js，另一个是 Rust CLI？没关系，为每个项目设置 .cursor/ 文件夹，它就能像多面人格 AI 一样切换身份，配合你不同的开发节奏。

3.2. 接入 MCP 工具集，让 AI 不止“懂代码”

MCP，全称 Model Context Protocol，听着高深，其实是一个让 AI “调用工具”的开放协议。 Cursor 可以作为 MCP 客户端，调用你配置好的服务器，让 AI 执行各种操作，比如打开浏览器、调接口、连数据库…… 有两种配置方式：

3.2.1. 方法一：配置文件接入

在 .cursor/mcp.json 写入：

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    },
    "translate": {
      "command": "npx",
      "args": ["tsx", "path/to/index.ts"]
    }
  }
}

• mcpServers：服务器别名
• command：启动命令（通常是 npx）
• args：启动参数列表（指向你的服务器脚本） 完成后，打开 Cursor 命令面板，执行 Cursor Settings → Features → MCP，确保对应服务器已启用（状态点亮为绿色）

3.2.2. 方法二：图形界面接入

在 Settings → Features → MCP 中点击 “+ Add New MCP Server”，按提示填写即可。在弹窗中填写：

• Name：服务器名称（如 Translation）
• Type：选择 command
• Command：npx
• Args：["tsx", "/full/path/to/index.ts"]

一旦配置成功，AI 就能像点外卖一样，帮你“点工具”，自动执行任务。

3.3. 如何用好 Cursor：12 条最佳实践，让 AI 写码不再变“意面”

用好 Cursor，就像给你配了个不用喝咖啡、从不摸鱼的强力实习生，代码干净、速度飞起；用不好？那你可能要花一整周擦屁股，清理那些“AI 意大利面”。 别怕，下面这 12 条实用经验，帮你驯服这位 AI 编程助手，让它既快又稳地为你所用。

3.3.1. 开局设好规则，AI 才不会乱飞

进入项目别急着让它写代码，先设 5-10 条项目规则，比如目录结构、命名习惯、哪些库不能用。你甚至可以 /generate rules，让 Cursor 帮你总结已有代码库的规矩，效果拔群。

3.3.2. 提示词别敷衍，要写成“小规格说明书”

别扔个“写个登录页”就完了——说清楚你用的技术栈（React + Tailwind + Supabase？），预期行为（跳转、验证、失败提示？），限制条件（不准用 localStorage？）。提示词越细，结果越准。

3.3.3. 一次一小步，文件为单位推进

别一次生成十几个文件，一口气吃不成胖子。逐个文件生成、测试、Review，Cursor 的表现才不会一会儿暴走一会儿宕机。

3.3.4. 写测试先行，像钓鱼一样诱导它

先写好测试并锁定，再让 Cursor 生代码补进去。这是“诱导编程”的神技，让它像被测试套牢的鱼，一点点游向正确实现。

3.3.5. 输出要亲审，问题手动修，教 AI 长记性

AI 写得再像样，也得自己过一遍，发现问题立刻手动修好。修完之后，把改好的代码扔给 Cursor，说：“看，照这个学！”——它的成长速度比你讲道理快多了。

3.3.6. 用好 @file、@folder、@git 精准聚焦上下文

让 Cursor 看全项目？那它就像“看书不翻页”的学生，心不在焉。用 @file、@folder 或 @git diff 精准圈定范围，AI 的聚焦力会瞬间拉满。

3.3.7. 设计文档别丢外面，放进 .cursor/ 是王道

把设计思路、PR checklist、约定俗成的流程都放在 .cursor/ 文件夹里，Cursor 会自动读进去，理解上下文像接上 WiFi 一样快。

3.3.8. AI写得不对？你直接写，它学得更快

别花时间给它写小作文解释错误。直接动手改，Cursor 会自动吸收你动过的地方，像在玩“代码打地鼠”。

3.3.9. 善用聊天记录，反复打磨 prompt

别每次都重开窗口写新提示。直接在旧对话上迭代，比从头开始高效一万倍。Cursor 记得你上次的脾气，这次自然更配合。

3.3.10. 模型选得好，效率高三倍

有的活 Claude 擅长，有的 Gemini 更准，干嘛不都用？Cursor 支持你在不同线程里切模型，比如：

• Claude：处理文档、PR 说明、用户故事草案
• GPT-4：写业务逻辑、迭代代码实现
• Gemini：生成高复杂度结构（比如数据管道） 合理分工，像组了个远程 AI 团队。

3.3.11. 不熟的技术栈？贴文档、让它逐行解释

第一次上手某个框架？贴官方文档链接，遇错别怕，要求 Cursor 一行一行解释错误原因和修复方法，既能 Debug 也能涨姿势。

3.3.12. 大项目就别急，索引一晚换高效一天

项目太大？让它一晚上慢慢索引，白天再用它写代码就能飞快响应。否则它加载上下文时就像穿着铅鞋跑马拉松，效率惨不忍睹。

4. 结尾彩蛋：你可能已经发现…

Cursor 其实是一种开发范式的改变：从“我写代码”到“我讲需求，AI 给我草稿”；从“我查资料调 API”到“我让 AI 去调”。 当然，本文只是个起点，下一篇我们将深入 Cursor 的 Prompt 编写技巧和代码上下文调优策略，教你如何把“AI 学徒”训成“编程搭子”。 你是否有兴趣了解：

• 怎样写出让 Cursor 理解更深的提示？
• 不同语言项目（如 TypeScript、Python、Rust）适配 Cursor 的细节？
• 如何打造团队级的 Cursor 使用规范？ 欢迎点赞或留言，我会挑呼声最高的继续写下去 👇