Skip to content
返回 AI 编程

Cursor AI 编辑器工作流指南

掌握 Cursor 的 AI 原生功能，实现更快、更高质量的编程。

Cursor入门

为什么

据 Sacra 估计，Cursor 在 2024 年 11 月达到 6500 万美元 ARR（同比增长 6400%），JetBrains 2026 年 1 月 AI Pulse 调查显示 18% 的专业开发者在工作中使用 Cursor。Cursor 是 VS Code 的深度 AI 集成分支。

与外挂插件不同，它能理解整个代码库，支持通过 Cmd+K 进行内联编辑，并提供具有项目全局上下文的聊天侧边栏。采用结构化工作流可以避免接受幻觉代码或失去对 AI 变更追踪等常见问题。

何时使用

当你希望在不离开 IDE 的前提下进行 AI 辅助开发时，将 Cursor 作为日常工具。它擅长：全新功能脚手架、测试生成、跨文件重构和理解陌生代码库。

对于长时间运行的智能体任务或 CI 集成，切换到终端工具（Claude Code）。

如何做

1. 从 cursor.com 安装 Cursor — 它会自动导入你的 VS Code 扩展和设置。 2. 在项目根目录配置 .cursorrules，为 AI 提供项目特定上下文： - 技术栈（如 "Astro 7 + React 18 + Tailwind 3"） - 代码风格规则（如 "使用命名导出，页面除外不使用默认导出"） - 架构约束（如 "数据流通过 src/data/*.ts，绝不内联在组件中"） 3. 日常工作流： - Cmd+K：内联编辑 — 用自然语言描述变更，审查 diff，接受/拒绝 - Tab：接受内联补全（Ctrl+→ 部分接受） - Cmd+L：打开带代码库上下文的聊天 — 问 "X 在哪里处理？" 或 "为 Y 写测试" - @file：在聊天中引用特定文件以获取定向上下文 4. 代码库索引：Cursor 在首次打开时索引项目。大规模结构变更后通过 Cmd+Shift+P → "Cursor: Rebuild Index" 重建。

示例

.cursorrules 用于 Astro + React 项目： 你正在开发一个 Astro 7 静态站点，使用 React 18 islands。 - 构建：'npm run build'（tsc + astro build） - 数据事实源：src/data/*.ts → astro/data/*Index.ts（派生） - 绝不在组件中内联数据；始终从 src/data/ 导入 - �!组件使用命名导出；仅 Astro 页面使用默认导出 - i18n：9 语言，en 在根路径，其余在 /{locale}/ - CSS：Tailwind 3，含 spark/ink 自定义色板 要求 Cursor "按照现有 hub 模式添加 /books hub" 现在会生成匹配你架构的代码， 而非通用 Next.js 模式。

常见问题

  • ⚠Cursor 建议 `import x from 'nonexistent-pkg'` → 检查 package.json；若缺失运行 `npm install <pkg>` 并验证导入路径可解析。
  • ⚠错误：大文件出现 "Context window exceeded" 警告 → 用 @file 限定上下文，或结构变更后运行 Cmd+Shift+P → 'Cursor: Rebuild Index'。
  • ⚠盲目接受：过快按 Tab 接受错误补全 — 在关键路径上放慢速度
  • ⚠Cursor 建议 `import x from 'nonexistent-pkg'` → 检查 package.json；若缺失运行 `npm install <pkg>` 并验证导入路径可解析。

最佳实践

  • ✓维护 .cursorrules 文件 — 这是提升输出质量最高杠杆的配置
  • ✓接受前审查每个 AI diff；大量使用 Cmd+Z
  • ✓用聊天（Cmd+L）探索，用 Cmd+K 做精准编辑 — 不要混用
  • ✓大型 AI 操作前先 commit，以便结果错误时 git reset
  • ✓用 @file/@folder 限定上下文，减少大代码库上的幻觉

常见问题解答

Cursor 和 GitHub Copilot 有什么区别？

Cursor 是 VS Code 的分支，AI 深度集成在编辑器中（Cmd+K 内联编辑、全代码库聊天、项目索引）；Copilot 是插件，在你现有的 VS Code 中添加补全和聊天。Cursor 集成更深，拥有全代码库上下文，但意味着要采用一个独立编辑器。

Cursor 的上下文窗口如何工作？

Cursor 索引整个项目，按提示词检索相关片段。用 @file/@folder 精确限定上下文，或让它自动选择。超大文件会被截断，因此对大模块 @file 比自动上下文更可靠。

Cursor 是免费还是付费？

Cursor 有免费档（快速请求有限）和 Pro 档（约 $20/月，更多快速请求和更大模型）。免费档慢速请求不限。大多数日常使用适合免费档；全天重度 AI 使用适合 Pro。

Cursor 能理解我的整个代码库吗？

能，通过首次打开时构建的代码库索引。它按查询检索相关文件。大规模结构变更后重建（Cmd+Shift+P → Cursor: Rebuild Index）。定向工作时 @file 引用比自动检索更精确。

如何避免在 Cursor 中出现 AI 幻觉？

维护含技术栈和约束的 .cursorrules，用 @file 而非整文件夹限定上下文，接受前审查每个 diff。提交前检查导入是否解析、构建是否通过——幻觉包和 API 是最常见故障。