必须用code --list-extensions --show-versions > extensions.txt导出含ID和精确版本号的清单,如ms-python.python@2024.12.0,确保离线环境可复现;需禁用临时插件、使用同版本VSCode(含Insiders)、避免手动复制显示名。

怎么导出可复现的插件版本清单
离线环境里,“这次装的和上次不一样”是最大隐患。靠人眼记 ms-python.python@2024.12.0 这种格式根本不可靠,必须用机器生成的精确快照。
在一台已配好、且 VSCode 主版本(如 1.92.x)与目标私有云环境一致的机器上执行:
code --list-extensions --show-versions > extensions.txt
输出每行形如 ms-python.python@2024.12.0 或 ms-toolsai.jupyter@2024.9.0,不含空行、不含注释。这个文件就是你私有云插件仓库的“版本基线”。
- 别漏掉
--show-versions:不加它只输出 ID,后续无法判断是否降级或跳过兼容版本 - 导出前先禁用临时调试插件,避免把
ms-vscode.test-adapter-converter这类非生产依赖混进清单 - 若私有云用的是 VSCode Insiders,必须用同版本机器导出,
insiders和稳定版的extensions目录不互通
如何批量安装并强制覆盖旧版本
私有云节点更新插件时,code --install-extension 默认跳过已存在且版本更高的插件——这不是“成功”,是静默忽略。必须显式加 --force 才能触发重装流程。
假设你已把所有 .vsix 文件按插件 ID 归类放在 /opt/vscode-offline/ext/ 下,可用如下循环安装:
while IFS='@' read -r id version; do<br> vsix=$(find /opt/vscode-offline/ext -name "${id}*-${version}.vsix" | head -n1)<br> [ -n "$vsix" ] && code --install-extension "$vsix" --force --allow-unverified<br>done
-
--force是关键:否则python.vsix已存在2024.8.0,你推2024.12.0可能被跳过 -
--allow-unverified必须加:离线环境无法连微软证书服务器,否则卡在INVALID_SIGNATURE - 路径必须用绝对路径,Linux/macOS 不接受
./ext/xxx.vsix;Windows 要用双引号包裹含空格路径
为什么 Pylance / Pyright 总是卡在 “Downloading”
这不是插件没装好,而是语言服务二进制没预置。像 ms-python.python 这类插件,首次激活会自动拉 pyright 或 pylance 的 LSP 包——离线时这一步必失败,状态栏卡死,编辑器无响应。
解决办法不是重装插件,而是手动补全 LSP 二进制:
- 查插件
package.json中contributes.debuggers.runtime或pylance相关字段,确认它依赖哪个 LSP 包及最低版本 - 从同一台联网机器的
~/.vscode/extensions/ms-python.pylance-*/out或node_modules/pyright目录打包对应架构(x64/arm64)的二进制 - 拷到目标机的
~/.vscode/extensions/ms-python.pylance-*/out并确保权限可执行
不预置 LSP,插件就只是个壳,语法高亮、跳转、补全全失效。
怎么验证插件真正在运行而非仅“出现在列表里”
code --list-extensions 显示插件名 ≠ 插件已加载。很多插件(尤其是带 extensionDependencies 的)装完不重启、不手动启用、或依赖缺失,就会静默失败。
真正有效的验证方式是:
- 重启 VSCode 后,打开命令面板(
Ctrl+Shift+P),输入Developer: Show Running Extensions,看目标插件状态是否为Active - 检查其
package.json中extensionDependencies字段,比如ms-python.python强依赖ms-python.pylance,缺一个,Python 支持就残废 - 对 Python 插件,打开一个
.py文件,看左下角是否显示 Python 解释器路径;不显示,说明 LSP 没跑起来
私有云部署最易忽略的,是“装了等于没装”这种软失败——它不报错,但功能全丢。必须进 Running Extensions 看真实加载态,而不是只信扩展面板里的勾选框。











