Cursor Rules——让 .cursorrules 真正派上用场
Rules 的结构、什么时候用 .cursor/rules/*.mdc、什么时候用老的 .cursorrules，以及怎么写模型真会照办的规则。
#Cursor
带有该标签的文章
Cursor 重启后聊天 / Composer 记录全没了
关掉 Cursor 重开，对话列表空了或只剩最近一条。多半是存储损坏、同步出错、workspace 不一致。怎么恢复 + 长期怎么防。
Cursor Cmd-K 内联编辑一直转不出 diff
按了 Cmd-K 写完指令，弹窗 spinner 一直转，不出 diff、不报错、提交不了。多半是网络、模型、或上下文。四类根因走一遍。
Cursor 扩展商店报网络错误或列表空空
Cursor 的扩展面板报网络错误或返回空列表。Cursor 用的是 Open VSX，不是微软商店。配对 gallery、解开安装这条路。
Cursor MCP server 连不上或工具不出现
在 Cursor 设置里加了 MCP server，却一直 disconnected，或 Composer 里看不到工具。多半是 transport、路径、或 schema 出问题。五分钟搞定。
Cursor rebase 或切分支后 codebase 索引过期
rebase 完或切完分支，Cursor 还在引用不存在的文件和行号。indexer 没跟上 git 状态。强制重建索引，把流程加固一下。
Cursor YOLO 模式不弹确认就跑命令
YOLO 已经关了，Agent 还在没弹确认就执行 shell 命令。多半是 allowlist 太宽、设置缓存没更新、或者 workspace 配置覆盖。逐项排查。
Cursor Auto 模型为难任务挑了弱模型 —— 完整修复指南
Cursor 的 Auto 路由把复杂重构发给小模型，结果改动浅、还自信宣称完成。从路由信号到提示卫生，逐项调优。
Cursor 没识别到 Python venv（解释器选错）—— 完整修复指南
Cursor 选用系统 Python 而非项目 venv，导致 import 红线、lint 报错、agent 给出错误改动。逐层排查解释器选择、venv 发现与 shell PATH。
Cursor Settings Sync 覆盖另一台机器的本地配置 —— 完整修复指南
Cursor Settings Sync 把过时配置推到第二台机器，覆盖本地规则、快捷键或 MCP 配置。从冲突方向、后写覆盖、选择性同步三方面定位。
Cursor SSH 远程连接编辑中途掉线 —— 排查与修复
Cursor 的 SSH Remote 会话在编辑过程中突然断开，丢失 agent 上下文与未保存缓冲区。从保活、网络与远端扩展宿主三个层面定位。
Cursor Agent 模式工具调用卡 pending
agent 模式下某次 tool call 一直转圈——多半是 shell 命令卡在等输入、网络被防火墙挡了、或者权限弹窗你没看见。
Cursor Composer 重构中途丢上下文
Composer 开头还行，做到第 9 个文件就开始改错文件、回滚之前的改动——上下文炸了；要把重构切块、每块重新对齐基线。
Cursor 规则文件没被加载
Composer 完全无视你写的 .cursorrules——多半是文件位置不对、新旧格式混用、或者 glob 没匹配到当前文件。
Cursor Fast/Slow Request 计费疑问
月初 500 fast 看着很多，几天就掉到 0 然后被打 slow 标——fast vs slow 的真实规则与日常省额度方法。
Cursor 模型列表与官网不一致
官网说支持 Opus 4.7，本地 Settings → Models 下拉里没有——本地版本陈旧、cache 没刷、或区域灰度还没到。
.cursorrules 未被加载
项目根有 .cursorrules，Composer 完全无视——位置不对、编码错、新 .cursor/rules 格式没识别、或缓存。
Cursor 新手指南——20 分钟跑通
安装 + 首次索引 + 4 次真实编辑（每个 AI 面板各一次：Tab / Inline / Composer / Chat），一小时后你就知道什么任务该按哪个键、什么是甜蜜区什么是失败模式。
Cursor 索引——又快又有用
调优循环：忽略什么、什么时候重 index、怎么用 @File / @Folder / @Symbol 精确钉住——治“Cursor 引一些不存在的文件”、“漏掉明明存在的”、“索引慢 / 坏”。
Cursor "Apply" 静默失败
点 Apply 之后文件没变也没报错——通常是基准快照过期、文件在外部被改、或写入被锁住。
Cursor 无法应用修改怎么办：4 个原因 + 对症修复
Cursor 能看到 diff 但 Apply 没反应或静默失败。常见原因：Composer / Inline 模式不匹配；文件被别的进程或 git 锁了；Cursor 扩展过期。先做：保存所有打开的文件，关掉其他编辑器。
Cursor Composer 在大项目里晕头转向
小仓库 Composer 很好用，5 万文件 monorepo 里就丢线索——靠显式上下文，别赌索引。
Cursor Composer 大刀阔斧改错
Composer 一次改 10+ 文件、把能跑的代码改坏——这是 prompt 边界没设，加上 agent 默认权限太大。
Cursor 配置与 VS Code workspace 设置冲突
切到某个仓库后 Cursor 的格式化 / AI 行为变了——是仓库 .vscode/settings.json 覆盖了你的用户设置。
Cursor 上下文面板缺关键文件
打开上下文面板，期待的参考文件不在——是检索打分不够、被 ignore 排除、或文件新到还没索引。
Cursor 的 diff 太大没法 review
Composer 一次给你 30 文件 / 2000 行 diff，怎么 review 都不放心——拆 PR 是唯一正确动作。
Cursor 改完 build 挂了
Composer 说完成、改过的文件都过了 lint，但 npm build 失败——典型是签名漂移、import 不存在、codegen 没重跑。
Cursor 生成重复逻辑
AI 又写了一个 formatDate，但 src/utils 里早就有——已有 helper 在检索视野外，让它发现得了才能复用。
Cursor IDE 状态与磁盘不同步
AI 改完后编辑器还显示旧内容，或保存时提示「文件已被外部修改」——文件 watcher 和 AI 写入的竞态。
Cursor 索引一直跑不完
索引进度条转了几个小时没动——多半是仓库太大、ignore 配置错、symlink 环、或工作目录权限不足。
Cursor 没读到整个项目：3 个原因 + 修复路径
Cursor 只能改"看得见"的——调整索引范围 + 显式 @File 引用。
Cursor 聊天读错文件
你 @ 一个文件但 Cursor 答的是另一个同名文件的内容——文件名歧义、索引陈旧、symlink 迷惑。
Cursor 老是读错文件：3 个原因 + 修复路径
Cursor 把旧 / 生成 / vendored 文件拉进 context——靠索引和 ignore 修。
Cursor 建议不符合仓库约定
Tab 补全和 Composer 改的命名 / 格式 / 模式都和仓库不一样——训练 prior 压过了检索信号，需要显式锚定。
Cursor Tab 不再联想
打字时灰色补全消失——多半是 Tab 被关、登录过期、被 Copilot 抢键、或当前文件类型/大小不支持。
Cursor 终端命令行为不符预期
agent 跑 shell 命令后 confuse——通常是 working dir 不对、用错包管理器、env 没加载、或输出被截断。
Claude Code vs Cursor：什么任务用哪个
Claude Code 是命令行 agent，Cursor 是编辑器内副驾驶。任务类型、调试链路、回滚成本不同——这篇给一张选择表。
Cursor 新手怎么开始：30 分钟跑通完整工作流（2026）
Cursor 第一次安装到独立完成第一个修改，30 分钟跑通完整工作流：Composer 与 Inline 的区别、Codebase 索引、@Files 注入、Apply 与回滚。
Cursor 一直 indexing 怎么办：让它跳过 node_modules 与构建产物
Cursor 卡在 indexing 不动？多半是 node_modules、build / dist、缓存目录被索引了。这篇给出 .cursorignore 模板与重建索引的步骤。