WHAT - cursor cli 开发范式

文章目录

[Cursor vs Cursor CLI](#Cursor vs Cursor CLI)
- [Cursor 编辑器（桌面版）](#Cursor 编辑器（桌面版）)
- [Cursor CLI（命令行）](#Cursor CLI（命令行）)
- 怎么选
典型使用场景
- [Cursor 编辑器：适合「人在屏幕前、持续开发」的场景](#Cursor 编辑器：适合「人在屏幕前、持续开发」的场景)
- - [1. 日常开发与阅读代码](#1. 日常开发与阅读代码)
  - [2. 调试与排错](#2. 调试与排错)
  - [3. 与 AI 的「可视化协作」](#3. 与 AI 的「可视化协作」)
  - [4. Git 与 Code Review](#4. Git 与 Code Review)
  - [5. 复杂 UI / 多模块联调](#5. 复杂 UI / 多模块联调)
  - [6. 学习与探索不熟悉的仓库](#6. 学习与探索不熟悉的仓库)
  - [7. 团队与规范落地](#7. 团队与规范落地)
- [Cursor CLI：适合「从终端驱动、自动化、轻量接入」的场景](#Cursor CLI：适合「从终端驱动、自动化、轻量接入」的场景)
- - [1. 从 shell 快速打开工作区](#1. 从 shell 快速打开工作区)
  - [2. 与脚本 / Makefile / npm scripts 结合](#2. 与脚本 / Makefile / npm scripts 结合)
  - [3. SSH / 远程 / 无图形界面环境](#3. SSH / 远程 / 无图形界面环境)
  - [4. CI / 流水线里的「轻量动作」](#4. CI / 流水线里的「轻量动作」)
  - [5. 与其它 CLI 工具链衔接](#5. 与其它 CLI 工具链衔接)
  - [6. 多仓库切换频繁时](#6. 多仓库切换频繁时)
  - [7. 资源或场景受限时](#7. 资源或场景受限时)
- 对照小结（按需求选）
[Cursor CLI 常用命令](#Cursor CLI 常用命令)
- [`/` 在 CLI 里做什么](#/ 在 CLI 里做什么)
- 命令按用途分组（含常用标注）
- - [1. 工作模式（很常用）](#1. 工作模式（很常用）)
  - [2. 模型与执行安全（常用）](#2. 模型与执行安全（常用）)
  - [3. 会话与上下文（常用）](#3. 会话与上下文（常用）)
  - [4. MCP 与项目约定](#4. MCP 与项目约定)
  - [5. 终端与编辑体验](#5. 终端与编辑体验)
  - [6. 账号、排障与退出](#6. 账号、排障与退出)
- [和文档里其它 CLI 能力的关系](#和文档里其它 CLI 能力的关系)
- 小结

Cursor vs Cursor CLI

Cursor 编辑器（桌面版）

形态：基于 VS Code 的图形化 IDE（独立应用）。
适合：日常写代码、看项目结构、调试、多文件编辑、用扩展和内置终端。
特点：Chat / Composer、内联补全、多光标、断点调试、Git 图形界面、主题与键位等与「在编辑器里干活」相关的能力都在这里。

Cursor CLI（命令行）

官方：https://cursor.com/cn/cli

形态：在终端里用的 cursor 命令（以及与之相关的子命令，具体以官方文档为准）。
适合：从 shell 打开项目/文件、和 CI/脚本结合、在没开 GUI 的环境里触发能力、远程或自动化工作流。
特点：偏「从命令行驱动 Cursor / 打开工作区」，不是完整 IDE 的替代品；重度开发仍多在编辑器里完成。

怎么选

场景	更倾向
正常写代码、调试、看 UI	编辑器
脚本里打开仓库、自动化、SSH 里快速操作	CLI

两者是互补关系：CLI 负责「从终端连上你的工作区」，编辑器负责「在里面深度开发」。

典型使用场景

下面按「编辑器」和「CLI」分别展开典型使用场景，并标一下边界，避免和「在终端里跑别的命令」混在一起。

Cursor 编辑器：适合「人在屏幕前、持续开发」的场景

1. 日常开发与阅读代码

在工程里跳转定义、全局搜索、大纲、面包屑、多根工作区（multi-root workspace）。
同时打开多个文件、分屏对比、用扩展（ESLint、Prettier、语言服务等）做实时诊断与格式化。

2. 调试与排错

图形化断点、调用栈、变量监视、条件断点；前端还可配合浏览器调试。
边看日志（集成终端）边看代码，配合 AI 解释堆栈或复现步骤。

3. 与 AI 的「可视化协作」

Chat / Composer 里引用 @文件、@文件夹、@Codebase，边聊边改多文件。
内联补全、选中片段让 AI 改写，适合反复试 UI/接口形态。

4. Git 与 Code Review

图形化 diff、暂存区操作、分支切换；在 PR 式 diff 上讨论、用 AI 总结改动风险。
需要「一眼扫很多行 diff」时，编辑器比纯终端更省力。

5. 复杂 UI / 多模块联调

React/Vue 等组件树、样式、设计稿对照；多窗口预览。
需要频繁改少量代码 + 立刻看效果时，编辑器 + 终端一条龙。

6. 学习与探索不熟悉的仓库

依赖关系、调用链、扩展提供的「谁引用了谁」等，配合 AI 做「带导航的导读」。

7. 团队与规范落地

共享的 settings.json、推荐扩展、工作区配置；新人 clone 下来主要在编辑器里按团队习惯工作。

Cursor CLI：适合「从终端驱动、自动化、轻量接入」的场景

1. 从 shell 快速打开工作区

已在终端里 cd 到项目，一条命令打开当前目录或指定路径到 Cursor，省去手动 File → Open。

2. 与脚本 / Makefile / npm scripts 结合

例如「跑完生成代码后自动用 Cursor 打开生成目录」「一键打开某配置文件」这类固定路径的自动化。

3. SSH / 远程 / 无图形界面环境

在远程机上主要用终端时，用 CLI 触发「和 Cursor 生态相关」的入口（具体能力以安装的版本与官方说明为准）；本地仍可能用编辑器 SSH Remote 做重活。

4. CI / 流水线里的「轻量动作」

在流水线里打开报告路径、触发与 Cursor 集成的步骤（若团队规范允许且产品有对应能力）；注意：敏感密钥、全自动改代码要谨慎，通常 CI 里仍是传统 lint/test。

5. 与其它 CLI 工具链衔接

和 git、gh、docker、kubectl 等同一终端会话里串起来：先命令行拿结果，再决定要不要打开编辑器深入看。

6. 多仓库切换频繁时

终端里在不同 repo 间跳转，用 CLI 统一「总是用 Cursor 打开」，形成肌肉记忆。

7. 资源或场景受限时

临时机器、低配环境：先不跑完整 GUI 工作流，用 CLI 做最小操作；需要深度开发时再换到有编辑器的环境。

对照小结（按需求选）

需求侧重	更常用
断点调试、大量 diff、多文件重构、AI 多轮改代码	编辑器
自动化打开路径、和 shell 脚本一体、远程/终端优先	CLI
「写一天代码」的主战场	编辑器
「从终端一键接到 Cursor」的胶水层	CLI

说明：CLI 的具体子命令、是否包含「终端里跑 Agent」等能力会随版本更新，以 Cursor 官方文档为准。

声明：未读取项目内的 rules / skills / docs.md（纯产品使用场景说明）。

Cursor CLI 常用命令

按 Cursor 中文文档 - 斜杠命令整理说明

`/` 在 CLI 里做什么

在交互式 agent 会话里，输入 / 会调出斜杠命令菜单，用来切换模式、改模型、管 MCP、开新会话等，而不必记一长串 shell 参数。

文档也说明 CLI 支持与编辑器类似的模式，可用斜杠、快捷键或 --mode 切换（例如 Plan 还可用 Shift+Tab 、--plan、--mode=plan）。

默认是 Agent 模式（完整工具、可改代码）。

命令按用途分组（含常用标注）

1. 工作模式（很常用）

命令	作用
`/plan`	先规划再动手，适合大改动、重构前理清步骤。
`/ask`	只读探索，不改仓库，适合读代码、问架构。

2. 模型与执行安全（常用）

命令	作用
`/model`	查看或切换当前模型。
`/auto-run [state]`	控制是否自动跑终端命令等：`on` / `off` / `status` 或切换默认行为。
`/sandbox`	配置沙箱与网络访问（与 overview 里「沙箱控制」一致，设置可跨会话保留）。
**`/max-mode [on	off]`**

3. 会话与上下文（常用）

命令	作用
`/new-chat`	新开会话，避免上下文又臭又长。
`/compress`	压缩/总结当前对话，腾出上下文窗口。
`/resume`	按文件夹名恢复之前的聊天。

4. MCP 与项目约定

命令	作用
`/mcp list`	浏览、启用、配置 MCP 服务。
`/mcp enable` / `/mcp disable`	启用或禁用某个 MCP。
`/rules`	创建或编辑 Rules。
`/commands`	创建或编辑自定义 Commands。

5. 终端与编辑体验

命令	作用
`/vim`	开关 Vim 键位。
`/setup-terminal`	自动配置终端键位（详见文档里的 Terminal Setup）。

6. 账号、排障与退出

命令	作用
`/usage`	查看使用统计、连续使用等。
`/about`	环境、CLI 配置信息（排障时常用）。
`/help [command]`	帮助；可跟子命令名。
`/copy-request-id` / `/copy-conversation-id`	复制请求 ID / 会话 ID（找客服或报 bug 时常用）。
`/feedback`	向团队反馈。
`/logout`	退出登录。
`/quit`	退出 CLI。

和文档里其它 CLI 能力的关系

Cloud Agent ：在消息前加 & 把任务交给云端继续跑。
续聊：也可用 agent ls、agent resume、agent --continue 等子命令管理会话。

小结

/plan / /ask --- 控制「先想再做」还是「只读」。
/model 、/auto-run 、/sandbox --- 控制模型与命令执行方式。
/new-chat 、/compress 、/resume --- 管会话与上下文。
/mcp list --- 接外部工具时必碰。
/help 、/about 、/copy-request-id --- 出问题先查这三类。

完整表格以官方为准：斜杠命令（中文）。