离线安装失败后vscode启动异常，90%因插件校验卡在启动阶段：code命令未注册、路径含空格未加引号、engines.vscode版本不匹配、扩展目录权限异常或语言服务器缺失，导致白屏、闪退或静默崩溃。
离线安装失败后 VSCode 启动异常，90% 是因为插件校验卡在启动阶段，而不是安装本身出错——它不报错，只拒绝加载、白屏、闪退或根本拉不起进程。
code --install-extension 报错但没提示具体原因
命令行静默失败或卡住，常见于三种情况：
• command not found: code：CLI 工具根本没注册，不是网络问题，是 PATH 缺失；先运行 Shell Command: Install 'code' command in PATH，再重启终端
• ENOENT：路径写错或文件不存在，但更常发生在 Windows 路径含空格却没加双引号，比如 code --install-extension C:\my ext\python.vsix 必须写成 code --install-extension "C:\my ext\python.vsix"
• Extension is not compatible with Code：不是插件坏了，而是 package.json 里 "vscode": "^1.93.0" 和你本地 code --version（取前两位，如 1.92.2 → 1.92）不匹配，差一个小版本就拒载
安装后 VSCode 启动卡白屏 / 闪退 / 无响应
这不是插件没装上，而是损坏的扩展在启动时触发了崩溃链：
• 先用 code --disable-extensions 启动，能进说明是扩展冲突；不能进则可能是用户配置损坏或 ~/.vscode/extensions 目录权限异常
• 检查 ~/.vscode/extensions 所有者是否为当前用户（Linux/macOS）：ls -ld ~/.vscode/extensions，若属 root，执行 sudo chown -R $USER:$USER ~/.vscode/extensions
• Windows 下检查 %USERPROFILE%\.vscode\extensions 是否被杀软或组策略锁定；任务管理器里确认没有残留 Code.exe 进程
• 别忽略语言类插件（如 ms-python.python）的离线依赖：它需要一并部署 pyright 或 python-language-server，否则启动时反复尝试联网拉 LSP，导致界面冻结
拖拽 .vsix 后一直显示 “Installing…” 却没反应
图形界面安装本质是调用后台 Node.js 进程做签名验证和解压，断网时它不报错，只挂起：
• 确认 VSCode 窗口有焦点（远程桌面/RDP 下拖放常被拦截）
• 检查文件是否真为 .vsix：unzip -l plugin.vsix 应看到顶层有 extension/package.json；若显示一堆零散文件，说明已被浏览器或杀软自动解压
• 虚拟机共享目录（如 /mnt/hgfs）拖入基本无效，必须先复制到本地路径（如 ~/Downloads/）再拖
• macOS 上若从 Safari 下载，可能被自动加 .zip 后缀，别右键重命名，用 mv plugin.vsix.zip plugin.vsix 重命名
最易被忽略的是：VSCode 在离线状态下仍会尝试校验扩展签名、加载语言服务器、恢复上次工作区——这些动作全在启动瞬间发生，一旦某个环节失败，它不会弹窗，只会沉默退出或卡死。所以排查顺序永远是：先关所有进程 → 再禁用扩展启动 → 最后逐个验证已安装插件的 package.json 和本地版本兼容性。
