Cursor 使用
概述
Cursor提供独立编辑器，该编辑器基于 VsCode 开发，并持续跟进最新版的 VsCode，安装后可直接导入 VsCode 配置; Cursor之所以提供独立编辑器，是因为插件无法满足部分功能定制需求。
Cursor 免费版每月有 2000 次基本代码补全，这点与 Copilot 相同；但 Cursor 的补全次数用尽后会切换为慢速请求，而 Copilot 则是 2000 次固定额度。
升级付费版后，两者都有无限次数的代码补全，且代码补全所使用的模型能力更强。
Cursor 和 Copilot 用于代码补全的模型都是基于 Claude 3.5 Sonnet 、 GPT-4o 等模型蒸馏出的轻量级定制模型，用户无法自主切换；用户只能切换聊天对话时的模型。
使用 Cursor 编辑器打开项目后，Curosr 会自动对项目整体进行分析，并建立索引；项目在持续开发时，Cursor 也会自动监控并增量更新全局索引，
Claude code 需要主动执行 init 命令来识别整个项目，然后创建或更新项目的 CLAUDE.md 文件，这个文件主要是用于保存项目的结构总结、规则说明、提示和上下文指令等。
/init 会帮助生成这个上下文摘要文件，有助于后续的交互更具项目整体理解；如果项目发生了变化，可以手动执行 init 来更新 CLAUDE.md 文件；但这并不是必须的，因为 Claude Code 并不 完全必须 手动 init 才能识别项目，它在处理请求时会实时分析当前代码，但 /init 主要是为了生成有用的上下文文件（CLAUDE.md）以便于后续交互。
Cursor 和 Claude code 都是非常优秀的 AI 编码客户端工具，因此用户量很大；Cursor 主要是方便，但贵并免费版无法接入自定义模型；而 Claude code 生成完善，且免费就可以接入自定义模型。
Codex 目前并不支持自定义模型；
开发前端后项目时，应该将前后端代码放在一个目录下，以消除 AI 的“信息孤岛”，并在根目录下放置 AI 相关声明文件，例如：.cursorrules、cursor.rules ，以便告诉 AI 如何处理这个全栈项目。也可以不放在一个目录下，直接使用 AI 工具的相关命令，将另一个目录也纳入到当前项目中来。
配置中文
1>. 配置菜单按钮中文：与 Vscode 相同，使用三方插件实现；
2>. 配置 AI 以简体中文回复，打开 文件 -> 首选项 -> Curosr Setting ，如下图：
Always respond in Chinese-simplified
3>.配置 AI 将代码中的注释自动翻译为“简体中文”
基本使用
- Tab – 智能代码补全
- Cmd/Ctrl + K – 内联编辑
- Cmd/Ctrl + I / Cmd + L – 打开 AI Chat 界面（问答/修改/生成）
各模式使用
Ask：问答 & 沟通模式
📍 定位：纯问答/解释/交流，不改代码
- 只能用于 提问/交互（自然语言对话）
- 不会直接生成或改动文件
- 给你解释概念、设计方案、理解需求等
📌 典型用途：
✔ 问“什么是 React 的 useEffect 依赖数组？”
✔ 请教某个设计方案的 pros/cons
✔ 解释 stack trace 或日志含义
Plan：计划模式
📍 定位：需求拆解、任务规划专家
- 接受 高层需求
- 进行 逐步需求拆解
- 输出的是 执行计划 + 任务清单
📌 典型用途：
✔ 你说 “做一个购物车功能”
→ 它会拆成：路由/状态/组件/接口/测试等清单
✔ 输出多步计划而不是代码本身
注：此模式不支持写入文件，因此输出的需求需要自己写入到文档中；
Debug：调试模式
📍 定位：专攻“查 BUG 与修复流程”
区别于单纯写补丁：它会沿着 调试套路 去分析问题。
📌 内部流程（图中循环）
读日志 → 假设问题 → 复现 → 阅读更多日志 → 分析 → 修复 → 验证
⚡ 典型用途：
✔ “帮我依据这个日志定位错误根因并生成修复补丁”
✔ “我运行失败，反馈如下，看下可能的原因”
Agent：通才模式
📍 定位：综合执行者，是 Plan + Ask + Debug 的“大脑封装版”
Agent 可视为：
🧠 自动规划（Plan）
⚙️ 自动执行
🔍 自动调试
📚 自动互动
可跨文件、大规模改动，甚至按需求自动分配任务。
📌 典型用途：
✔ “把这个项目升级到最新依赖并修复所有错误”
✔ “生成 API 规范文档 + 实现 + 单元测试”
✔ “根据这个需求自己拆解、优化、生成代码”
理解项目
AI 在 Cursor 中理解整个代码库，而不是单一文件。你可以：
🔹 自动重命名函数并同步所有引用
🔹 让 AI 批量补全数据库迁移脚本
🔹 大规模重构指定模式代码（解耦、优化性能等）
自定义规则（Cursor Rules）
在项目根目录创建 .cursor/rules 可定义专用规则，例如代码风格、测试覆盖率要求等，让 AI 遵循团队规范。
📌 示例：
# .cursor/rules
rule:
description: enforce TS return types
pattern: "*"
注意：AI 是助手，不是替代品。
- ⭐ 切勿让 AI 一次生成大量代码未审查
- ⭐ 分块提示（Chunk-based）比 “写整个类” 更稳妥
- ⭐ 先生成测试，再生成功能（TDD 模式）
