离线安装VSCode插件需满足三前提：VSCode运行且获焦点、拖入未解压.vsix文件、版本兼容；否则静默失败。常用排查包括检查焦点、全屏/远程环境、文件格式，推荐用code --install-extension加绝对路径，或手动解压至extensions目录并彻底重启VSCode。
直接拖进 VSCode 主窗口就能装，但必须满足三个前提：VSCode 正在运行且有焦点、文件是未解压的 .vsix、版本兼容。不满足任一条件都会静默失败——不是插件坏了，是你没对上路。
拖进主窗口没反应？先确认这三件事
这是离线安装里最高频的“假失败”：
- VSCode 没获得系统焦点：点击编辑器任意空白处，让任务栏图标高亮再试
- 当前处于全屏模式或远程桌面（如 RDP / TeamViewer）：这类环境常拦截拖放事件，退出全屏或改用命令行
- 拖的是解压后的文件夹或重命名过的
.zip：VSCode 只认原始.vsix压缩包；用unzip -l xxx.vsix看顶层是否为extension/目录
code --install-extension 命令必须用绝对路径
相对路径在脚本或终端中极易失效，VSCode CLI 不做路径补全：
- Linux/macOS：
code --install-extension /home/user/ext/prettier-9.10.3.vsix - Windows（推荐正斜杠）：
code --install-extension C:/ext/ms-python.python-2024.6.0.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查顶层目录名，例如esbenp.prettier-vscode-9.10.3/—— 这就是扩展 ID + 版本，必须原样作为子目录名 - 解压后把整个该目录复制进：
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），需 ≥ 插件要求的最低版本 - ARM Mac 上装 x64 构建的插件（尤其含 native binary 的）会失败，得找带
darwin-arm64的 vsix - 检查是否被工作区禁用：左下角齿轮 →
Extensions→ 找到插件 → 看右上角有没有Disable (Workspace)
真正容易被忽略的是：很多插件（比如 ms-python.python）首次启用时会自动下载语言服务器，这个行为默认走外网。离线环境下它不会报错，只会卡在状态栏 “Downloading…”。你得提前在有网机器上触发一次完整加载，再把整个 extensions/xxx-yyy-zzz 文件夹拷过去——而不是只拷 .vsix。
