批量分发.vsix需先在外网机生成带版本的扩展列表，下载对应.vsix并重命名，再用code --install-extension逐个安装；离线生效需复制完整扩展目录、确保lsp二进制就位、验证真实功能链路。
怎么批量分发 .vsix 文件到多台内网机器
直接拷贝 .vsix 文件过去不等于能用，尤其是前端类插件（如 esbenp.prettier-vscode、Vue.volar）在离线环境下常因缺少运行时依赖而静默失效。分发前必须确认目标机器的 VSCode 版本、系统架构（x64 / arm64）、以及插件是否带语言服务器二进制。
- 先在一台已配置好的外网机器上执行
code --list-extensions --show-versions > extensions.txt，生成带版本号的 ID 列表（如ms-python.python@2024.12.1） - 用脚本（Python/PowerShell）调用 Marketplace API 或解析下载链接，批量下载对应版本的 .vsix —— 注意：高版本插件可能不兼容旧版 VSCode，比如
Vue.volar@1.8.0要求 VSCode ≥ 1.80 - 下载后建议重命名文件为
id@version.vsix格式（如esbenp.prettier-vscode@9.10.3.vsix），避免混淆 - 把所有 .vsix 放进一个统一目录（如
/vsix/），再打包成 ZIP 或通过内网 HTTP 服务提供下载，比 U 盘逐台拷更可控
code --install-extension 批量执行为什么总失败
命令行安装看似简单，但参数写错一丁点就静默跳过或报错退出，尤其在 Windows 上路径和空格处理容易翻车。
- 每个
--install-extension必须单独写，不能合并：❌code --install-extension a.vsix b.vsix；✅code --install-extension "a.vsix" --install-extension "b.vsix" - 路径含空格或中文时，必须用英文双引号包裹，且推荐正斜杠：
"C:/vsix/prettier@9.10.3.vsix"，而非C:\vsix\prettier.vsix（反斜杠在 PowerShell 中可能被误解析） - 执行前务必关闭所有 VSCode 进程（包括后台托盘），否则部分插件注册表项可能被锁住；可用
code --status确认无残留进程 - Windows 下若提示
'code' is not recognized，说明未将 VSCode 加入 PATH —— 可改用完整路径："C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd" --install-extension ...
为什么插件显示“已安装”却完全不生效
这是离线部署里最隐蔽的问题：GUI 显示绿色勾选，不代表语言服务器（LSP）或格式化器真正加载成功。很多插件首次激活时才拉取 node_modules 或二进制 server，离线环境直接卡死。
- 不要只传 .vsix 文件 —— 对于
Vue.volar、ms-python.python这类插件，需在外网机器上完整安装一次，然后复制整个扩展目录（如%USERPROFILE%\.vscode\extensions\vue.volar-1.8.27\）到目标机的同路径下 - 检查输出面板（
View → Output），切换通道为对应插件名（如ESLint、Vue Language Server），真实错误都在这里，不是弹窗提示 - 打开一个真实文件（如
src/App.vue），观察右下角状态栏是否显示语言模式；按Ctrl+Shift+P输入Restart Vue Language Server，如果按钮灰掉，说明 server 二进制根本没解压或权限不足 - 某些插件（如 Prettier）依赖全局 Node.js，离线机器若没装 Node，即使插件装上了也无法格式化 —— 需提前确认或改用自带 runtime 的版本
如何验证分发后的插件真能用
不能只看扩展列表，得触发实际功能链路。前端插件尤其要走通“打开文件 → 激活语言模式 → 启动 LSP → 响应编辑操作”整条路径。
- 对 ESLint 插件：新建一个
.js文件，写一行console.log(undefind);（故意拼错），保存后看是否有红色波浪线和提示 “undefined is not defined” - 对 Volar：新建
App.vue，输入<template></template>后回车，看是否自动补全<script setup></script>—— 补全失败大概率是vue-language-server没起来 - 对 Python 插件：新建
test.py，输入import numpy as np，看是否出现 import 补全和类型提示；若无，检查输出面板中Python通道是否报Failed to fetch https://... - 所有验证动作必须在重启 VSCode 后进行，且确保没有启用远程开发（Remote-SSH/WSL）等干扰项
