让我们来聊聊Cursor设置那些事儿，实用技巧大曝光！

Cursor

简介

Cursor 是一款基于 VS Code 的编辑器，它不仅继承了 VS Code 的跨平台特性、丰富的插件资源和强大的代码编辑功能，而且还引入了 AI 编程助手，可以智能补全代码、生成新代码，甚至进行代码解释和调试。这些功能让开发变得更加高效，学习门槛也大大降低。

如果你是新手，想要快速上手，可以参考这个简单的教程：Cursor 教程 | 菜鸟教程

想要深入了解 Cursor 的话，不妨看看这个网站：学习 Cursor ，拥抱 AI 编程 | Cursor 101 | cursor101.com

Hobby（免费）：提供两周的 Pro 试用，限制了 Agent 请求和代码补全，适合轻度使用和体验。

Pro（$20/月）：每月 $20 的高级模型使用额度，支持无限制的 Auto 模式和代码补全，适合个人开发者。

Ultra（$200/月）：在 Pro 的基础上，提供大约 20 倍的使用量，专为重度用户或高需求的场景设计。

Teams（$40/用户/月）：包含 Pro 所有功能，并增加了隐私模式、集中账单、使用统计和单点登录等团队管理功能。

Enterprise（定制报价）：提供 Teams 的所有功能，额外增加了更高的使用额度、发票账单、统一人员管理和优先支持，适合大企业。

问题：有些 VScode 插件的新版本已经不再支持 Cursor。

基本设置

（1）全局设置：

（2）AI对话的相关设置：

新手推荐（简单易用）

• Default Mode → Agent：智能模式，能自动调用工具。
• Display → Full：对话气泡清晰，阅读更轻松。
• Scroll to New Messages → 开：新消息会自动滚动到底部。
• Auto-Clear Chat → 开：长时间不使用时，旧对话会自动清空。
• To-Do List → 开：AI 会生成待办任务，方便你追踪。
• Include Full-Folder Context → 关：只查看必要文件，避免占用过多资源。
• Web Search Tool → 开：可以联网搜索信息来补充回答。
• Backspace Removes Context → 开：退格键能快速删除引用的上下文片段。
• Auto-Fix Lints → 开：自动修复代码风格或语法的问题。
• Auto-Run Mode → Ask Every Time：执行命令前询问，确保安全。
• Inline Editing Toolbar → 开：选中代码时会显示快捷编辑工具。
• Auto-Select Code Regions → 开：自动选中可能需要编辑的代码段。
• Themed Diff Backgrounds → 开：内联编辑的结果直观显示。
• Terminal Tooltips & Hint → 开：提示如何在终端调用 AI 进行编辑。
• Preview Box Ctrl+K → 开：先预览 AI 输出，确认后再执行。
• AI Terminal Completion Detection → 开：防止命令卡住或 AI 等待过久。

进阶用户推荐（高效自动化）

• Default Mode → Prompt-only / 自定义：轻量模式或按照你的工作流程自定义。
• Include Full-Folder Context → 开：获取整个项目上下文，方便做全局修改。
• Auto-Accept on Commit → 可开：已提交文件的修改会自动应用。
• Auto-Run Mode → Always：命令自动执行，提升效率。
• Character-Level Diffs → 按需开：内联对比更细致，显示具体字符的修改。
• Preview Box Ctrl+K → 可关：AI 输出直接执行，简化操作步骤。
• Queue Messages → 可开：管理多条消息，按顺序发送，避免覆盖。

Tab 设置：

推荐的整体配置（适合大部分用户）

• Cursor Tab：✅ 开
• Partial Accepts：❌ 关
• Suggestions While Commenting：✅ 开
• Whitespace-Only Suggestions：❌ 关
• Imports：✅ 开
• Auto Import for Python：根据实际情况选择

模型设置：

MCP

添加外部知识库及索引设置

代码库索引（Codebase）

Codebase Indexing 是将你的项目文件进行语义化索引（生成 embeddings），这样 AI 在进行语义搜索、回答问题或生成代码时，能引用整个代码库的上下文。

界面上会显示索引的进度（以百分比表示）和被索引的文件数量（比如 208 files）。

小提示：截图中有一句话写着 “embeddings and metadata are stored in the cloud, but all code is stored locally”，也就是说，用于搜索的向量（embeddings）和一些元数据会上传到云端以便快速检索，但源代码仍然保留在你的本地机器上，不会完全上传云存储。

隐私提醒：如果你的代码特别敏感，开启索引可能会将生成的 embeddings 上传到云端，这可能会影响隐私；建议启用隐私模式或选择不索引敏感的仓库。

同步（Sync）：手动触发重新扫描并更新索引（比如你本地修改了很多文件或合并了分支后想马上更新索引）。

