cursor插件安装失败主因是网络代理异常、市场源配置错误、权限或磁盘空间不足；需依次检查代理设置、替换product.json中的marketplace.cursorapi.com为marketplace.visualstudio.com、手动安装.vsix包，并验证磁盘空间与目录权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在 Cursor AI 中尝试安装扩展插件，但操作后无响应、报错或显示“Failed to fetch”“No extensions found”，则可能是由于网络代理异常、扩展市场源配置错误、权限或磁盘空间不足导致。以下是解决此问题的步骤：
一、检查并修复代理配置
Cursor 默认复用系统代理设置，若本地运行了代理工具（如 Clash、V2RayN），但端口不匹配或服务未启动，会导致 extensionsGallery 请求失败，控制台常出现 ERR_PROXY_CONNECTION_FAILED 或 net::ERR_CONNECTION_REFUSED。
1、按 F1 打开命令面板，输入 Developer: Toggle Developer Tools 并回车，切换至 Console 标签页。
2、在扩展市场中任意输入关键词（如“Python”）触发请求，观察控制台输出的错误日志。
3、若日志中反复出现 PROXY 127.0.0.1:7891 或 ERR_PROXY_CONNECTION_FAILED，说明代理连接失败。
4、点击 Ctrl + ,（Windows/Linux）或 Cmd + ,（macOS）进入设置，搜索 proxy，核对 HTTP 代理地址与端口是否与本地代理工具一致。
5、若无需代理，直接清空代理设置字段；若需代理，请确保代理软件已运行且端口正确，然后完全退出 Cursor 并重启。
二、更换扩展市场源地址
Cursor v0.40+ 默认使用 marketplace.cursorapi.com 作为扩展服务端，但该域名自 2025 年底起频繁不可达；切换为 VS Code 官方市场地址可绕过鉴权限制与 CDN 故障。
1、关闭 Cursor 应用，确保进程已终止（macOS 可右键 Dock 图标选“退出”，Windows 可在任务管理器中确认 cursor.exe 已结束）。
2、定位 product.json 文件：
macOS/Linux：执行 open /Applications/Cursor.app/Contents/Resources/app/（macOS）或 ls ~/.cursor/resources/app/（Linux）；
Windows：前往 %userprofile%\AppData\Local\Programs\Cursor\resources\app\。
3、用文本编辑器（如 VS Code 或记事本）打开 product.json，查找 extensionsGallery 字段。
4、将原字段中所有 https://marketplace.cursorapi.com 替换为 https://marketplace.visualstudio.com，并确保 serviceUrl 值为 https://marketplace.visualstudio.com/_apis/public/gallery，itemUrl 为 https://marketplace.visualstudio.com/items。
5、保存文件，彻底重启 Cursor，重新尝试安装扩展。
三、手动安装本地 .vsix 插件
当网络策略严格禁止外连或市场接口持续超时，可跳过在线拉取流程，直接部署已下载的 .vsix 包，该方式不依赖 extensionsGallery 服务，仅需文件系统写入权限。
1、从官方渠道（如 GitHub Releases 或 VS Code Marketplace 页面）下载目标插件的 .vsix 文件（例如 Python-2025.12.1.vsix）。
2、双击 .vsix 文件或在 Cursor 中按 Ctrl+Shift+P（macOS 为 Cmd+Shift+P），输入 Extensions: Install from VSIX 并回车。
3、在弹出的文件选择框中定位并选中该 .vsix 文件，点击打开。
4、安装完成后，Cursor 会提示“Extension installed”，此时需完全退出应用再重新启动，否则插件可能无法激活。
四、验证并修复基础环境约束
部分失败源于底层系统资源不可用，而非网络或配置问题；磁盘空间不足、目录权限错乱或用户所有权冲突会导致 extensions 目录写入失败，表现为零字节文件夹或 install 按钮点击后无任何日志输出。
1、检查 Cursor 扩展根目录可用空间：
macOS/Linux 执行 df -h ~/.cursor/extensions；
Windows 执行 dir %userprofile%\.cursor\extensions，确认剩余空间 ≥500MB。
2、检查目录权限：
macOS/Linux 执行 ls -ld ~/.cursor ~/.cursor/extensions，确认输出中 owner 为当前登录用户，而非 root；若为 root，执行 sudo chown -R $USER:$USER ~/.cursor 修正所有权。
3、检查杀毒软件拦截行为：临时禁用 Windows Defender 实时保护或第三方安全软件，尤其关闭“云查杀”与“网络流量监控”模块，再重试安装。
