扩展装了不工作、互相打架：Cursor 的 extensions 两页合起来看

2026-08-18

Cursor 的帮助文档里，扩展这件事被拆成了两页：cursor.com/help/troubleshooting/extensions（Extension conflicts）只有三小节，讲怎么找出冲突的那个扩展；cursor.com/help/customization/extensions（Extensions）讲扩展从哪个 registry 来、团队管理员能加哪几道闸。两页互相在 Related 里链着对方，但你只翻其中一页，往往会得出半个结论——排查页告诉你「把扩展全禁掉再一个个开回来」，却不会告诉你为什么你装上的那个扩展和同事在别的编辑器里装的可能不是同一份代码。

这篇把两页合起来读一遍，落点只有一个：扩展冲突的判定动作与禁用顺序。

现象：三类症状被混在一起说

先把「扩展的锅」和「不是扩展的锅」在现象层面分开。官方文档里明确归给扩展的症状有这么几类：

Tab 补全或 inline edit 不工作。Extension conflicts 页写明：提供自己的 AI 补全、或者拦截键盘快捷键的扩展，会和 Tab completion 或 inline edit 冲突；并直接点名「其它 AI 编码助手是最常见的冲突来源」。这一页把冲突来源归成了两类：自带 AI 补全的，和抢快捷键的。
编辑器输入延迟、CPU 或内存占用高。这一条不在 Extension conflicts 页，而在 cursor.com/help/troubleshooting/performance：文档写明高占用「通常来自扩展或设置问题」，给出的第一条处置就是禁用不需要的扩展。
Tab 建议质量不理想。cursor.com/help/troubleshooting/tab-issues 在「如何提升 Tab 建议质量」一节里，把「检查是否有冲突的扩展」列为其中一条，并链回 Extension conflicts 页。

三类症状的判定动作是同一套，但排除条件完全不同，最后一节会逐条对上。

怎么确认是扩展的问题：两条判定路径

官方文档给了两条互相独立的路径，一条在编辑器内，一条在命令行。两条都写得很短，但顺序是关键。

路径一：命令面板里的全量禁用

Extension conflicts 页写明的判定步骤是三步：

禁用全部扩展：打开命令面板，搜索 Disable All Installed Extensions（这个动作名是官方文档写明的字面写法）
看问题是否消失
一次重新启用一个扩展，找出冲突的那一个

第三步的措辞值得抠一下——文档写的是 re-enable one at a time，也就是一次只开一个，每开一个复现一次。很多人省成「一半一半地开」的二分法，那当然更快，但二分法只在「只有一个扩展有问题」时才成立；如果是两个扩展一起才触发，二分会把你带偏。文档给的是逐个启用，这是它的口径，快慢是另一回事。

路径二：命令行带参数启动

cursor.com/help/troubleshooting/performance 给了一条命令行开关，用来在「完全没有扩展」的状态下试一次：

cursor --disable-extensions

这条命令在该页出现了两次（降 CPU/内存占用一节、降输入延迟一节），文档给的用法都是「先用它测一次，再一个个启用回来找原因」。

Windows 与 macOS/Linux 的差别：官方这两页给出的命令写法是同一条，没有为不同系统写不同参数。文档没有说明该命令在各系统上如何被解析到，所以你在 Windows 上是用 cursor 这个名字直接调，还是要走别的方式，官方文档没有说明这一点——这一点请以你本机的安装方式和官方文档最新内容为准。文档中明确按系统分开写的只有面板快捷键：Extensions 面板在 Mac 上是 Cmd + Shift + X，在 Windows/Linux 上是 Ctrl + Shift + X；命令面板是 Cmd/Ctrl+Shift+P。

以上命令为官方文档中原样给出的写法，未经实测，以官方文档与 --help 的实际输出为准。

两条路径的分工

它们不是二选一。命令行那条是「这一次启动就不带任何扩展」的粗筛，用来回答「到底是不是扩展」；命令面板那条配合逐个启用，用来回答「是哪一个扩展」。先粗筛再逐个，顺序反过来会白跑很多轮。

处置：禁用的粒度，文档里有两档