删除索引（Delete Index）：删除当前生成的语义索引（embeddings/元数据），这样 AI 不会再基于这些已删除的索引进行语义搜索，之后可以重新 Sync 生成新索引。

Pull Request 历史索引（PR History Indexing）

这个功能是将仓库的 Pull Request（PR）历史（通常是 PR 的标题、描述、讨论、变更摘要/元信息等）编入索引，以便语义搜索和上下文理解，不仅限于代码，还能参考 PR 中的讨论、设计决策和复审意见。

界面提示：如果尚未索引会显示 “No PR history indexed yet”。

注意：通常需要 Cursor 获得对远端仓库（如 GitHub/GitLab）的访问权限或令牌，才能抓取 PR 内容；索引 PR 可能会增加存储和费用。

自动索引新文件夹（Index New Folders）

这个开关的作用是：开启后，当你在项目中添加新文件夹，并且该文件夹的文件数量少于阈值（界面中显示为 “fewer than 50,000 files”）时，Cursor 会自动对其进行索引，无需手动同步。

实用建议：如果你维护很多自动生成的文件或者非常大的二进制目录（比如 node_modules、build 输出），可以关闭该选项，以避免浪费索引资源或触发索引错误。

在 .cursorignore 中忽略文件（Ignore Files in .cursorignore）

如何管理索引和文档的技巧

作用：借助这个功能，可以指定哪些文件或文件夹不被纳入索引，就像.gitignore文件一样，专门处理索引问题。

编辑：点击“编辑”按钮，你可以轻松添加或删除规则，还能查看当前被排除的文件列表。

常见的例子（推荐放在.cursorignore里）：

• node_modules/
• dist/
• build/
• *.jar
• *.exe
• *.png
• vendor/
• .cache/

这些设置有助于避免将大型二进制文件或第三方依赖纳入索引，从而节约时间和资源。

在搜索中包含 PR（BETA）

作用：这个功能可以让你的搜索结果包括 Pull Requests 的内容，即使主索引里已经有了代码，也会显示与 PR 相关的信息。特别适合想通过 PR 历史了解设计讨论或修改原因的情况。

BETA 提示：这是个实验性功能，可能需要重启或重新加载 Cursor 才能生效，表现上也可能还有提升的空间，比如排序、相关性和隐私处理等。

文档索引

说明：你可以手动添加或抓取额外的开发者文档和资料（如 API 文档、设计文档、用户手册、Wiki 或第三方文档），这些文档会被索引，并在聊天或搜索时提供给 AI 作为上下文信息。

界面提示：目前显示为“No Docs Added”，右下角有“添加文档”的选项可以点击添加。同时，你还可以使用 @Add 快捷命令快速将某段文档加入索引。

好处：将项目外的重要文档融入上下文中，AI 在回答与架构、API 使用或公司流程相关的问题时会更加精准。

操作建议（实用小贴士）

频繁更新的代码库：在进行大量更改或合并后，别忘了点击一次同步，确保搜索结果是最新的。

对于敏感代码：如果有些代码不想外泄，最好关闭索引或启用隐私模式，并在确认官方隐私说明后再做决定。

节省配额和

想查找设计或讨论历史：开启 PR 历史索引和在搜索中包含 PR 的选项，AI 就能利用 PR 讨论来解答“为什么这么做”的问题。

索引失败或出现异常：可以先清空索引，再进行同步；检查一下 .cursorignore 是否误排除了重要文件，或者确认网络和仓库权限（PR 索引需要授权）。

记忆与规则

规则的内容类型

常见的几类包括：

1. 语言类

• 输出语言：简体中文、英文、日文
• 代码注释语言：必须使用英文

1. 风格类

• 代码风格：缩进使用 4 个空格，变量名必须为 snake_case 格式
• 文档风格：采用 Markdown 格式，优先使用表格

1. 项目约束类

• 仅允许使用 C 标准库，不使用任何第三方依赖
• 所有函数都需要有注释头（包括参数和返回值的说明）
• 错误处理必须使用返回代码，而不是直接退出

1. 输出格式类

• 总结必须使用项目符号列表
• 回答时，先给出简短的结论，再提供详细的解释

规则的一般格式

Cursor 并不要求固定的配置语法（不像 JSON 或 YAML），它可以直接接受自然语言作为规则。建议以清晰的指令句子来写，方便模型准确执行。

[条件/范围] + [要求]

标准示例

假设这是一个 C 语言项目，可以设定以下规则：

用户规则（全局规则）

始终使用简体中文作答。

在撰写解释时，先给出简要总结，再进行详细说明。

项目规则（针对 C 项目）

所有代码必须遵循 C11 标准。

不得使用任何第三方库，仅限使用 C 标准库。

缩进使用 4 个空格，不得使用制表符。

所有函数必须包含注释头，说明参数和返回值。

变量名必须采用 snake_case 格式。