code --install-extension必须逐个指定参数,不可合并;路径须为绝对路径且含空格或中文时加英文双引号;离线安装需同步LSP服务器及依赖插件目录,否则功能失效。

code --install-extension 必须逐个写参数,不能合并
VSCode 命令行不支持 code --install-extension a.vsix b.vsix 这种写法。每个 .vsix 文件必须配一个独立的 --install-extension 参数,否则静默失败——没报错、插件列表里不出现、也不提示路径错误。
常见错误现象:code --install-extension *.vsix 在 shell 中会被展开成多个参数,但 VSCode 只认第一个,其余被忽略;PowerShell 里用 Get-ChildItem *.vsix | % { code --install-extension $_ } 若没传 $_.FullName,则路径是相对的,大概率失败。
- Windows 示例(路径含空格/中文必须加英文双引号):
code --install-extension "D:/vsix/ms-python.python-2024.12.1.vsix" --install-extension "D:/vsix/ms-toolsai.jupyter-2024.8.0.vsix" - Linux/macOS 示例(推荐正斜杠,避免反斜杠转义):
code --install-extension /opt/vsix/prettier-9.10.3.vsix --install-extension /opt/vsix/eslint-8.56.0.vsix - 执行前务必关闭所有 VSCode 进程(包括后台托盘实例),Windows 可用任务管理器结束全部
Code.exe,否则安装可能被锁住
离线环境只装 .vsix 文件 = 白装,LSP 服务不会自动落地
很多插件(如 ms-python.python、vue.volar、dbaeumer.vscode-eslint)的 .vsix 只是前端壳,真正的语言服务器(如 pyright-server、volar-server、eslint-language-server)默认首次打开对应文件时才联网下载。离线环境下它就卡在“Downloading…”或直接跳过,无报错、无提示、功能全失效。
- 正确做法:在有网机器上完整触发一次加载——打开一个
.py文件,等状态栏显示 “Python Language Server: Running” 后,再拷贝整个扩展目录(含node_modules和server.js等二进制)到目标机 - Windows 路径:
%USERPROFILE%\AppData\Roaming\Code\Extensions\ms-python.python-2024.12.1\ - Linux/macOS 路径:
~/.vscode/extensions/ms-python.python-2024.12.1/ - 只拷
.vsix文件,等于只装了个空壳
依赖插件必须手动凑齐,vsce download 不会拉 extensionDependencies
vsce download ms-python.python 只下主插件,但它的 package.json 里声明了 "extensionDependencies": ["ms-toolsai.jupyter"]。漏掉 ms-toolsai.jupyter,Python 插件启动后就会卡在 “Downloading Jupyter extension…” 状态,界面无任何提示。
- 查依赖方式:解压
.vsix,运行unzip -p your-plugin.vsix extension/package.json | grep extensionDependencies - 常见必须成对下载组合:
ms-python.python+ms-toolsai.jupyter;vue.volar+@volar/vue-language-service(后者需从 GitHub Release 手动找匹配版本) - 别信“一键打包站”,它们常漏依赖,或塞错平台架构(比如在 M 系列 Mac 上打包 x64 版本)
脚本化批量安装要加 --force,且路径必须绝对
不加 --force,遇到已安装插件会暂停并等待用户确认,脚本直接中断;路径用相对路径、或没处理空格/中文,会导致静默失败——命令返回 0,但插件没装上。
- Linux/macOS 推荐脚本:
for ext in /opt/vsix/*.vsix; do code --install-extension "$ext" --force done
- PowerShell 推荐写法:
Get-ChildItem /opt/vsix/*.vsix | ForEach-Object { code --install-extension $_.FullName --force } - 企业内网若遇签名验证失败(如定制系统镜像),可临时加
--disable-extension-corruption-check,但生产环境禁用 - 插件 ID 大小写敏感,必须是完整格式,如
esbenp.prettier-vscode,不能只写prettier
.vsix 全部对齐版本、平台和架构,再一并拷过去——少一个,就卡在某个 Loading 状态里,还找不到日志在哪。


















