Cursor Guide

______________________________________________________________________

标题：首页 导航顺序：1

Cursor IDE：完整的技术指南

Master Cursor IDE，实现最高生产力\ 目标受众： 高级开发人员、技术主管、工程团队\ 维护者维亚查斯劳·库兹诺 (viachaslau_kudzinau@epam.com)\ 最后更新时间： 2026年1月

______________________________________________________________________

🎯 你将掌握什么

本综合指南教您如何利用 光标IDE 用于：

• ✅ 选项卡自动完成 -快速、预测性代码完成（320ms）
• ✅ 内联编辑（Cmd+K） -外科手术，重点改变
• ✅ 作曲家/代理（Cmd+I） -多文件编排
• ✅ 规则 -始终处于约束和护栏上(.cursor/rules/*.md)
• ✅ 技能 -可选的可重用工作流(.cursor/skills/)
• ✅ 钩子 -自主迭代的生命周期控制(.cursor/hooks.json)
• ✅ 调试模式 -假设驱动调试
• ✅ 并行代理 -同时探索多种解决方案
• ✅ 可视化编辑器 -实时UI样式和设计
• ✅ MCP集成 -连接到外部系统（Slack、GitHub、数据库）
• ✅ 背景7 -实时、特定版本的库文档（MCP工具）
• ✅ 多种AI模型 -克劳德4.5，GPT-5，双子座3，光标编辑器
• ✅ 企业模式 -团队协作和部署

______________________________________________________________________

🚀 5分钟内赢得第一场胜利

1.使用选项卡自动完成

// Just start typing and press Tab
function calculateMonthlyPayment(principal, rate, years) {
  // Tab suggests the entire implementation
}

2.使用Cmd+K进行内联编辑

Select a function
Press Cmd+K (Windows: Ctrl+K)
"Refactor this function to use async/await and add error handling"

3.使用Composer的多文件功能

Press Cmd+I (Windows: Ctrl+I)
"@codebase Add authentication to the entire application"

4.使用调试模式进行调试

"This function returns undefined intermittently. Debug and fix it."
Agent instruments code, analyzes logs, proposes fix

______________________________________________________________________

📚 导向结构

第1部分：基础和核心概念

构建基本的心理模型，了解Cursor的架构。

✅ 第1节：心智模型与架构

状态： 完成✅\ 了解Cursor的想法：Tab vs Inline Edit vs Composer vs Agent、AI模型选择、上下文窗口、规则架构和MCP集成。

关键概念：

• 工具选择矩阵（Tab、Cmd+K、Cmd+I、调试模式、并行代理）
• 8个AI模型以及何时使用
• 上下文窗口和代码库索引
• 规则、技能和指令层次结构
• 可重用工作流的技能架构
• 用于生命周期控制和自主迭代的钩子
• 规则架构（项目规则、AGENTS.md、团队规则）
• 模型上下文协议（MCP）和上下文7

时间： 45分钟

______________________________________________________________________

✅ 第2节：环境和项目设置

状态： 完成✅\ 安装游标，配置工作区，创建 instructions.md，设置规则，并针对您的项目规模进行优化。

主要议题：

• 安装和订阅层
• 代码库索引策略（小型仓库与单仓库）
• instructions.md 模式（单一事实来源）
• 规则vs技能vs指令决策框架
• 项目规则(.cursor/rules/*.md)设置
• 可重用工作流的技能(.cursor/skills/)
• 生命周期控制挂钩(.cursor/hooks.json)
• .cursorignore 配置
• 可重复使用提示的命令功能
• Monorepo最佳实践

时间： 30-45分钟

______________________________________________________________________

✅ 第3节：核心工作流程

状态： 完成✅\ 使用Cursor掌握基本的日常开发工作流程。

关键工作流程：

• 带有技能和钩子的TDD模式（首先用自主迭代进行测试）
• TDD自动化的测试循环技巧
• 挂钩+YOLO模式用于验证循环
• 重构模式（多步骤、增量）
• 调试模式工作流程（假设驱动）
• 并行代理（探索多种方法）
• 基础设施即代码（Terraform、CDK）
• 渐进式增强图案

时间： 45分钟

______________________________________________________________________

第2部分：高级功能和可视化开发

状态： 完成✅

复杂的工作流程和可视化开发模式。

• 高级配方（API迁移、数据库迁移、大规模重构）
• 可视化开发（截图到代码、可视化编辑器、比较调试）

______________________________________________________________________

第3部分：DevOps和后端架构

状态： 完成✅

基础设施和后端模式。

• DevOps和基础设施（Kubernetes与MCP、Terraform、Docker、CI/CD）
• 后端架构模式（微服务、事件源、CQRS、API网关）

______________________________________________________________________

第4部分：上下文管理和提示

状态： 完成✅

掌握上下文和高级提示。

• 上下文管理（上下文优先方法、聚焦上下文、会话卫生）
• 高级提示策略（思维链、多工具编排、模型集成）

______________________________________________________________________

第5部分：团队协作和领域模式

状态： 完成✅

团队合作和专业工作流程。

• 团队协作（共享规则、技能、团队记事本、结对编程、公关评论）
• 领域特定模式（Kubernetes、数据管道、ML培训）
• Runbook和护栏（项目规则模板、基于钩子的安全、YOLO+钩子）

______________________________________________________________________

第6部分：故障排除和参考

状态： 完成✅

完整的参考指南和解决方案。

• 故障模式和反模式
• 参考提示和模板
• 生产率基准
• 故障排除指南
• 面向未来的策略

______________________________________________________________________

🗺️ 学习路径

路径1：“15分钟内首次获胜”⚡

目标： 立即提高生产力

graph LR
    A["Install
5 min"] --> B["Setup
5 min"] --> C["First
Examples
5 min"] --> D["Start
Coding!"]
    
    style A fill:#e1f5ff
    style B fill:#fff4e1
    style C fill:#fff3cd
    style D fill:#d4edda

步骤：

1. 安装Cursor IDE（5分钟）
2. 创建 instructions.md 和 .cursor/rules/ 或 AGENTS.md （5分钟）
3. 尝试Tab、Cmd+K和Cmd+I（5分钟）
4. 开始在工作中使用

何时回来： 几个小时后，完成第1部分以加深理解。

______________________________________________________________________

路径2：“4小时内的主光标”🎓

目标： 全面掌握

graph LR
    A["Part 1
2 hr"] --> B["Part 2
1 hr"]
    B --> C["Part 4
1 hr"]
    C --> D["Cursor
Master"]
    
    style A fill:#e1f5ff
    style B fill:#fff4e1
    style C fill:#fff3cd
    style D fill:#90EE90,stroke:#2d862d,stroke-width:3px

步骤：

1. 第1部分： 基础与核心概念（2小时）
2. 第2部分： 高级功能和可视化开发（1小时）
3. 第4部分： 情境管理与提示（1小时）
4. 通过实际项目进行实践

结果： 自信地使用所有光标功能，速度提高30-40%。

______________________________________________________________________

路径3：“在2小时内激活你的团队”👥

目标： 团队采用率和一致性

graph TB
    A["Part 1
Setup"] --> B["Create Team
Config"]
    A --> C["Part 5
Collaboration"]
    
    B --> D["Share with
Team"]
    C --> D
    
    D --> E["Team
Onboarding"]
    
    style A fill:#e1f5ff
    style B fill:#fff4e1
    style C fill:#fff3cd
    style D fill:#d4edda
    style E fill:#90EE90,stroke:#2d862d,stroke-width:3px

重点领域：

1. 第1部分第2节： 环境和项目设置

- 创建共享 instructions.md - 设置 .cursor/rules/ 对于团队 - 配置 .cursorignore

1. 第5部分： 团队协作

- 共享规则存储库 - 团队记事本 - 常见任务的命令

1. 团队赋能：

- 将配置提交到git - 安排培训课程 - 轨道速度指标

结果： 团队一致性、更快的入职流程、共享最佳实践。

______________________________________________________________________

💡 生产率模式

刀具选择矩阵

选型指南

上下文@提及策略

______________________________________________________________________

💰 定价和投资回报率

订阅级别

• 免费层：请求有限，基本功能
• 专业级别 （每月20美元）：无限制请求，所有型号，优先支持
• 业务层：团队功能、管理控制
• 企业级：自定义部署、SSO、合规性

ROI示例

盈亏平衡： 大多数团队在2-4周内看到投资回报率。

______________________________________________________________________

⌨️ 基本键盘快捷键

核心功能

代理控制

导航

______________________________________________________________________

❓ 常见问题解答

Q： Cursor与GitHub Copilot有何不同？

A. Cursor是一个集成了AI的完整IDE（基于VS Code），而Copilot是一个扩展。主要区别：

• 速度： 光标标签快3倍（320毫秒比890毫秒）
• 多文件： Composer可以同时编辑多个文件
• 背景： 更好的代码库索引和上下文管理
• 模型： 访问Claude 4.5、GPT-5、Gemini 3和Cursor自己的Composer模型
• 特征： 调试模式、并行代理、可视化编辑器、MCP集成

Q： Cursor存储我的代码吗？

A. 不，代码永远不会离开你的机器。只有嵌入（用于代码库索引）在服务器端存储、加密和混淆。隐私模式使所有内容都保持在本地。

Q： 我可以在现有的VS代码设置中使用Cursor吗？

A. 对。Cursor基于VS Code构建，支持所有VS Code扩展、设置和键绑定。您可以导入您的VS代码配置。

Q： 学习曲线是什么？

A. 15分钟内达到基本生产力。4小时内精通。大多数开发人员看到了Tab和Inline Edit的即时价值。

Q： 定价是如何运作的？

A. 专业版（每月20美元）包括对所有型号的无限请求。免费套餐的请求有限。企业层可供团队使用。

Q： 我可以离线使用Cursor吗？

A. 选项卡自动补全脱机工作（缓存模型）。Composer、Agent和Chat需要AI模型的互联网连接。

Q： Cursor支持哪些语言？

A. VS Code支持的所有语言。AI功能最适合流行语言（TypeScript、Python、Go、Rust、Java等）。

Q： 我该如何开始？

A. 下载自 cursor.com、安装并遵循 第1部分：基础 用于设置。

______________________________________________________________________

🎯 快速入门检查表

第1周：基础知识

• \[\]安装游标IDE
• \[\]创建 instructions.md 为您的项目
• \[\]在中设置项目规则 .cursor/rules/*.md 或创建 AGENTS.md
• \[\]理解规则vs技能vs指令
• \[\]配置 .cursorignore
• \[\]主选项卡、Cmd+K、Cmd+I基础
• \[\]用良好的上下文编写前5个提示

检查点： 能够以2-3倍的速度完成简单任务

第2-3周：中级

• \[\]使用Composer进行多文件重构
• \[\]创建第一项技能（例如，测试循环）
• \[\]为验证循环设置挂钩
• \[\]用技能+钩子实现TDD模式
• \[\]使用钩子设置YOLO模式以实现自动化
• \[\]创建第一个自定义命令
• \[\]已成功使用调试模式

检查点： 通过自主工作流独立处理复杂任务

第4+周：高级

• \[\]运行并行代理
• \[\]创建团队技能库
• \[\]使用MCP访问实时基础设施
• \[\]实施团队记事本
• \[\]创建共享规则和技能库
• \[\]设置挂钩式安全护栏
• \[\]培训团队成员

检查点： 速度提高30-40%，团队采用率，自主工作流程

______________________________________________________________________

📖 其他资源

官方文档

• Cursor网站: cursor.com
• 光标文档: cursor.com/docs
• 光标更改日志: cursor.com/changelog

社区

• 光标论坛: forum.cursor.com
• 光标不一致: cursor.com/discord

本指南

• 版本：2.0（2026年1月）
• 维护者维亚查斯劳·库兹诺
• 电子邮件: viachaslau_kudzinau@epam.com
• 反馈：未决问题或联系维护人员

______________________________________________________________________

🚀 当前状态

✅ 已完成的章节

所有6个部分和17+个部分均已完成：

• 第1部分：基础和核心概念（3节）
• 第2部分：高级功能和可视化开发（2节）
• 第3部分：DevOps和后端架构（2节）
• 第4部分：上下文管理和提示（2节）
• 第5部分：团队协作和领域模式（3节）
• 第6部分：故障排除和参考（5节）

📊 指南统计

• 总节数： 17+
• 预计阅读时间： 10-12小时
• 快速启动时间： 15分钟
• 主路径时间： 4小时
• 团队启用时间： 2小时

______________________________________________________________________

📝 版本历史

v2.0（2026年1月）-重大重组：

• 完全重组为基于目录的组织（与副驾驶指南风格相匹配）
• 更新了最新的Cursor官方文档
• 添加了Claude 4.5 Opus、GPT-5.2、Gemini 3 Pro、Grok Code型号
• 与官方文档对齐的术语（选项卡、内联编辑、代理、编辑器）
• 增加了全面的学习路径
• 增强型快速参考表
• 添加常见问题解答部分
• 更新了键盘快捷键
• 改进导航和结构

v1.0（2025年12月）：

• 初始版本包含6个部分
• 全面的Cursor IDE覆盖范围

______________________________________________________________________

*这是一个随着Cursor而发展的动态文档。书签、分享和贡献，以保持最新状态！*

开始你的旅程： 第1部分：基础和核心概念→