Cursor Rules：写出 Agent 真会照办的 .mdc 文件
Cursor 的四种规则类型、.cursor/rules/*.mdc 与老的 .cursorrules 与 AGENTS.md 怎么选，以及怎么给规则定作用域让模型真听。内容更新至 2026 年 6 月。
#Cursor
带有该标签的文章
Cursor Auto 把难任务路由给了弱模型 —— 完整修复指南
Cursor 的 Auto 路由把复杂重构发给小模型，结果改动浅。看懂路由信号，给难任务强制指定正确的模型。
Cursor 重启后聊天 / Composer 记录不见了
重开 Cursor 对话列表空了、只剩最近一条、或一直卡在 Loading Chat。多半是 workspace hash 变了、升级迁移出错，或 state.vscdb 损坏。怎么恢复 + 长期怎么防。
Cursor Cmd-K 内联编辑一直转、不出 diff 的修法
Cmd-K（Ctrl+K）一直转，或卡在 "Taking longer than expected…" 不出 diff。最快一招：Reload Window 或升级 Cursor。六类已验证根因逐一排查。
修复 Cursor 扩展：网络错误或商店列表空空
Cursor 扩展面板报网络错误、列表空空或 spinner 卡住。Cursor 用的是 Open VSX，不是微软商店。对症归类，快速解决。
Cursor MCP server 连不上或看不到工具
在 Cursor 里加了 MCP server，却一直 disconnected，或聊天里看不到工具。九成是 PATH 不对、JSON 写错、或日志漏到了 stdout。五分钟内定位修好。
Cursor 没识别到 Python venv（解释器选错）—— 完整修复指南
Cursor 选用系统 Python 而非项目 venv，导致 import 红线、lint 报错、agent 给出错误改动。修好解释器选择、venv 发现、shell PATH 与新版 Python Environments 面板。
Cursor 配置同步覆盖另一台机器的本地配置 —— 完整排查指南
Cursor 并没有原生 Settings Sync。当 Gist 同步插件、dotfiles 软链接或云盘文件夹把过时配置推到第二台机器，你的规则、快捷键或 MCP server 就会被覆盖。先判断是哪一层同步干的，再把好版本救回来。
Cursor SSH 远程连接编辑中途掉线：6 种修复
Cursor 的 SSH Remote 会话在编辑过程中突然断开，丢失 agent 上下文与未保存缓冲区。用对保活参数，并排查 v1.0.51 重连 bug。
Cursor rebase 或切分支后 codebase 索引过期
rebase 完或切完分支，Cursor 还在引用不存在的文件和行号。indexer 没跟上 git 状态。强制重建索引，把流程加固一下。
Cursor 不弹确认就跑命令（YOLO / Auto-Run）
auto-run 明明关了，Cursor Agent 还是没弹确认就执行终端命令。截至 2026 年 6 月，多半是 Run Mode、allowlist 太宽、或 workspace 的 permissions.json 在覆盖。一分钟修好。
Cursor Agent 模式工具调用卡 pending
agent 模式下某次 tool call 一直转圈——多半是 shell 命令卡在等输入、网络被防火墙挡了、或者权限弹窗你没看见。
Cursor Composer 重构中途丢上下文
Composer 开头还行，做到第 9 个文件就开始改错文件、回滚之前的改动——上下文炸了；要把重构切块、每块重新对齐基线。
Cursor 规则文件没被加载（2026 修复指南）
Composer 完全无视你写的 .cursorrules 或 .cursor/rules。多半是 frontmatter 语法错误、文件位置不对、用了已弃用的旧格式，或者 glob 根本没匹配到打开的文件。
Cursor 计费疑问：Fast/Slow 旧机制 vs 新的额度池
$20 Pro 额度月中突然耗尽、Cursor 提示已达上限。讲清 Cursor 现在的用量计费怎么算（2025 年已废除 fast/slow request），以及日常省额度方法。
Cursor 模型列表与官网不一致
官网说支持某个模型，本地 Settings → Models 里却找不到。本地版本旧、缓存陈旧还是灰度未到——本文教你分清原因并修好。
Cursor 规则不被加载（.cursorrules / .cursor/rules）
Cursor 无视你的规则：Agent 模式不读旧版 .cursorrules、.mdc frontmatter 有错被静默丢弃、位置或扩展名不对、BOM、或缓存。逐项排查修复。
Cursor 新手指南：从安装到第一次真实编辑
Cursor 真正的学习曲线不是安装，而是搞清楚什么时候用 Tab、Inline 编辑（Cmd-K）、Composer（Cmd-I）、Chat（Cmd-L）还是 Agent 模式。五个面板、四次真实编辑，含 2026 年 6 月最新价格与模型。
Cursor 索引调优：又快又准
讲清 Cursor 代码索引的真实机制、.cursorignore 与 .cursorindexingignore 的区别，以及根治“引用不存在文件”的调优循环——2026 年 6 月核实。
Cursor "Apply" 静默失败
点 Apply 之后文件没变也没报错——通常是基准快照过期、文件在外部被改、或写入被锁住。
Cursor 无法应用修改：6 个原因 + 对症修复
Cursor 能看到 diff，但 Apply 没反应、静默失败、或提示 The apply model made no changes to the file。最快修复：保存所有文件、关掉其他编辑器窗口，再点 Reapply。
修复 Cursor Composer 在大型 monorepo 里丢上下文
小仓库 Composer 很聪明，进了 5 万文件 monorepo 就丢线索。靠 @Files、MDC 规则和单包任务逼它聚焦，别赌索引重跑。
Cursor Composer 大刀阔斧改错
Composer 一次改 10+ 文件、把能跑的代码改坏。先用 Cursor checkpoint 或 git 快速回滚，再收紧 prompt 和模式让它保持外科级。
Cursor 配置与 VS Code workspace 设置冲突
切到团队仓库后 Cursor 的格式化或 AI 行为突然变了？是仓库的 .vscode/settings.json 覆盖了你的用户设置。本文教你定位是哪一层生效。
Cursor 上下文面板没带上你要的文件
Cursor 的 context 面板漏掉了你明知相关的文件。先用 @ 五秒救场，再断根：查 .cursorignore、resync 索引、给通用文件改名。
Cursor 的 diff 太大没法 review
Composer 一次甩出 30 文件 / 2000 行 diff，怎么 review 都不放心。先 reject（或 Restore Checkpoint），再让 Composer 把它拆成能 review 的小 PR。
Cursor 改完 build 挂了
Composer 说完成、改过的文件都过了 lint，但 build 失败。最快的修法：打开 Auto-run，让 agent 自己在收尾前跑 typecheck + build。
Cursor 生成重复逻辑，而不是复用已有 helper
Cursor 又写了一个 formatDate，但 src/utils 里早就有——已有 helper 根本没进检索。教你让它先 grep 再写、把现成的复用起来。
Cursor IDE 状态与磁盘不同步
AI 改完后编辑器还显示旧代码、保存提示「file modified externally」、或 AI 改动秒回滚——文件 watcher 和 AI 写入的竞态，以及怎样在不丢代码的前提下修好。
Cursor 索引一直跑不完：7 类原因和修法
Cursor 索引进度条转了几个小时不动，多半是仓库太大、没写 .cursorignore、公司 HTTP/2 代理被拦、symlink 环或权限不足。本文教你先判断属于哪一类再对症修。
Cursor 没读到整个项目：原因排查 + 修复路径
Cursor 只能改它能看见的文件。修好索引范围、从仓库根打开、用 @ 显式钉住文件即可。
Cursor 聊天读错文件
你 @ 一个文件但 Cursor 答的是另一个同名文件。用全路径引用 + 强制 resync 修好 @ 选择器、索引陈旧、symlink 三类原因。
Cursor 老是读错文件：分桶诊断 + 修复路径
Cursor 把旧 / 生成 / vendored 文件拉进 context 导致 patch 出错。靠 .cursorignore、重建索引和 @ 锁定来修。
Cursor 建议不符合仓库约定
Tab 补全和 Composer 改的命名 / 格式 / 模式都和仓库不一样——训练 prior 压过了检索信号，需要显式锚定。
Cursor Tab 不再联想
Cursor 灰色补全突然消失？重新开启 Tab、检查登录与额度、解决 Copilot 抢键、切到 HTTP/1.1、或清缓存。逐步排查，2026 年 6 月核实。
Cursor agent 终端命令行为不符预期
Cursor agent 跑 shell 命令跑错了——working dir 不对、用错包管理器、env 没加载、输出被截断，或 .zshrc 把命令卡死。给出具体修法。
Claude Code vs Cursor（2026 年 6 月）：什么任务用哪个
Claude Code 是命令行 agent，Cursor 是编辑器内副驾驶。对比价格、模型、回滚和任务类型——用 2026 年最新数据给你一张选择表。
Cursor 新手怎么开始：30 分钟跑通完整工作流（2026）
从零安装 Cursor 到独立完成第一个修改，30 分钟跑通：Inline（Cmd+K）、Composer 的 Agent/Ask/Plan、Codebase 索引、@ 注入、Apply 与回滚。2026 年 6 月更新。
Cursor 一直 indexing 怎么办：真正管用的 .cursorignore 方案
Cursor 卡在 indexing 或反复重索引？多半是 dev server 不停改写的某个 build/缓存目录。这篇给出 .cursorignore 模板、watcherExclude 修复，以及如何确认索引真的健康。