离线安装VSCode插件成功需满足三条件：.vsix文件完整、VSCode版本匹配、路径正确；拖放无效时先确认焦点、非全屏/远程环境、文件未解压；CLI安装必须用绝对路径并加引号；手动复制需严格按扩展ID命名子目录并彻底退出VSCode。
离线安装 VSCode 插件，只要 .vsix 文件完整、VSCode 版本匹配、拖放或命令路径写对，就能成功——它不是“将就”，而是 VSCode 官方明确支持的标准流程。
拖进主窗口没反应？先确认这三件事
这是离线安装里最高频的“假失败”，VSCode 不报错，只静默忽略：
- VSCode 没获得系统焦点：点击编辑器任意空白处，确保任务栏图标高亮后再拖
- 当前处于全屏模式或远程桌面（如 RDP / TeamViewer）：这类环境常拦截拖放事件，退出全屏或改用命令面板
- 拖的是解压后的文件夹、
.zip或重命名过的包：VSCode 只认原始未解压的.vsix；可用unzip -l xxx.vsix查看顶层是否为extension/目录
code --install-extension 必须用绝对路径
相对路径在脚本或终端中极易失效，VSCode CLI 不做路径补全，报错即意味着路径不对：
- Linux/macOS：
code --install-extension /home/user/ext/ms-python.python-2024.6.0.vsix - Windows（推荐正斜杠）：
code --install-extension C:/ext/prettier-9.10.3.vsix - 路径含空格或中文？必须加英文双引号：
code --install-extension "/path/to/my ext.vsix" - 若提示
command not found: code，在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH启用
手动解压复制到 extensions 目录的硬核方式
适用于无 GUI、权限受限或 CLI 被策略封锁的服务器环境，但容错率低，步骤必须严丝合缝：
- 先用
unzip -l xxx.vsix查顶层目录名，例如ms-python.python-2024.6.0/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 解压后把整个该目录（含
node_modules、server/等）复制进对应路径：
Windows：%USERPROFILE%\AppData\Roaming\Code\Extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 不能只复制里面的内容，也不能保留
.vsix文件本身；复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新
插件显示已安装却没功能？别急着重装，先查兼容性
VSCode 对版本不兼容的处理非常安静：不报错、不提示、只是跳过加载。关键检查点：
- 打开
.vsix解压后的package.json，找"engines": {"vscode": "^1.80.0"} - 运行
code --version，取输出中第一位小数点前的数字（如1.85.2→1.85），需 ≥ 插件要求的最低版本 - 语言类插件（如
ms-python.python或znck.vue-language-features）首次启用会尝试下载 LSP 二进制，离线时卡在 “Downloading…” —— 这时候得提前在同架构机器上拉完，再整目录迁移 - 检查是否被工作区禁用：左下角齿轮 →
Extensions→ 找到插件 → 看右上角有没有Disable (Workspace)
最易被忽略的是 LSP 服务和架构匹配：Vue/Volar、C++、Python 插件离线能装上，但真正干活靠的是本地 server/ 下的可执行文件，x64 和 arm64、win32 和 darwin 不能混用，且必须在联网机上首次激活过才完整。
