Cursor安装及使用

官网：cursor.com | 文档：cursor.com/docs

Cursor IDE 与 Windows Agent 介绍及区别

Cursor IDE 是面向开发者的智能编辑器，支持代码编辑、项目管理和调试，适用于日常开发、批量重构等多种场景。

Windows Agent 是 Cursor 在 Windows 系统上的本地助手，辅助 IDE 访问本地文件、执行 terminal 命令等操作，支持需要本地权限的功能。

区别总结：

对比项	Cursor IDE	Windows Agent
工作平台	跨平台（主程序，核心编辑环境）	Windows 系统（本地辅助，后台进程）
主要作用	智能编码、文件管理、AI 协助	本地兼容性、执行本地命令和文件访问
是否独立使用	是（主要开发入口）	否（通常和 IDE 配合，自动后台运行）
场景举例	日常开发、AI 辅助、远程协作	本地依赖安装、文件操作、命令行执行

简单来说：Cursor IDE 是开发工作的主编辑器，而 Windows Agent 则是在 Windows 下的助手，辅助执行一些需要本地权限的高级功能。二者配合使用，AI编程体验更丝滑。

快捷键

快捷键	功能
`Ctrl + L`	打开 Chat 对话，选中代码再按会把选中代码添加到上下文
`Ctrl + K`	内联编辑代码
`Ctrl + /`	循环切换 AI 模型（Agent/Ask/Plan）
`Ctrl + Shift + G`	打开 Source Control 查看修改历史
`Ctrl + J`	打开 Terminal
`Ctrl + Shift + J`	打开 Cursor 设置
`Tab`	接受补全建议

五种模式

模式	说明	何时用
Agent	完全自主，探索项目、执行命令、多文件修改	复杂任务、批量操作、自动化
Plan	AI 先分析并制定计划，用户确认后再执行	复杂重构、多文件改动
Debug	专门优化用于排查错误	Bug 排查、性能问题
Multitask	同时处理多个独立任务	批量生成、并行重构
Ask	只读模式，只回答不修改文件	学习代码、方案咨询

Agent 能做什么

自主探索项目结构和代码
读取和修改任意文件
执行终端命令（安装依赖、运行测试、构建项目）
跨多个文件协调修改
自动创建目录结构和配置文件
提交 git commit 和管理分支

实战示例：

"把这个项目从 JavaScript 迁移到 TypeScript"
"为项目所有工具函数添加单元测试"
"添加 ESLint 和 Prettier 配置"

Plan 工作流

步骤	说明	用户操作
1. 分析	AI 扫描相关文件	等待
2. 制定计划	生成详细修改步骤	阅读
3. 用户确认	等待确认	确认 / 调整
4. 执行修改	按计划逐步执行	监控进度
5. 总结报告	列出修改的文件	检查结果

Ask 安全模式

不会修改任何文件，只读分析代码，适合学习代码、咨询方案。按 Ctrl + / 快速切换模式。

Debug 模式是什么

Debug 模式专为排查和修复 Bug 设计。它能结合上下文，自动定位报错位置、分析出错原因，并给出详尽的修复建议。你还能让 AI 跟踪日志、逐步分析流程，适合调试疑难代码或性能问题。

Debug 模式特点：

自动识别、定位常见 Bug 和异常
给出改动建议但不擅自大范围修改
支持结合错误日志分析
适合生产环境、安全场景下排查

示例：

"帮我定位 main.py 的报错原因"
"分析这个接口为何超时，并优化性能"

Multitask 多任务模式

Multitask（多任务）模式适合并行处理一组独立任务。例如：批量生成注释、对多个文件执行类似改动。Cursor 会自动拆分子任务，并发执行，大幅提升效率。结果可单独检查和确认，避免相互影响。

Multitask 模式特点：

支持批量独立任务并发处理
子任务互不干扰，便于逐个审阅
适合批量生成、并行重构、重复性改动

示例：

"为所有 utils 目录下函数生成中文注释"
"把 10 个接口文档批量迁移到新格式"

总结

1. 新项目    → Ask 模式了解代码结构
2. 多文件改动 → Plan 模式查看修改计划
3. 明确任务  → Agent 自动执行
4. 遇到 Bug  → Debug 模式
5. 批量任务  → Multitask 并行

