离线安装vscode插件需确保工作区已加载、窗口有焦点、拖拽原始.vsix文件；命令行安装须用绝对路径并加--allow-unverified；python/remote-ssh等插件还需提前部署lsp服务和vscode-server二进制。
离线安装 VSCode 本身不需“安装”，直接解压或运行便携版即可；真正要解决的是插件（尤其是 Remote-SSH、Python 等带服务端依赖的插件）在无网时能真正用起来——不是显示“已安装”，而是语法补全、远程连接、LSP 启动全部就绪。
拖拽 .vsix 到编辑区没反应？检查这三件事
这是最常被误判为“VSCode 不支持离线”的场景，其实只是触发条件没凑齐：
- VSCode 必须已加载一个工作区：哪怕只打开一个空文件夹（
File → Open Folder），纯启动页（Welcome 页面）不响应拖放事件 - 窗口必须有系统焦点：任务栏图标高亮，且不能处于全屏、RDP/TeamViewer 远程桌面、或多显示器缩放偏移状态
- 拖的是原始
.vsix文件：它本质是 zip，可用unzip -l xxx.vsix验证顶层是否为extension/目录；解压后的文件夹、重命名成.vsix.zip的文件、或右键“发送到压缩包”生成的文件，都会静默失败
code --install-extension 报错或静默失败？路径和参数是关键
命令行方式适合脚本化部署，但对环境敏感，报错即意味着问题明确可查：
- Windows 下路径含空格或中文，必须加英文双引号：
code --install-extension "C:\vsix\ms-python.python-2024.6.0.vsix" - Linux/macOS 必须用绝对路径，
./ext.vsix或~/ext.vsix均无效：code --install-extension /home/user/ext/prettier-9.10.3.vsix - 离线环境下证书链无法校验，必须加
--allow-unverified参数：code --install-extension python.vsix --allow-unverified - 提示
command not found: code？说明 CLI 未注册：在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行
插件显示“已安装”，但 Python 补全/Remote-SSH 连不上？LSP 和 server 没落地
语言类插件（如 ms-python.python）和 Remote-SSH 插件的 .vsix 只是前端壳，核心能力依赖运行时下载的二进制服务：
-
ms-python.python首次启用会尝试拉取pyright或python-language-server，离线时卡在状态栏Downloading...或输出面板报Failed to fetch - Remote-SSH 连接失败，根本原因是远端
~/.vscode-server目录下没有匹配本地 VSCode 版本的vscode-server二进制（如 VSCode 1.90.2 客户端必须配 1.90.2 的 server） - 解决办法不是重装插件，而是提前准备完整包：从外网机器用
code --version查主版本号（如1.90.2→ 取1.90），再下载对应vscode-server-linux-x64.tar.gz或vscode-server-win32-x64.tar.gz，手动解压到远端~/.vscode-server/bin/下指定哈希子目录中
组策略禁用扩展、CLI 被锁死？只能手动解压直装
当企业策略彻底封锁 GUI 和 CLI 时，唯一出路是拆包直投 extensions 目录，但结构必须严丝合缝：
- 先用
unzip -l your-extension.vsix查顶层目录名，例如ms-python.python-2024.6.0/—— 这就是扩展 ID + 版本号，不能改名，也不能删后缀 - 整个解压后的文件夹（含
package.json、node_modules、dist/等）移入：
Windows：%USERPROFILE%\.vscode\extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 复制完必须彻底退出 VSCode：包括右下角托盘图标右键“退出”，否则缓存不刷新，新插件不会加载
真正难的从来不是“装上”，而是让 pyright 跑起来、让 vscode-server 启动成功、让 prettier 的 CLI 二进制被找到——这些细节不补全，插件面板里再漂亮的勾选也等于零。
