Cursor 是一款基于 VS Code 的编辑器,不仅继承了 VS Code 的跨平台支持、插件生态和强大代码编辑能力,还内置 AI 辅助编程功能,能够进行智能补全、代码生成、解释和调试,大幅提升开发效率并降低学习成本。
菜鸟教程简单的使用和设置:Cursor 教程 | 菜鸟教程
学习 Cursor ,拥抱 AI 编程 | Cursor 101 | cursor101.com
Hobby(免费):包含两周 Pro 试用,提供有限的 Agent 请求和代码补全,适合体验和轻度使用。
Pro(\(20/月):提供 \)20 的高级模型使用额度,Auto 模式和代码补全无限制,超出额度可按用量付费,适合个人开发者。
Ultra(\(200/月):在 Pro 基础上提供约 20 倍的使用量,面向重度用户和高需求场景。
Teams(\)40/用户/月):包含 Pro 功能,并增加隐私模式、集中账单、使用统计和 SSO 等团队管理能力。
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:根据实际情况
模型设置:
Codebase(代码库索引)
Codebase Indexing:把你的项目文件做语义化索引(生成embeddings),使得AI在语义搜索、回答问题或生成代码时能引用整个代码库的上下文。
界面上会显示索引进度(百分比)和被索引的文件数(例如 208 files)。
提示:截图里有一行小字写着 “embeddings and metadata are stored in the cloud, but all code is stored locally” —— 意味着用于搜索的向量(embeddings)和一些元数据会上传/存储在云端以便快速检索,但源代码本身仍然保留在你本地机器/项目中(不是把完整源码上传为云存储)。
隐私注意:如果代码非常敏感,开启索引会把衍生的 embeddings 上传到云端(可能会影响隐私策略);可以考虑启用 Privacy Mode 或不索引敏感仓库。
Sync(同步):手动触发重新扫描并更新索引(例如你本地修改了很多文件或合并了分支后想马上更新索引)。
Delete Index(删除索引):删除当前生成的语义索引(embeddings/元数据),AI 将不会再基于这些已删除的索引做语义搜索,之后可重新Sync生成新索引。
PR History Indexing(Pull Request 历史索引)
作用:把仓库的 Pull Request(PR)历史(通常是PR标题、描述、讨论、变更摘要/元信息等)编入索引,以便语义搜索和上下文理解不仅限于代码,还能参考 PR 中的讨论、设计决策和复审意见。
界面提示:若尚未索引会显示 “No PR history indexed yet”。
注意:通常需要 Cursor 获得对远端仓库(如 GitHub/GitLab)的访问权限或令牌,才可抓取 PR 内容;索引 PR 可能会增加存储/费用。
Index New Folders(自动索引新文件夹)
开关说明:开启后,当你在项目/工作区添加新文件夹且该文件夹的文件数少于阈值(界面中显示为 “fewer than 50,000 files”)时,Cursor 会自动对其进行索引,无需手动 Sync。
实用建议:若你维护很多自动生成文件或非常大的二进制目录(例如 node_modules、build 输出),可以关闭该选项以避免浪费索引资源或触发索引错误。
Ignore Files in .cursorignore(.cursorignore 忽略文件)
作用:指定哪些文件/目录不被索引(相当于.gitignore的索引专用版)。
Edit(编辑):点 Edit 可以添加/移除规则或查看当前被排除的文件。
常见示例(建议加入.cursorignore):
node_modules/
dist/
build/
.jar
.exe
*.png
vendor/
.cache/
这些可以避免索引大型二进制或第三方依赖,从而节省时间和配额。
Include PRs in Search(BETA:在搜索中包含 PR)
作用:把 Pull Requests 的内容也包含进语义搜索结果(即使主索引里已有代码,也会显示 PR 相关条目)。适用于想通过 PR 历史找到设计讨论或变更原因的场景。
BETA 提示:这是实验性功能,可能需要重启/Reload Cursor 才能生效,或在表现上还有改进空间(例如排序、相关性或隐私处理)。
Docs(文档索引)
说明:你可以手动添加或爬取(crawl)额外的开发者文档/资源(API 文档、设计文档、运行手册、Wiki、第三方文档等),这些文档会被索引并在 Chat/搜索时作为上下文提供给 AI。
界面提示:当前 “No Docs Added”,右下角有 Add Doc 可添加。界面也提示可以在 Chat 或编辑时使用 @Add 快捷命令来快速把某段文档加入索引。
好处:把项目外的关键文档也纳入上下文,AI 在回答与架构、API 使用或公司流程相关的问题时会更准确。
操作建议(实用小贴士)
频繁更新的代码库:在做大量改动或合并后点一次 Sync,保证搜索结果最新。
敏感代码:如果代码不可外传,别开启索引或启用 Privacy Mode,确认官方隐私说明再决定。
节省配额/时间:把 node_modules/、编译输出、图片、二进制文件加入 .cursorignore。
想查设计/讨论历史:打开 PR History Indexing + Include PRs in Search,能让 AI 利用 PR 讨论来回答“为什么这么做”的问题。
索引失败或异常:先 Delete Index 清空,再 Sync;检查 .cursorignore 是否误排除了重要文件,或检查网络/仓库权限(PR 索引需授权)。
Rule 的内容类型
常见几类:
- 语言类
- 输出语言:简体中文、英文、日文
- 注释语言:代码注释必须是英文
- 风格类
- 代码风格:缩进用 4 个空格、变量名必须用 snakecase
- 文档风格:Markdown 格式、表格优先
- ”>项目约束类
- 仅允许使用 C 标准库,不使用第三方依赖
- 所有函数都要有注释头(参数/返回值说明)
- 错误处理必须用 return code 而不是 exit
- 输出格式类
- 总结必须使用项目符号列表
- 回答时先给简要结论,再给详细解释
Rule 的一般格式
Cursor 并没有要求固定的配置语法(不像 JSON/YAML),它直接接受 自然语言 作为规则。过建议写成 清晰的指令句子,方便模型准确遵循。
[条件/范围] + [要求]
标准示例
假设这是一个 C 语言项目,可以设置以下规则:
User Rules(全局规则)
Always respond in Chinese-simplified.
When writing explanations, first provide a short summary, then a detailed explanation.
Project Rules(C 项目专用)
All code must be written in C11 standard.
Do not use any third-party libraries, only the C standard library.
Indent with 4 spaces, no tabs.
All functions must include a comment header with parameter and return value description.
Variable names must use snake_case format.
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/220898.html