学习路径

L1 入门: Ask 提问、Tab 补全、Cmd+K 内联编辑
         ↓
L2 进阶: Plan 复杂修改、根据场景切换模型
         ↓
L3 精通: Agent 批量任务、Terminal 协同
         ↓
L4 大师: Debug/Multitask 模式、自定义 Agent 工作流

常见问题

Q: Agent 和 Plan 模式如何选择？
A: 简单任务用 Plan（先规划），复杂批量任务用 Agent（完全自主）。

Q: Ask 模式有什么特别？
A: 只读模式，AI 只回答不修改文件，最安全。

Q: Auto 模型会自动切换吗？
A: 是的，Auto 会根据任务自动选择最优模型。

模型选择

右上角模型下拉框选择，勾选 Auto 让 Cursor 自动选择。

模型	特点	推荐场景
Auto	自动选择最合适的模型	⭐ 推荐日常使用
Composer 2.5 Fast	Cursor 专版，高速优化	代码生成首选
Fable 5 High	旗舰模型，综合能力强	⭐ 日常首选
Sonnet 5 High	Claude 旗舰，质量最佳	追求质量
Opus 5 High	最强推理	复杂逻辑任务
Cursor Grok 5 High Fast	速度优先	快速响应
GPT-5.6 Sol Medium	OpenAI 平衡性能	备用选择

使用建议：

日常开发：Auto 或 Fable 5 High / Sonnet 5 High
追求速度：Cursor Grok 5 High Fast
复杂逻辑：Opus 5 High
新功能：试试 Composer 2.5 Fast

自定义扩展(Rules/Skills/MCP)

方式	说明
Rules	`.cursor/rules/` 添加项目规范
MCPs	Model Context Protocol 扩展
Skills	可复用技能包

Rules（项目规范）

在 .cursor/rules/ 目录下创建规则文件，定义项目的编码规范、架构约定和特定要求。

创建方式：

在项目根目录创建 .cursor/rules/ 文件夹
添加 *.md 规则文件（如 typescript.md、naming.md）
AI 会自动读取并遵循这些规范

规则文件示例：

# naming.md
## 命名规范
- 组件名称使用 PascalCase（如 UserProfile.tsx）
- 工具函数使用 camelCase（如 getUserInfo）
- 常量使用 UPPER_SNAKE_CASE
- 文件名与导出名称保持一致

使用场景：

统一团队代码风格
强制特定技术栈规范
添加项目特有的业务逻辑约束

MCPs（模型上下文协议）

MCP 是一种扩展协议，允许 Cursor 连接外部数据源和工具。

配置方式：
在 Cursor 设置中添加 MCP 服务器配置，连接数据库、API、文档系统等外部资源。

常用 MCP 场景：

MCP 类型	功能
数据库	直接查询 MySQL、PostgreSQL、MongoDB
API	连接 GitHub、Slack、Linear 等第三方服务
文档	接入 Confluence、Notion 等知识库
工具	集成 Jira、Figma、Sentry 等开发工具

示例 - 配置数据库 MCP：

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-mysql", "--host", "localhost"]
    }
  }
}

Skills（技能包）

Skills 是可复用的任务模板，封装了常用的工作流程和提示词。

内置 Skills：

Skill	功能
`code-review`	代码审查，提出优化建议
`bug-troubleshoot`	排查常见问题
`generate-api-doc`	生成 API 文档
`generate-crud`	生成标准 CRUD 代码
`import-export`	列表页面导入导出功能

使用方式：
在 Chat 中引用 Skill，如：

@skill:code-review

自定义 Skills：

在 .cursor/skills/ 目录创建技能文件
定义技能名称、触发词和提示词模板
团队成员可共享使用

典型使用场景：

封装项目特定的代码生成模板
标准化代码审查流程
复用团队最佳实践

CLI 命令行(Windows环境下使用Windows Agent即可)

什么时候适合使用 CLI 模式？

