离线安装VSCode插件后功能残缺，主因是语言服务器、CLI工具或native二进制未手动补全；须在有网机完整触发启用（如打开test.py待“initialization finished”），再整目录拷贝扩展文件夹（含子目录中pyright-server等二进制），并验证.vsix结构与插件ID大小写一致性。
离线安装 VSCode 插件后功能残缺（比如 Python 补全失效、C++ “未找到定义”、ESLint 不自动修复），几乎从不因为 code --install-extension 命令没跑对，而是插件本身依赖的语言服务器、CLI 工具或 native 二进制没带进来——这些组件默认联网下载，离线时必须手动补全。
确认插件是否真“装全了”，而不是只注册了入口
很多插件（如 ms-python.python、ms-vscode.cpptools、dbaeumer.vscode-eslint）安装 .vsix 只是完成注册，首次启用时才触发语言服务器下载。离线环境下你会看到：
- 状态栏卡在 “Downloading pyright…” 或 “Initializing Pylance…”
- Output 面板切换到对应插件通道，出现
spawn ENOENT或Failed to fetch - 按 F12 跳转失败、悬停无类型提示、保存不触发格式化
这说明插件本体已加载，但关键依赖缺失。别重装 .vsix，要补的是运行时产物。
在有网机器上完整触发并打包 LSP 服务目录
正确做法不是下载一堆 .vsix，而是在一台网络通畅、VSCode 版本与目标机一致的机器上，把插件“用起来”，再整份拷走：
- 打开一个对应类型文件（如
test.py、main.cpp、index.js） - 等待状态栏不再显示下载中，Output 面板里对应通道日志末尾出现 “initialization finished” 或 “server started”
- 退出 VSCode（必须彻底退出，包括托盘进程，否则缓存未写入）
- 进入扩展目录：
Windows：%USERPROFILE%\.vscode\extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 找到对应插件文件夹（如
ms-python.python-2024.6.0），整个压缩或直接复制
注意：不能只拷 node_modules 或只拷 out 目录——pyright-server、clangd、eslint-cli 这类二进制通常藏在子目录如 dist/server/ 或 node_modules/.bin/ 下，漏一个就启动失败。
验证依赖完整性：解压看结构 + 运行查日志
拿到内网机器后，别急着启动 VSCode，先做两件事：
- 用
unzip -l your-plugin.vsix检查顶层是否有extension/package.json；若输出混乱或报错，说明.vsix已损坏（Windows 下右键重命名改后缀极易导致此问题） - 安装后打开 Output 面板，切换到对应插件通道（如 Python / ESLint / C/C++），重点看有没有
spawn ENOENT、Cannot find module或路径不存在类报错 - 如果报
Extension is not compatible with Code，立刻比对三处：code --version、unzip -p xxx.vsix extension/package.json | grep engines、Help → About 里的架构（x64 vs arm64）
最常被忽略的一点：插件目录名必须和 .vsix 中声明的 ID 完全一致（含大小写），VSCode 启动时靠这个匹配，手抖改错一个字母就会静默跳过加载。
