分类目录归档：工作

Cursor 使用入门指南

发表评论

整理自官方文档：https://cursor.com/cn/docs

Cursor现在是很火的AI编程的IDE。我已经使用了一段时间，使用后再对说明文档做了学习，将重要的内容摘要如下。

核心概念

如下。目前主要使用的是Agent+聊天+上下文。

  1. Tab：可预测多行代码修改的代码补全功能。按 Tab 以接受基于当前代码和最近更改生成的建议
  2. Agent：可在多个文件间读取和修改代码的 AI。用自然语言描述要修改的内容，Agent 会为你执行
  3. 内联编辑：使用自然语言编辑所选代码。按 Cmd+K 描述要修改的内容，并在原位置即时查看效果
  4. 聊天：AI 对话界面。支持多个标签页、会话历史、检查点和导出功能
  5. 规则：用于定义 AI 行为的自定义指令。在这里设置代码规范、 框架偏好和项目特定约定
  6. 代码库索引：对代码库进行语义分析，支持代码搜索、引用查找和上下文感知的智能建议
  7. MCP：Model Context Protocol（MCP），用于集成外部工具。可连接数据库、API 和文档源
  8. 上下文：在代码生成过程中提供给 AI 模型的信息。包括文件、符号和会话记录
  9. 模型：支持代码生成的多种 AI 模型。每种模型在速度和能力方面各不相同

Tab

如果是一个有经验的程序员，可以通过Tab来不断的接受系统给出的建议。建议是灰色的，Tab接受，ESC拒绝，CMD+右箭头逐词接受。

聊天：

  • 标签页：CMD+T新建聊天标签页面。每个标签页面的会话历史、上下文、模型选择是独立的。CMD+tab可以切换标签页。每次聊天会根据第一次对话自动生成对话标题。
  • 检查点：在每次对话后，点击对话上的返回按钮，可以恢复至检查点。
  • 导出：可以导出对话为MD格式，便于分享。
  • 复制：将对话复制，前文不变，后续本体对话和复制体对话分离。
  • 历史记录：查询之前的对话的历史。
  • 摘要：/summarize 自动生成摘要，降低上下文占用。
  • 自定义命令：自定义后，使用/可以呼出。包含项目命令、全局命令、团队命令三种形式
    • 项目命令：项目的.cursor/commands 目录下，编写md文件，文件名为命令
    • 全局命令：~/.cursor/commands目录下
    • 团队命令：需要Team方案。Team Content 控制台编写

规划

提前规划，并通过结构化待办列表与消息队列管理复杂任务，让长周期任务更易理解和追踪

输入框中Shift+tab切换为规划模式。

  1. Agent 会提出澄清问题以了解你的需求
  2. 在你的代码库中检索并收集相关上下文
  3. 制定一份完整的实现计划
  4. 你可通过聊天或 Markdown 文件审阅并编辑该计划
  5. 准备就绪后点击构建该计划

模式

cmd+. 快速切换模式

  1. Agent：复杂功能、重构。多文件编辑、自主探索
  2. Ask：学习、规划、提问。只读不修改
  3. Plan：需要规划的复杂功能。执行前创建计划，主动提问明确

工具

借助各类工具进行搜索、编辑并运行命令。从语义化代码库搜索到终端执行，这些工具支持自主完成任务。并提供 MCP（Model Context Protocol，模型上下文协议）集成以增强能力。

  • 搜索：文件读取、文件目录读取、代码库检索、Grep搜索文件内容、搜索文件、执行网页搜索
  • 编辑：编辑并重新应用、删除
  • 运行：在终端terimnal中运行并获得运行结果
  • MCP：第三方服务（有很多，后续调研单独写一篇文章）
  • 高级选项：自动应用修改。自动执行命令。安全护栏限制。自动修复错误

审查

采用diff格式显示新增和删除的行。

  • Agent Review：Review – Find Issues
  • 主子分支：Source Control – Agent Review
  • 逐个文件点击：细粒度控制。可以先拒绝不需要的，全部接受。或者接受需要的，再全部拒绝。

终端

终端在沙盒中运行，需要的的时候需要Allow或者Run。

浏览器

Agent 可与浏览器交互，用于测试应用、收集信息，并自主完成各类基于网页的任

@browser 可以用这个命令和浏览器连接，此时建议使用sonnet 4.5、GPT-5，或者Auto。Cursor会自动在浏览器开启网站进行相应的操作。

内联编辑（Inline Edit）

  • 指定代码编辑：选择代码后，CMD+k打开一个临时对话框，会自动包含选择范围的上下文代码
  • 指定代码提问：Opt+回车，快速提问
  • 指定文件编辑：CMD+Shift+回车，对整个文件全局修改
  • 指定代码发送至聊天：CMD+L，把对应代码发送至chat

规则

4种规则：项目规则、用户规则、团队规则、Agents.md。规则仅影响Agent，不影响其他功能。

  • 项目规则：项目的.cursor/rules中。每条规则一个mdc文件。支持子目录的规则，仅对子目录生效。
  • 用户规则：Cursor Settings – Rules。适用于所有项目。适合用来设定交流风格或者编码规范。
  • 团队规则：仪表盘创建。
  • Agents.md：放在项目目录里面，md文件，简单生效。没有元数据或复杂配置。

项目规则

每条规则一个文件。使用mdc格式。在Cursor Setting的Rules功能下使用。

好的规则：聚焦明确、可执行且范围清晰。单条规则长度 500 行以内。在聊天中重复使用的提示词，就可以保存成规则。

规则类型：

  1. Always Apply：每个聊天对话都应用
  2. Apply Intelligently：Agent判断描述相关时使用
  3. Apply to Specific Files：文件匹配指定模式的时候
  4. Apply Manually：对话中@时使用

上下文

@文件、文件夹。@Docs 存在内置的文档，或者是自行添加文档。

快捷键

https://cursor.com/cn/docs/configuration/kbd

使用Tips

  1. 选择模型：现在Auto模式使用是免费的， 另外就是有一些模型可能会临时展示Free的标识，需要在模型名称上鼠标悬浮查看。选择一些免费的模型可以降低自己的使用成本，但是质量有可能会下降。当一个模型完成任务质量不高的时候，可以尝试选择其他的模型。
  2. 定期打开新的Agent对话：将不同的任务放在不同的对话中，使用/summarize 来压缩上下文，注意维护.gitingore或者.cursoringore文件，有助于降低上下文的占用。
  3. 定期将项目代码优化或者重构：对cursor说“优化代码，提升代码质量，提高可维护性”，他会自动帮你做代码优化。
  4. 多使用@功能：@上下文，文件、文件目录，这样更便于准确的执行你的命令。
  5. 大改动先plan再执行：在plan模式下，系统会对不明确的命令进行问询，总结出来需要改动的内容并二次确认，最后再分步执行。可以有效的提升改动质量。