找到那个扩展之后，Extensions 页写明的禁用动作是：打开 Extensions 面板，找到该扩展，点 Disable。

这里有一处只在 Extensions 页出现、Extension conflicts 页没写的信息：你可以全局禁用，也可以只针对当前工作区禁用（原文是 disable extensions globally or for the current workspace only）。这一条对排查很有用——某个扩展只在特定类型的项目里和 Tab 冲突时，你不必为此在所有项目里放弃它。Extension conflicts 页只写了「点 Disable」，没有提这一档粒度，两页合看才完整。

Extensions 页还补了一句直接对应本文主题的话：如果某个扩展造成性能问题或与 Cursor 的 AI 功能冲突，先试着禁用它看问题是否解决。

团队侧：把「装进来」这一步也管上

如果你是替团队管 Cursor 的人，Extensions 页列出的是三道客户端与市场层的控制，都能在文档里逐条查到：

控制	文档写明的配置位置	关键语义
Marketplace Install Cooldown	Team settings → Security & automation → Marketplace Install Cooldown (hours)	版本发布满设定的小时数之后才允许安装/更新；文档写明默认为 `0`（关闭），且设为大于 `0` 时会覆盖用户各自的 `extensions.installCooldownHours`
Allowed extensions	团队面板，或经 MDM 下发 `AllowedExtensions`	限制只能安装批准的发布者或扩展 ID
Extension signature verification	Team settings → Security & automation → Require Extension Signature Verification	要求扩展带有效的 Open VSX 签名才允许安装

上表中的路径与设置名均为官方文档写明的字面写法，默认值也是文档写明的，随版本可能变动。

extensions.allowed 这个设置的语义在 cursor.com/docs/enterprise/identity-and-access-management 里写得很直白，也是最容易踩的一处：它是 allowlist 模型，一旦你加了任何一条，就只有显式允许的条目被放行，其余全部被挡，没有隐式的「其它都放行」兜底。文档举的反例是设成 {"anysphere": false} 并不只挡 Anysphere，而是把所有别的发布者一起挡了。想「只挡个别、其余照旧」得写通配：

{
  "*": true,
  "untrusted-publisher": false
}

文档写明通配是最不具体的匹配项，发布者条目和扩展 ID 条目会覆盖它。

这一节还有两条限定，同样是文档白纸黑字写的，漏了会直接导致「我明明配了却没生效」：

有版本门槛。文档写明：通过管理后台配置这一项，要求 Cursor 客户端为 2.1 或更高版本；更老的版本上，扩展限制不会被应用。也就是说你在后台配好了不等于全员都受管，先把版本这条盘清楚。
清空字段不等于解除。文档写明清空管理后台的字段只是停止下发新值，已经被客户端应用过的策略不会因此消失，用户会继续按最后一次收到的值执行；要让所有人恢复到「全部允许」，文档给的顺序是先下发 {"*": true}、等客户端取到之后再清空字段。
另外，MDM 下发的 AllowedExtensions 按文档写明会同时覆盖管理后台的设置和用户自己配的 extensions.allowed。三处配置同时存在时，先想清楚谁压谁。

以上设置名、默认值与版本门槛均为官方文档写明的内容，随版本可能变动，请以官方文档最新内容为准。

Extensions 页在这几项后面有一句 Note 必须照实转述：install cooldown 与 signature verification 是客户端侧的安装控制，它们是对市场层分析与拦截的补充，不能替代后者。同页正文里也写了「没有任何单一控制可以替代其它控制」。这几道闸能不能挡住你担心的那类风险，请结合自身环境评估。

处置后怎么验证

