离线安装VSCode语言类插件失败的主因是LSP服务器（如pyright、prettier）未就位；正确做法是在有网机器上触发初始化后，整目录迁移扩展文件夹至目标机对应路径。
离线安装脚本自动化运行类插件（如 ms-python.python、esbenp.prettier-vscode、bradlc.vscode-tailwindcss）失败，90% 不是因为没装上，而是装完后根本跑不起来——因为它们依赖的运行时（pyright、prettier、tailwindcss CLI）压根没落地。
拖 vsix 进 VSCode 为什么装上了却没反应
这类插件的 .vsix 文件只是“前端壳子”，不含实际执行逻辑。VSCode 启动时只加载 UI 和注册 LSP 客户端，真正干活的语言服务器（LSP server）或 CLI 工具是在首次打开对应文件（如 .py、.css）时才触发下载。离线环境会卡在 “Downloading…” 状态，且无报错提示。
- 拖入
.vsix后必须手动点击「启用」，否则插件处于禁用状态 - 启用后若未打开匹配文件类型，LSP 不会初始化，功能不可见
- 右下角状态栏长期显示 “Initializing…” 或空白，基本可判定是 LSP 未就位
- 全屏、远程桌面（RDP/TeamViewer）、无焦点窗口都会导致拖放静默失效
code --install-extension 装完为啥 list-extensions 里有但不生效
命令行能成功注册插件 ID，但无法绕过 LSP 初始化阶段。尤其当插件声明了 "activationEvents": ["onLanguage:python"] 时，VSCode 不会主动拉起服务，只等你打开第一个 .py 文件。
- 必须加
--allow-unverified参数，否则离线环境下因证书链校验失败直接拒绝安装 - 路径必须是绝对路径：Windows 推荐
C:/vsix/ms-python.python-2026.6.123456.vsix，Linux/macOS 用/opt/vscode-ext/prettier-9.10.3.vsix - 路径含空格或中文？必须用英文双引号包裹：
code --install-extension "/path/to/my plugin.vsix" - 装完立即
code --list-extensions | grep python能看到 ID，但不代表功能可用
怎么让脚本自动化插件真正在离线环境跑起来
核心思路不是“只传 .vsix”，而是“把整个已初始化完成的插件目录打包迁移”。这一步绕开了所有离线下载卡点。
- 先在一台有网、同架构（如
darwin-arm64）、同 VSCode 版本（code --version输出需 ≥ 插件engines.vscode声明）的机器上完整触发一次：打开一个.py文件 → 等状态栏显示Python extension activated→ 确认pyright进程已在后台运行（ps aux | grep pyright） - 然后打包整个扩展目录：
~/.vscode/extensions/ms-python.python-2026.6.123456/（注意目录名必须含版本号，不能删） - 复制到目标机相同路径：
$HOME/.vscode/extensions/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows） - 彻底退出 VSCode（包括托盘进程），再启动——此时 LSP 二进制已就位，无需联网即可响应
批量部署时如何避免版本/架构踩坑
脚本自动化最怕“看起来都对，运行时报错无声”。关键检查项必须硬编码进部署流程：
- 从
.vsix解压后的package.json读取engines.vscode，与目标机code --version输出比对（取前两位，如1.85.2→1.85） - 检查
.vsix是否含平台标识：用unzip -l xxx.vsix | grep darwin-arm64或win32-x64；ARM Mac 上误装 x64 版本不会报错，只会静默跳过 native 模块 - 语言类插件必须带
server目录：解压后确认存在out/server/或dist/pyright.bundle.js等路径 - 脚本部署前先
rm -rf $HOME/.vscode/extensions/ms-python.python-*，避免旧版本残留干扰
真正难的不是“装上”，而是让 pyright、prettier、tailwindcss 这些底层工具在离线时也 ready to serve——它们不会出现在 .vsix 里，得靠有网机器预热后整目录搬运。
