Cursor Setting 中文 ¶
1. 常规(General) ¶
- 管理账户(Manage Account):管理你的账户及账单。
- 偏好设置(Preferences)
- 编辑器设置(Editor Settings):配置字体、格式、极简模式等。
- 键盘快捷键(Keyboard Shortcuts):配置键盘快捷键。
- 从 VS Code 导入设置(Import Settings from VS Code):从 VS Code 导入设置、扩展和键盘绑定。
- 重置"不再询问"对话框(Reset "Don't Ask Again" Dialogs):查看你隐藏过的警告和提示。
- 隐私模式(Privacy Mode):阻止使用代码库、提示和遥测数据来改进 Cursor。此为机器级设置,非账户级。
- 登出(Log Out):退出当前账户。
2. 聊天(Chat) ¶
聊天设置 ¶
- 默认模式(Default Mode):新聊天的默认模式(Agent)。
- 文字大小(Text Size):调整聊天消息的文字大小(默认)。
- 自动清除聊天(Auto-Clear Chat):在不活动一段时间后,打开聊天面板以进行新聊天(开关)。
- 滚动到新消息(Scroll to New Messages):新消息到来时自动滚动聊天窗口(开关)。
- 完成音效(Completion Sound):Agent 完成响应时播放提示音(开关)。
- 自定义模式(Custom Modes)【BETA】:创建自定义模式,定制模型、工具、快捷键和指令(开关)。
上下文(Context) ¶
- 包含完整文件夹上下文(Include Full-Folder Context):允许将所选文件夹的全部内容纳入上下文(开关)。
- 包含项目结构(Include Project Structure)【BETA】:将简化的目录树作为上下文纳入(开关)。
- 网页搜索工具(Web Search Tool):允许 Agent 搜索网页获取相关信息(开关)。
- 层级 Cursor 忽略(Hierarchical Cursor Ignore):将 .cursorignore 文件应用于所有子目录,需重启 Cursor 生效(开关)。
- 退格键移除上下文(Backspace Removes Context):在输入框开头按退格键时,移除最后一个上下文路径(开关)。
应用更改(Applying Changes) ¶
- 手动模式下的上下文外编辑(Out-of-Context Edits in Manual Mode):允许 Agent 在手动模式下编辑所选上下文之外的文件(开关)。
- 自动修复 Lint 错误(Auto-Fix Lints):自动修复聊天中的代码检查错误(开关)。
- 提交时自动接受(Auto-Accept on Commit):文件提交且不再处于工作树时,自动接受所有更改(开关)。
自动运行(Auto-Run) ¶
- 自动运行模式(Auto-Run Mode):允许 Agent 无需确认即可执行命令和写入文件(开关)。
- 命令白名单(Command Allowlist):可自动运行的命令列表。
- 命令黑名单(Command Denylist):不可自动运行的命令列表。
- 文件删除保护(File-Deletion Protection):阻止 Agent 自动删除文件(开关)。
- MCP 工具保护(MCP Tools Protection):阻止 Agent 自动运行 MCP 工具(开关)。
- 文件保护(.File Protection):阻止 Agent 自动修改 .gitignore 等点文件(开关)。
- 外部文件保护(External-File Protection):阻止 Agent 在工作区外创建或修改文件(开关)。
内联编辑与终端(Inline Editing & Terminal) ¶
- 选中时显示工具栏(Toolbar on Selection):选中代码时显示"添加到聊天"和"快速编辑"按钮(开关)。
- 自动解析链接(Auto-Parse Links):粘贴到快速编辑输入框的链接自动解析(开关)。
- 快速编辑自动选择代码区域(Auto-Select Code Regions for Quick Edit (Ctrl+K)):自动选择内联代码编辑区域(开关)。
- 主题化差异背景(Themed Diff Backgrounds):内联代码差异使用主题化背景色(开关)。
- 字符级差异(Character-Level Diffs):内联代码差异使用字符级显示(开关)。
- 终端工具提示(Terminal Tooltips):终端中显示"添加到聊天"等工具提示(开关)。
- 终端提示(Terminal Hint):终端中显示 Ctrl+K 操作提示(开关)。
- 终端 Ctrl+K 预览框(Preview Box for Terminal Ctrl+K):使用预览框而非直接流式传输到 shell(开关)。
3. Tab(标签页) ¶
- Cursor Tab(Cursor Tab):Cursor Tab 键相关设置。
- 基于最近编辑的上下文感知多行建议(Context-aware, multi-line suggestions around your cursor based on recent edits):基于近期编辑内容,在光标附近提供多行建议。
- 部分接受(Partial Accepts):通过 Ctrl+右箭头接受建议中的下一个单词。
- 注释时提供建议(Suggestions While Commenting):在注释区域允许用 Tab 键触发建议。
- 仅空白字符建议(Whitespace-Only Suggestions):建议仅修改空白字符(如换行、缩进)。
- 导入(Imports):为 TypeScript 自动导入必要模块。
- Python 自动导入(Auto Import for Python)【BETA】:启用 Python 自动导入功能。
4. 规则(Rules) ¶
- 生成记忆(Generate Memories)【BETA】:自动基于聊天内容创建用户级规则。
- 规则内容(Rules Content):
- 别高谈阔论,要实际代码或清晰解释。
- 预判需求,直接给答案,详细解释。
- 用专业术语,允许高度预测性内容。
- 只在关键且不明显时讨论安全性。
- 提供代码时尊重格式偏好,尽量简洁。
- 调整代码时只给必要上下文。
- 可以用多个代码块,中文回应。
- 项目规则(Project Rules):
- 包含自定义规则文件(Include custom rules file):决定是否纳入
cursorules文件。
- 包含自定义规则文件(Include custom rules file):决定是否纳入
5. 索引与文档(Indexing & Docs) ¶
- 代码库索引(Codebase Indexing):对代码库进行嵌入处理,提升上下文理解与知识储备。嵌入内容和元数据存储在云端,代码本地存储。支持同步和删除索引。
- 索引新文件夹(Index New Folders):自动为包含少于 50,000 个文件的新文件夹建立索引(开关)。
- 忽略文件(Ignore Files):遵循 .gitignore 规则,并可通过 .cursorignore 文件排除无需索引的文件。
- 文档(Docs):可抓取并索引自定义资源与开发者文档,支持添加、编辑和查看。
6. 网络(Network) ¶
- HTTP 兼容性模式(HTTP Compatibility Mode):建议在低延迟流式传输场景使用 HTTP/2。部分企业代理和 VPN 环境下可降低兼容性模式。
- 网络诊断(Network Diagnostics):检查与后端 AI 服务的网络连接情况,可点击"运行诊断"执行检测。
7. Beta(测试版) ¶
- 更新访问权限(Update Access):默认接收稳定更新通知。抢先体验模式下,预发布版本可能不适用于生产环境。
- 抢先体验(Early Access):可选择加入抢先体验。
- 记事本(Notepads):捕获项目笔记,自动纳入聊天上下文。
- Background Agent(Background Agent):可在云端运行代理(测试预览阶段)。
- 启动 Background Agent(Start a Background Agent):一键启动后台代理。