按同一个动作复现。冲突的判定依赖「同一个操作、同一个文件」的前后对比。Tab 相关的验证还要注意 tab-issues 页写明的一点：Tab 的上下文来自你最近的编辑和光标周围的代码，新文件或空文件能给它的信息更少，文档给的建议是先手动改几处再看。拿一个空文件去验证 Tab 是否恢复，结论不可靠。
逐个启用，每启用一个验证一次，直到现象复现。这是文档口径，也是唯一能定位到具体某个扩展的方式。
看 Extension Host 的输出。cursor.com/help/troubleshooting/agent-issues 给了取日志的动作：Cmd/Ctrl+Shift+P 运行 Developer: Export Logs...，勾选 Main、Window、Extension Host；也可以用 Cmd/Ctrl+Shift+P → Output 然后在下拉里选 Extension Host。该页写明：如果这个面板是空的，这本身就是一个很强的诊断信号。这些动作名同样是官方文档写明的字面写法。

什么情况说明不是扩展冲突

这一节比前面几节更重要。全禁用之后现象照旧，就该换方向了——官方文档把下面这些症状归给了别的原因：

Tab 完全不出建议。tab-issues 页列了四条可能，没有一条是扩展：套餐用量已用尽（文档写明免费档存在按月计的 Tab 用量上限，用尽后建议会暂停、到下个计费周期恢复；档位划分与具体数值随时调整，请以官方定价与用量说明页为准）、网络屏蔽 HTTP/2（处置是在 Cursor Settings 里搜 HTTP Compatibility Mode 开启以回落到 HTTP/1.1，然后重启）、版本过旧（Cmd/Ctrl+Shift+P → Cursor: Attempt Update）、断网（文档写明 Tab 需要联网才能工作）。扩展冲突在这一页出现的位置是「提升建议质量」，不是「建议完全不出现」——两者别混。

Agent 读不到你的文件。agent-issues 页把这条归给 .cursorignore 与 .gitignore：列在 .cursorignore 里的文件会被挡在 Agent、代码库搜索和 @ 提及之外；.gitignore 里的模式同样可能让 Agent 发现不了文件。处置是改这两个文件、跑一次 Reindex，或者直接用 @ 挂文件。禁用扩展对这类现象不会有帮助。

出现 Agent Execution Timed Out。这条错误 agent-issues 页写明的含义是扩展宿主没能在规定时间内完成启动，导致 Agent 功能无法初始化，同一根因在网络诊断里表现为 Timeout waiting for EverythingProvider。文档说「原因各不相同，先收日志再动手」，并单独点出：在受管理或企业机器上，端点安全软件（杀毒、EDR）是可能原因之一。它和「某个扩展抢了快捷键」是两码事，别用逐个启用的办法去撞。

装上的扩展和你以为的不是同一个。这不是冲突，是来源问题。Extensions 页写明 Cursor 的第三方扩展走 Open VSX registry，并经由 Cursor 自己的 marketplace 代理（marketplace.cursorapi.com）而非直连；同一个 publisher.extension 名字在 Open VSX 上可能指向与 Microsoft Marketplace 不同的发布者或代码，文档给的建议是「把扩展 ID 当依赖看待，只从你信任的发布者那里安装」。对部分在 Open VSX 上没有的常用扩展，Cursor 发布了第一方的 Anysphere 替代版本。所以某个扩展「行为跟以前不一样」，先确认它是不是同一份东西，再去怀疑冲突。

在企业机器上装不上某个扩展。先看是不是撞了上面那三道闸——allowlist 一旦启用就是白名单语义，cooldown 大于 0 时会覆盖用户自己的设置。这类「装不上」和「装上了打架」是完全不同的路径。

最后一句提醒：Extension conflicts 页短到只有三节，很容易被当成全部答案。它回答的是「怎么定位」，不回答「为什么会冲突」——文档只说了两类冲突来源（自带 AI 补全、拦截快捷键），没有解释更多，我们也不去替它推断。

本文依据 Cursor 官方文档（cursor.com/docs 与 cursor.com/help）于 2026-08-18 的公开内容整理。该产品闭源，本文只复述官方文档写明的机制，不推断其内部实现； 我们没有对文中涉及的功能做过实测，因此不涉及界面外观、操作手感与运行速度的任何描述。该产品迭代频繁，文中涉及的设置项与命令随版本变动，请以官方文档最新内容为准。本文不涉及订阅价格、额度与模型清单，相关信息请以官方定价与模型说明页为准。

安全与合规相关做法请结合自身环境评估，本文不构成安全方案建议。