Cursor 实战：Tab 补全、Agent 与多文件重构怎么用

Cursor 是什么

Cursor 是一个 AI 编程编辑器，控制整个编辑器而不只是插件，因此能做到多文件编辑、全局代码库上下文和内联 diff 预览。GitHub Copilot 是装进现有编辑器的插件，两者能拿到的上下文范围不同。

产品形态在 2026 年变了不少：现在是 Cursor Agent 为核心，入口是 Cmd+I（Windows/Linux 为 Ctrl+I），并延伸出 Projects、Cloud Agents、Automations、Bugbot、CLI 等能力。旧文章里常提的 Cmd+K 内联编辑和 Cmd+L 聊天面板已不是主入口。

它于 2023 年发布。切换前值得先确认两件事：你的日常工作里跨文件重构占多大比重，以及你是否愿意为 Agent 类能力付到 Premium 档。

定价

Cursor 现在作为 The X Subscription 的一部分售卖——一份订阅同时覆盖 Grok、Cursor 和 X。截至 2026-10-21 的官方档位：

年付为 Plus $80/年、Premium $300/年、Super $1,000/年、Ultra $2,000/年。以上档位、价格与用量规则见 Cursor Models & Pricing 文档 与 cursor.com/pricing（核验于 2026-10-21）。

旧的 Pro / Pro+ / Ultra / Start / Teams 档位已被标记为 legacy，官方说明是「继续按原样工作，含两个月度用量池和按需用量」。如果你在旧文档里看到 Pro $20、Business $40，那是 legacy 计划的价格，新用户已无法购买。

用量按周刷新，一个池子跨编辑器 Agent、CLI、Cloud Agents、Grok Bot 和 Grok 应用共享；不同模型从池子里扣费的速度不同。剩余用量和下次重置日期在编辑器设置和 grok.com/dashboard 的 Usage 里查看。

作为参考，GitHub Copilot 截至 2026-10-21 的档位是 Free / Pro $10 / Pro+ $39 / Max $100（github.com/features/copilot/plans）。Cursor Plus $8 对比的是 Copilot Pro $10，便宜 $2，但 Plus 只有自有模型；要用 Claude、GPT、Gemini 这些第三方模型，需要 Premium 及以上。

两个入口，加一个上下文来源

Tab 补全：写代码时

使用频率最高的功能。它不只是补下一个 token，而是预测你的下一个逻辑修改：

• 补全多行代码块
• 预测下一步编辑（你在第 10 行重命名了变量，它建议在第 25 行做同样处理）
• 填充跨行的重复模式
• 跨文件预测——一个文件的改动需要另一个文件同步更新时，它会跟过去
• 接受建议后再按一次 Tab 会「跳转到下一个编辑位置」，省去手动滚动

官方文档说明它支持多行编辑、补齐缺失的 import，以及相关代码的协同改动。实际可用比例取决于代码库的语言和模式规范程度，本文没有做横向对照测试。

失效场景：带领域特定模式的复杂业务逻辑，以及偶尔建议错误的 import。

Agent（Cmd+I）：派任务时

选中代码或直接提问，Agent 会独立完成多步任务：编辑文件、运行终端命令、搜索代码库。

范围明确、边界清楚的任务能直接交出去，比如「为 API 返回 429 状态码的情况添加错误处理」「把这个 class 组件转成带 hooks 的函数组件」「为这个文件中所有导出函数添加 JSDoc 注释」。

反过来，下面几类会失控：「让这段代码更快」这类没有验收标准的指令，跨多个互相依赖文件又没有明确约束的重构，以及它拿不到上下文的代码（比如项目内部的私有 API）。

值得先试的是 diff 预览：你能看到精确的变更，逐块接受或拒绝。Copilot Chat 的常见流程是在聊天窗口拿到代码后自行粘贴，两种交互的审查粒度不同。

任务量更大时用 Projects：协调 agent 自己不动手，只做规划，把编码派给其他 agent，再把完成的工作交回给你检查。它跑在 Agents Window 左侧导航里，底层是 Cloud Agents。

