VSCode扩展安装失败主因是无法访问marketplace.visualstudio.com,应先诊断网络请求,再尝试关闭自动更新、检查代理、切换vscode-cn镜像源或离线安装排查。
VSCode 扩展安装失败:先看网络请求是否卡在
绝大多数“点击安装没反应”“进度条卡住”“提示下载超时”的问题,本质是 VSCode 无法连通微软官方扩展市场。它默认走的是境外 CDN,国内直连大概率被限速或中断。
实操建议:
打开 VSCode 设置(
),搜索
,暂时关掉——避免后台静默请求干扰诊断
在命令面板(
)运行
,切到
标签页,再点一次“安装”,观察是否有大量
请求失败或 pending 超过 30 秒
如果确认是网络问题,别急着换镜像源——先试下系统代理是否被意外启用(比如开了 Clash、Surge 等工具但未全局,导致 VSCode 拿不到代理配置)
用国内镜像源替代官方 marketplace(推荐
)
微软没提供官方镜像,但社区维护的
镜像是目前最稳定、更新及时的替代方案,它把扩展包缓存到国内服务器,并兼容 VSCode 原有协议。
实操建议:
关闭 VSCode,编辑用户设置文件:
(Windows)或
(macOS)或
(Linux)
添加以下两行配置(注意逗号分隔):
把上面两个 URL 中的
全部替换成
(这是
的实际域名)
重启 VSCode,再进扩展页试试——不是所有扩展都立刻显示,首次加载可能稍慢,但安装成功率会明显提升
命令失败:离线安装时路径或格式不对
手动下载
文件后双击无反应,或用命令行
报错,常见原因是文件损坏、签名不匹配,或 VSCode 版本太旧不支持该扩展的引擎要求。
VSCode 1.118
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力,其中最引人注目的是新增 Copilot CLI 远程控制功能,允许开发者通过手机或网页远程监控和接管 AI 会话 。同时,为了提高 AI 的运行性价比,新版本优化了令牌缓存策略以降低成本 。此外,1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
下载
实操建议:
检查
文件是否完整:用解压工具打开,确认里面有
,且其中
字段值 ≤ 当前 VSCode 版本(比如你用 1.85,扩展写
就装不上)
不要用浏览器“另存为”下载 VSIX——某些网站返回的是 HTML 页面而非真实文件,建议从扩展页点“Download Extension”按钮,或直接右键链接另存为
命令行安装时,确保路径不含中文或空格;若报
,说明路径错了,用绝对路径重试,例如:
插件装上了但不生效:可能是禁用状态或依赖冲突
扩展列表里显示“已安装”,但功能没出现(比如 Prettier 不格式化、ESLint 不标红),往往不是安装失败,而是被自动禁用,或与其他插件抢了激活时机。
实操建议:
在扩展页搜索框输入
,再挨个点开,确认状态栏显示“启用”而非“已禁用”——有些插件会在检测到冲突时自行禁用自己
打开命令面板,运行
,看目标插件是否在列表中且“Activation Time”非零;如果一直是
,说明它根本没被触发启动
临时禁用其他同类插件(比如同时装了
和
,又都绑了保存格式化,容易互相压制),再逐个启用排查
扩展市场的网络链路其实很脆弱,镜像源能解决大部分问题,但个别新发布扩展可能延迟同步几小时。遇到某个特定插件死活装不上,先查它的 GitHub Issues 页,比反复换源更省时间。
marketplace.visualstudio.comCtrl+,extensions.autoCheckUpdatesCtrl+Shift+PDeveloper: Toggle Developer ToolsNetworkmarketplace.visualstudio.comvscode-cnvscode-cn%APPDATA%\Code\User\settings.json~/Library/Application Support/Code/User/settings.json~/.config/Code/User/settings.json"extensions.gallery.serviceUrl": "https://marketplace.visualstudio.com/_apis/public/gallery",
"extensions.gallery.cacheUrl": "https://marketplace.visualstudio.com/_apis/public/gallery/publishers"marketplace.visualstudio.comvscode.cdn.azure.cnvscode-cninstallExtension.vsixcode --install-extension xxx.vsix.vsixextension/package.jsonengines.vscode"^1.90.0"ENOENTcode --install-extension /Users/xxx/Downloads/vscode-eslint-2.4.0.vsix@installedDeveloper: Show Running Extensions0msESLintprettier-vscode