拖拽安装没反应？先检查VSCode是否已启动并获系统焦点、未全屏或远程桌面环境、拖入的是原始未解压的.vsix文件；命令行安装需绝对路径、加引号处理空格中文、注册code命令并加--allow-unverified参数；装上无功能需补LSP二进制且手动启用。
拖拽安装没反应？先检查这三个运行状态
VSCode 拖 .vsix 文件进主编辑区失败，90% 不是文件问题，而是环境没就绪。它只在以下三种状态同时满足时才响应拖放事件：
- VSCode 已启动且窗口有系统焦点（任务栏图标高亮，不是灰的）
- 当前未全屏、未处于 RDP/TeamViewer/VirtualBox 共享文件夹挂载路径下
- 拖入的是原始未解压的
.vsix文件（用unzip -l xxx.vsix验证顶层为extension/目录）
常见假失败：拖进远程桌面窗口、拖到侧边栏或设置页、拖的是重命名后的 prettier.vsix.zip（Windows 会静默解压）。
code --install-extension 命令静默失败的硬性条件
该命令不报错≠安装成功，失败时往往无任何输出。必须满足三要素：
- 路径必须是绝对路径：
code --install-extension /home/user/ext/python.vsix（Linux/macOS）或code --install-extension C:/ext/python.vsix（Windows，推荐正斜杠） - 含空格或中文？加英文双引号：
code --install-extension "/mnt/内网共享/python.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 并执行。
装上了却没语法高亮？语言类插件要补 LSP 二进制
离线安装 ms-python.python 后打开 .py 文件只显示“Starting Python Server…”——这不是安装失败，而是 LSP 服务（如 pyright）没落地。VSCode 只打包了前端壳，真正干活的二进制需首次联网下载。
- 可靠做法：在外网机器上完整触发一次 LSP 下载（打开并保存一个
.py文件），然后整目录拷贝：%USERPROFILE%\.vscode\extensions\ms-python.python-2024.6.0\（含node_modules、dist、out等全部子目录） - 复制到内网机对应路径后，必须彻底退出 VSCode（包括右下角托盘进程），再重启
- 验证点：打开
.py文件，状态栏应显示Python interpreter selected，而非长期卡在 “Starting…”
手动解压直装 extensions 目录的注意事项
当组策略禁用 GUI 和 CLI 时，只能拆包直装，但容错率极低：
- 解压
.vsix后，顶层目录名必须是扩展ID-版本号格式（如esbenp.prettier-vscode-9.10.3），不能改名 - 整个解压后的文件夹（含
package.json、node_modules）移入：%USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows）或$HOME/.vscode/extensions/（macOS/Linux） - 复制完必须完全退出 VSCode（任务管理器中确认无
Code.exe或Code Helper进程），否则不加载
最易忽略的点：插件面板显示“已安装”不等于“已启用”，离线安装默认为 disabled，必须手动点击「启用」或重启编辑器才真正激活。