因为依赖 Cloud Agents，Projects 只在含该能力的档位可用（Premium 及以上），Free 和 Plus 用不了；Enterprise 需要 Cursor 3.21.9 或更高版本。它也不能与旧版 Privacy Mode 同时使用——Cloud Agents 运行时要在云端存代码。

上下文来源：Agent 能看到什么

Agent 找代码主要靠本地搜索，不是云端语义索引。官方文档说明它用内置的 Instant Grep 做精确匹配（函数名、变量名、报错文本、正则），索引在本机构建和查询，Cursor 不上传文件路径或代码来建索引，也不为搜索存储代码的 embedding。当前打开命中的文件内容仍会随请求发给模型。

围绕这套机制，它可以：

• 按符号自动搜索——问「auth 中间件怎么工作的」时用 grep 找到相关文件
• 用 @文件名 引用特定文件——「@schema.prisma User 表有哪些索引？」
• 派 Explore subagent——在独立上下文窗口里用更快的模型执行大量搜索
• 多文件编辑——要求跨多个文件修改，它为每个文件生成 diff
• 用 @docs 引用文档——指向外部文档 URL 获取上下文

示意 prompt（未执行）：

@utils/auth.ts @middleware.ts
重构 auth 检查：把 JWT 验证提取到一个共享工具函数中，
让 middleware 和 auth utils 都调用它。删除重复的逻辑。

Cursor 会读取两个文件，对每个文件提出修改建议，并展示可逐文件接受的 diff。

Cursor vs GitHub Copilot

选 Cursor：你经常做重构、频繁跨文件操作，希望 AI 理解整个项目上下文，并且愿意为 Cloud Agents、Bugbot 这类能力付费。

选 Copilot：你对当前编辑器设置满意，主要需要补全和内联建议，不想换编辑器。

实用技巧

1. 用 Rules 约束项目规范

项目规则写在 .cursor/rules 下，只有 alwaysApply: true 的才每次都进上下文，其余按 glob 或描述匹配触发；根目录的 AGENTS.md 是官方给的简化替代。规则写得越具体，输出越少偏离项目约定。例如：

这是一个 Next.js 15 项目，使用 App Router 和 TypeScript。
默认使用 Server Components，只在需要时使用 "use client"。
使用 Tailwind CSS 做样式，不使用 CSS modules。
所有 API 路由必须用 zod 做输入校验。

官方文档把 Rules 分四类：项目规则存在 .cursor/rules 目录并纳入版本控制，另有用户级全局规则、Team/Enterprise 的团队规则，以及可直接用 AGENTS.md 作为简化替代。此外还有 Skills、Subagents、Hooks、MCP 等扩展机制。

2. 提示词要具体

差：「修一下这个 bug」

好：「UserProfile.tsx 中的 useEffect 在每次渲染时都运行，而不是只在 userId 变化时运行。修复依赖数组，并解释当前实现为什么有问题。」

3. 仔细审查 diff

建议不是万无一失的。常见错误：

• 删除了有特定原因存在的空值检查
• 添加不必要的 async/await
• 从错误的包版本导入
• TypeScript 中的类型收窄细微问题

4. 用 Tab 加速重复模式

在测试文件、配置项或 API handler 里写类似代码时，手动写第一个，让 Tab 预测其余部分。重复度越高，收益越明显。

5. 索引外部文档

对 API 变化快的框架（Next.js、SvelteKit、tRPC），用 @docs 指向最新文档。否则可能生成过时 API 版本的代码。

局限性

• 资源占用 — 作为独立编辑器，它和 VS Code + Copilot 不是同一套运行时，切换前应在自己的机器上实测日常项目的响应。
• 扩展兼容性 — 大部分 VS Code 扩展可用，但深度集成编辑器的扩展可能出问题。切换前检查必备扩展。
• 用量按周刷新而非按月 — 这是 2026 年的变化。好处是某天重度使用不会吃掉整月额度，但也意味着不能把额度「攒」到月底集中用。
• 第三方模型要额外付费 — Premium 起可以用 Claude、GPT、Gemini，但按 API 列表价从预付额度扣，不包含在月费里。
• 学习曲线 — 要获得好结果，需要先学会把任务范围和验收标准写清楚。