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