自动化批量处理：需要批量执行分析、重构、批改、优化等重复性任务时，CLI 比 GUI 操作效率高。
集成到 CI/CD 流程：可以把 agent 命令加入到自动化流水线或脚本，实现自动代码检查、审查、发布等。
远程开发环境：在无桌面的服务器、云开发环境、或本地 WSL/容器中没有 GUI 时，CLI 直接操作更方便。
高级定制需求：通过管道（pipe）、参数组合，实现更复杂或个性化的用法，便于与 git、shell、其他工具配合。
自动保存与结果追踪：CLI 输出更适合自动保存结果到文件、日志，便于后续分析和追踪。
辅助原型开发/调试助手：快速试验、编写小脚本辅助开发，有助于提高日常开发效率。

总结：CLI 模式更适合自动化、批量化、无头环境、脚本集成场景；GUI 更适合交互性、可视化、探索式操作。

# macOS / Linux / WSL
curl https://cursor.com/install -fsS | bash

# Windows PowerShell
irm 'https://cursor.com/install?win32=true' | iex

# 查看版本
agent --version

### 交互模式
# 启动对话
agent

# 带初始指令启动
agent "重构 auth 模块，使用 JWT"

### 非交互模式
# 执行特定任务
agent -p "查找并修复性能问题" --model "gpt-5"

# 配合 git 变更审查
agent -p "审查这些变更的安全问题" --output-format text

### 会话管理
agent ls        # 查看历史会话
agent resume    # 恢复最近会话
agent --continue  # 继续上一会话
agent --resume="chat-id"  # 恢复指定会话

模式切换

模式	命令	说明
Agent	默认	复杂任务，完全自主
Plan	`/plan` 或 `--mode=plan`	先规划再执行
Ask	`/ask` 或 `--mode=ask`	只读问答

集成

Cursor 与主流开发工具和服务深度集成，开箱即用。

代码托管平台

平台	功能
GitHub	代码同步、PR 创建与审查、Issue 管理、Actions 集成
GitLab	代码同步、MR 审查、CI/CD 流水线触发
Azure DevOps	企业级 Git 仓库、Pipeline 集成

使用方式：

在 Cursor 设置中授权对应平台账号
打开项目后自动识别仓库并同步
可直接在 Cursor 内查看 PR、提交评论

团队协作工具

工具	功能
Slack	任务通知、代码审查提醒、构建状态推送
Linear	Issue 关联、任务状态同步
JetBrains	与 IntelliJ、PyCharm 等 IDE 协同使用

典型场景：

PR 审查时自动发送 Slack 通知
Linear Issue 关联代码变更
跨 IDE 无缝切换开发

IDE 扩展

Cursor 基于 VS Code 构建，兼容其生态：

插件市场：VS Code 插件可直接安装
快捷键兼容：可选 VS Code 键位方案
主题扩展：支持自定义编辑器和 UI 主题

秋夜雨巷

GitHub地址: https://autkevin.github.io/
本博客是为了记录工作和学习中的总结，可以交流学习，请勿在不理解的情况下直接复制粘贴

Cursor安装及使用

Cursor安装及使用

Cursor IDE 与 Windows Agent 介绍及区别

快捷键

五种模式

Agent 能做什么

Plan 工作流

Ask 安全模式

Debug 模式是什么

Multitask 多任务模式

总结

学习路径

常见问题

模型选择

自定义扩展(Rules/Skills/MCP)

Rules（项目规范）

MCPs（模型上下文协议）

Skills（技能包）

CLI 命令行(Windows环境下使用Windows Agent即可)

模式切换

集成

代码托管平台

团队协作工具

IDE 扩展

相关官方链接

公告

秋夜雨巷

GitHub地址: https://autkevin.github.io/ 本博客是为了记录工作和学习中的总结，可以交流学习，请勿在不理解的情况下直接复制粘贴

Cursor安装及使用

Cursor安装及使用

Cursor IDE 与 Windows Agent 介绍及区别

快捷键

五种模式

Agent 能做什么

Plan 工作流

Ask 安全模式

Debug 模式是什么

Multitask 多任务模式

总结

学习路径

常见问题

模型选择

自定义扩展(Rules/Skills/MCP)

Rules（项目规范）

MCPs（模型上下文协议）

Skills（技能包）

CLI 命令行(Windows环境下使用Windows Agent即可)

模式切换

集成

代码托管平台

团队协作工具

IDE 扩展

相关官方链接

公告

GitHub地址: https://autkevin.github.io/
本博客是为了记录工作和学习中的总结，可以交流学习，请勿在不理解的情况下直接复制粘贴