必须用绝对路径、加--force和--allow-unverified参数，路径含空格或中文需加英文双引号，离线环境需跳过签名验证，LSP类插件还需同步语言服务器二进制文件。
code --install-extension 批量执行必须用绝对路径和 --force
VSCode 的 code --install-extension 命令对路径极其敏感，相对路径、空格、中文、斜杠方向全都会导致静默失败：没报错、不提示、插件列表里也不出现。你写个 for 循环遍历当前目录下的 .vsix 文件，大概率一半都装不上。
- Linux/macOS 必须用完整绝对路径，例如：
code --install-extension /opt/vscode-ext/esbenp.prettier-vscode-9.10.3.vsix - Windows 推荐用正斜杠写法（避免反斜杠转义问题）：
code --install-extension C:/ext/ms-python.python-2024.6.0.vsix - 路径含空格或中文？必须加英文双引号：
code --install-extension "/mnt/内网共享/python-2024.6.0.vsix" - 同名插件已存在？不加
--force会直接跳过安装，不会覆盖
离线环境必须加 --allow-unverified 否则签名验证失败
离线机器无法校验证书链时，code --install-extension 默认会拒绝安装——哪怕你确认 .vsix 是从官网下载的，也会报 INVALID_SIGNATURE。这不是文件损坏，是 VSCode 在启动签名验证流程时因网络不可达而中断并回退为拒绝。
- 必须显式加上
--allow-unverified参数，例如：code --install-extension /ext/prettier.vsix --force --allow-unverified - 该参数仅影响签名验证环节，不影响插件功能本身
- 企业内网批量部署时，建议所有命令统一带上这个参数，避免个别机器因证书策略差异失败
LSP 类插件（如 Python、Vue）不能只装 .vsix
装上 ms-python.python 后打开 .py 文件，状态栏卡在 Downloading pyright-server？这不是安装失败，是语言服务器二进制根本没落地。.vsix 只是前端壳，LSP 服务（如 pyright、volar-server）默认首次启用时联网下载。
- 离线场景下，需额外下载对应语言服务器二进制，并按插件文档要求放入指定缓存目录（如
~/.vscode/extensions/ms-python.python-*/dist/server） - Python 插件可配合
python.languageServer设置切换为Pylance或None，但核心分析能力会降级 - 验证是否真装好：打开一个 .py 文件后，在命令面板运行
Developer: Toggle Developer Tools，看 Console 是否有Failed to download报错
插件清单文件怎么组织才真正可用
所谓“插件清单”，不是随便列个 ID 文本就完事。VSCode 不支持直接读取文本清单执行安装，你得靠 shell 脚本或批处理来驱动 code --install-extension。关键是每行内容必须能直接拼进命令，且路径要提前解析好。
- 推荐格式是每行一个完整命令，例如：
code --install-extension /ext/python.vsix --force --allow-unverified - 不要用插件 ID（如
ms-python.python）代替路径——那只能在线安装，离线无效 - 脚本开头加一句
which code >/dev/null || { echo "code command not found"; exit 1; }，避免 PATH 没配好却默默失败 - 执行前先用
ls -l或dir确认所有 .vsix 文件真实存在且可读，权限问题在 Linux/macOS 上常被忽略
实际批量部署时，最易被忽略的是 LSP 二进制的同步动作——它不在 .vsix 包里，也不在任何清单中，但缺了它，插件就只是个空壳。
