Cursor 使用
下载安装
Cursor提供独立编辑器，请到官网下载。
注：Cursor完全基于 vscode 开发，实测安装后会与 vscode 冲突，导致 vscode 的右键菜单失效；因此，安装时请勿勾选“添加到右键菜单”、“添加到注册表”等选项；
配置中文
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 模式）
