拖入.vsix后进度条不动或消失,是因VSCode断网后仍先发签名校验请求,超时才退本地加载,但fallback常被跳过;需断网+完全退出VSCode(杀所有进程)后重启安装,或临时设"extensions.installVerification": false排障。

拖入.vsix后进度条不动或直接消失
这不是文件没被识别,而是 VSCode 在后台尝试联网校验签名时静默失败——哪怕你已断网,它仍会先发一次请求,超时后才退到本地加载,而这个 fallback 流程常被跳过。
必须用「断网 + 完全退出 VSCode」组合操作:
- 关闭所有 VSCode 进程(Windows 查
Code.exe和Code Helper.exe;macOS 用活动监视器搜Code;Linux 执行killall -9 code) - 拔掉网线 / 关闭 WiFi
- 重新启动 VSCode(不登录账户、不恢复窗口)
- 再把
.vsix文件拖进编辑器窗口
如果仍无反应,临时关掉签名校验:在 settings.json 中加一行 "extensions.installVerification": false,装完立刻删掉——这仅用于排障,长期开启有安全风险。
命令行 code --install-extension 报错 ENOENT 或 command not found
ENOENT 表示路径找不到,command not found: code 表示终端根本没认出 VSCode 的 CLI 工具。这两个错误本质都是环境没准备好。
先确认 code 命令可用:
- 打开 VSCode,按
Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - 重启终端(不是 VSCode,是你的 shell,比如 Terminal 或 PowerShell)
- 运行
code --version验证输出正常
再安装时务必用绝对路径:
- Windows:
code --install-extension "C:\Users\Name\Downloads\ms-python.python-2024.6.0.vsix"(含空格必须加双引号) - macOS/Linux:
code --install-extension /Users/me/Downloads/prettier-9.10.0.vsix(不用~/,用完整路径)
装完插件列表里没有,或显示“Requires version X.X.X but got Y.Y.Y”
插件没出现在列表,大概率是 engines.vscode 版本不匹配。VSCode 不会弹窗报错,只静默跳过加载——你看到的“装完了”,其实是解压成功了,但根本没注册。
验证方法:用 unzip -t xxx.vsix 解压校验完整性,然后打开 extension/package.json,检查这一行:
"engines": { "vscode": "^1.85.0" }
再运行 code --version 看本地版本。若你本地是 1.84.2,就真不兼容。
常见修复方式:
- 去插件市场页面 URL 后加
&targetPlatform=win32-x64(或其他平台标识)下载对应版本 - 找旧版
.vsix(比如 GitHub Releases 里标v1.84.x的发布包) - 手动改
package.json中的engines.vscode值(仅调试用,改完需重打包并签名,不推荐)
远程开发(SSH/Dev Containers)里装不上 Workspace 插件
你在本地扩展面板点“Install in SSH: xxx”,VSCode 实际是把 .vsix 传到远程主机,再由远程的 VSCode Server 解压安装。卡住几乎都发生在传输或远程解压环节。
不要依赖图形界面安装:
- 先在本地下载好兼容的
.vsix(注意看插件页面写的targetPlatform) - 用
scp或rsync传到远程机器(如/tmp/ms-python.python-2024.6.0.vsix) - SSH 登录远程机器,执行:
code --install-extension /tmp/ms-python.python-2024.6.0.vsix
关键点:远程执行的 code 命令,必须是 VSCode Server 自带的 CLI(通常已自动加入 PATH),不是你本地装的 VSCode。如果报错 command not found,说明远程 Server 没正确启动,先重连一次 Remote-SSH。
最易被忽略的是:装完插件后,远程侧的 ~/.vscode-server/extensions/ 目录权限是否为当前用户可写。有些容器或内网机器默认挂载为只读,导致插件解压一半就停住,且完全不报错。











