cursor插件安装报错90%以上源于网络通道、市场源配置或本地残留冲突。需依次检查代理设置、更换为vs code官方市场源、手动安装.vsix包，或清理残留配置与缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Cursor插件安装后报错，常见表现为点击安装无响应、控制台持续输出“Failed to fetch”、扩展面板显示灰色禁用状态或弹出红色错误提示框。这类问题90%以上与网络通道、市场源配置或本地残留冲突有关，不是插件本身损坏。
检查并重置代理设置
第一步：按 F1 打开命令面板，输入 Developer: Toggle Developer Tools 并回车，切换到 Console 标签页；
第二步：在扩展市场搜索任意关键词（如 “Prettier”），触发一次请求；
第三步：观察控制台是否出现 ERR_PROXY_CONNECTION_FAILED 或 net::ERR_CONNECTION_REFUSED —— 若有，说明代理未通或端口错配；
第四步：按 Ctrl + , 进入设置，搜索 proxy，清空 HTTP 代理字段（若不用代理）；若需代理，请确保地址与本地工具（如 Clash）端口完全一致，【必须完全退出 Cursor 再重启，否则代理设置不生效】。
更换扩展市场源地址
Cursor v0.40+ 默认调用 marketplace.cursorapi.com，该域名自 2025 年底起频繁不可达。直接改回 VS Code 官方市场可绕过鉴权和 CDN 故障。
方法一（Windows）：
① 关闭 Cursor，打开任务管理器确认 cursor.exe 进程已结束；
② 在资源管理器地址栏输入：%userprofile%\AppData\Local\Programs\Cursor\resources\app\，定位 product.json；
③ 用记事本或 VS Code 打开该文件，查找 "extensionsGallery" 字段；
④ 将其中所有 https://marketplace.cursorapi.com 替换为 https://marketplace.visualstudio.com，并确保 serviceUrl 值为 https://marketplace.visualstudio.com/_apis/public/ga；
⑤ 保存文件，重新启动 Cursor。
方法二（macOS）：
打开终端，执行：open /Applications/Cursor.app/Contents/Resources/app/product.json，后续步骤同 Windows 方法一第③～⑤步。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
手动安装 .vsix 插件包
当市场源失效且网络受限时，这是最可靠的兜底方案。
去 VS Code 官方扩展市场（marketplace.visualstudio.com）搜索目标插件，例如 “ESLint”，在插件详情页点击右上角 “Download Extension” 按钮，获取 .vsix 文件；
启动 Cursor → 点击左下角齿轮图标 → Extensions → 点击右上角 “…” → 选择 “Install from VSIX…”；
找到刚下载的 .vsix 文件，双击确认安装；
安装完成后，重启 Cursor 即可启用。
清理残留配置与缓存
如果上述操作均无效，大概率是用户数据目录损坏或与旧版配置冲突。
关闭 Cursor 后，手动删除以下两个文件夹：
Windows：%APPDATA%\Cursor 和 %USERPROFILE%\.cursor；
macOS：~/Library/Application Support/Cursor 和 ~/.cursor；
【删除前请确认未开启同步或已备份关键设置，此操作不可逆】；
删完后，从官网重新下载最新安装包覆盖安装。
