在局域网服务器托管.vsix需映射为本地盘符（如z:）再用绝对路径调用code --install-extension；下载前须校验vs code版本与插件engines.vscode兼容性，并确保隐式依赖插件一并安装，最后彻底重启vs code验证激活状态。
怎么在局域网服务器上托管 .vsix 文件供批量分发
直接把 .vsix 文件扔进共享文件夹不等于“托管”——客户端调用 code --install-extension 时无法自动解析相对路径或 UNC 路径，必须转为可被 CLI 正确识别的本地路径格式。核心是让每台目标机器能稳定访问、校验并安装，而不是简单放一堆文件。
共享路径必须用正斜杠 + 绝对路径拼接
Windows 上的 code CLI 对 UNC 路径（如 servershareplugin.vsix）支持极差，会报 command not found 或静默失败。正确做法是：在每台目标机上先映射网络驱动器，再用本地盘符路径调用。
- 在目标机执行：
net use Z: \fileserver scode-extensions /persistent:yes - 确认映射成功后，安装命令写成：
code --install-extension Z:python-2024.6.0.vsix - 若脚本需兼容多台机器，统一用
Z:作为约定盘符，避免依赖用户自定义映射 - 路径含空格或中文？必须加英文双引号：
code --install-extension "Z:my ext.vsix"
怎么避免下载到不兼容的 .vsix 版本
插件市场页面显示的最新版 .vsix 往往要求 VS Code ≥1.90，而内网服务器可能还跑着 1.85。直接部署会导致 code --install-extension 静默跳过，连日志都不输出。
- 检查目标机 VS Code 版本：
code --version，取前两位（如1.85.2→1.85） - 下载时紧盯插件页右下角 “Requirements” 栏，例如写明 “VS Code >= 1.85”，才可选对应版本
- 更稳妥的方式：用官方 API 拼 URL 下载指定版本：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2024.6.0/vspackage，其中ms-python、python、2024.6.0必须与插件 ID 和版本严格一致 - 下载后解压 .vsix（它本质是 ZIP），打开
package.json，核对"engines": {"vscode": "^1.85.0"}是否匹配
为什么装完插件不生效，且 --list-extensions 看不到
这不是安装失败，而是 VS Code 启动时跳过了不兼容或依赖缺失的扩展。尤其 Python 类插件强依赖 ms-python.pylance，漏掉一个，整个功能链就断了。
- 不要靠人肉查“Recommended”列表——那是推荐栏，不是依赖树
- 在一台已配好的联网机器上运行：
code --list-extensions > extensions.txt，这是真实生效的完整 ID 列表 - 批量部署时，按
extensions.txt逐行下载对应 .vsix，确保隐式依赖（如 Pylance、Jedi、Test Explorer UI）全部覆盖 - 安装后必须彻底退出 VS Code（包括托盘进程），否则缓存不刷新，新插件不会加载
- 验证是否真运行：
Ctrl+Shift+P→ 输入Developer: Show Running Extensions，看状态是否为 “Active”
package.json → 映射盘符 → code --install-extension → 重启 → Developer: Show Running Extensions”全链路。
