Cursor 进阶使用教程

设置

导入 vscode 数据

Cursor 是基于 vscode 的分支开发而来，所以可以与 vscode 无缝对接，只需要导入 vscode 中的设置即可

Import 之后，你的所有插件、主题配置等等就可以跟 vscode 保持一致了，不需要手动再安装一遍。导入是增量导入，你 Cursor 中已有但是 Vscode 中没有的插件或设置，并不会被清除掉

问题：为什么要使用 Vscode 导入？

答：因为 vscode 带有自动同步功能（包括设置、插件、主题等配置），但是 Cursor 是不提供同步功能的，所以为了在新设备上安装 Cursor 时避免重复设置，可以先下载 vscode ，登录账号后把数据同步下来，然后再导入到 Cursor 中，实现无缝迁移。

工具栏位置

Vscode 默认的工具是在左侧，而 cursor 只留了很小一份给工具栏，而且还变成了横排

如果你很不习惯放在顶部，那么打开设置，搜索orientation，然后改成 vertical 就可以保持竖直排列

Codebase Indexing

代码仓库文件索引（Codebase Indexing）是 Cursor 用来感知项目结构的重要工具。Cursor 会遍历每一个文件，记录其相对位置，就像构建了一个项目文件地图。最核心的意义在于------你使用 Cursor 编程时，model 会调用 file_search_tool ，经过 codebase indexing 后，就能得到更为精确的结果。

Pro 版用户最多支持 5w 个文件，企业版用户 25w

Docs

Docs 用来添加一些特殊文档到 context 中。使用场景是：Cursor 通过调用 Model 、在线查询资料、rules 这些手段仍然无法满足补充 context 信息而导致出现 bug 或者理解偏差时，就可以添加用户自定义的文档到 Docs 中。通常这个文档是直接通过搜索引擎搜不到的技术文档、个人博客、声明性文档等

Docs 只接受 url 链接，这意味着你添加到 Docs 中的文档最好是 AI 能够爬取内容的在线文档站点。

Context 上下文

能否使用 AI 高效率完成工作，关键就在于 context 的定义是否完整、清晰

定义

什么是 context ? context 就是 AI 的记忆，是 AI 对当前项目的所有认知，它是 AI 进行逻辑推理的依据

Context 分为指令、状态这两类，指令就是用户输入的 prompt ，例如："请你实现一个 react 的 table 组件"；状态则是当前项目中包含的各种信息，例如："当前项目基于 rust 编写"、"core/collect 这个目录属于依赖收集模块"

长度

Context 的长度是有限制的，也就是 AI 单次能够处理的输入大小，一般以 token 作为计量单位

这个工具 tiktokenizer.vercel.app 可以计算出你输入的文本内容的 token 长度

下面是 Cursor 中内置的 Model 的 Context 长度。你会发现与各个模型官网提供的长度不一致，这是因为 Cursor 内部还有一些系统提示词、其他提示词工程的优化、Model 性能权衡作出的妥协，这些要占用一些空间

构建

每次对话之前你都需要尽可能构建一个非常详细、明确的 context 给 AI ，这是降低 AI 幻觉的最有效的办法。

在 Cursor 中 context 包含了非常多的种类

下面说明几种核心的添加 context 的方式：

File&Folders ：最方便的用法是直接拖拽文件或文件夹到对话中，可以是 text、csv、md、各种源代码文件（基于字符的文本文件）。word、pdf、ppt 这类文件是不支持的
Code：选中某一段代码然后点击"Add to chat"
Git：让 AI 做 code review 时可以将某一次 commit 添加到 context 中
Past Chats：基于之前对话的内容，突然有了新的想法，新建了一个对话，但是又不想重新给 AI 说明一遍 context ，此时直接引用相关的历史对话即可
Web：常用于手动指定文档，需要是 AI 可以爬取内容的网站
Image：截图后粘贴到对话框中就可以添加了
Terminals：跟 code 添加方式一样，选中终端中的输出信息，点击"Add to chat"