VSCode插件安装静默失败主因是路径错误、签名验证失败或VSCode未彻底退出；离线需加--allow-unverified；拖拽安装需已加载工作区、窗口获焦点且为原始.vsix文件；带LSP服务的插件须补全server二进制及extensionDependencies依赖。
code --install-extension 命令静默失败？先盯住这三处
命令行安装看似最可控，但实际最容易卡在“没报错却没装上”。根本原因不是插件坏了，而是 VSCode CLI 在三个环节直接放弃：路径不对、签名验不过、VSCode 没真正退出。
常见错误现象：code --install-extension prettier.vsix 执行后无输出、无提示、扩展列表里找不到；或者提示 INVALID_SIGNATURE 但你确定文件是官网下载的。
- 必须用绝对路径：Linux/macOS 写
/home/user/ext/prettier-9.10.3.vsix，Windows 写C:/ext/ms-python.python-2024.6.0.vsix（推荐正斜杠，避免转义问题） - 含空格或中文路径？加英文双引号：
code --install-extension "/mnt/内网共享/veriloghdl-v1.12.0.vsix" - 离线环境无法校验证书链时，必须加
--allow-unverified参数：code --install-extension python.vsix --allow-unverified - 装完不生效？不是重装，是彻底退出 VSCode——右下角托盘图标也要右键退出，否则缓存不刷新
拖拽 .vsix 到窗口没反应？不是插件问题，是环境没就绪
这是最高频的“假失败”：你拖了十次，VSCode 窗口纹丝不动，第一反应是文件损坏。其实它只对三种状态敏感，缺一不可。
使用场景：临时借一台内网机器快速配环境，没开终端、不记得命令、只想拖进去完事。
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），纯启动页或远程连接未建立时，拖放事件被直接忽略
- 窗口要有系统焦点：任务栏图标高亮，且不能处于全屏、RDP、TeamViewer 或多显示器缩放偏移状态
- 拖的是原始
.vsix文件，不是解压后的文件夹、不是.zip、不是右键重命名生成的prettier.vsix.zip（这种双后缀 Windows 会静默解压） - 验证方法：
unzip -l your-extension.vsix应显示顶层为extension/目录，且含extension/package.json
装上了却没功能？大概率是 LSP 服务没落地
Python、Rust、Vue、Verilog 这类插件，.vsix 只是前端壳。真正干活的语言服务器（如 pyright-server、volar-server、verilog-server）得在首次启用时联网下载。离线环境下，它就卡在“Downloading…”或直接静默跳过。
性能影响：不补 server，打开对应文件类型就是纯文本，无语法高亮、无跳转、无诊断——和没装一样。
- 正确做法：在同版本、同架构（x64/darwin-arm64）的联网机器上完整走一遍流程——打开一个
.py或.vue文件 → 等状态栏右下角出现Python: Ready或Volar: Ready→ 再拷整个扩展目录 - 路径必须完整：
~/.vscode/extensions/ms-python.python-2024.6.0/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\Extensions\ms-python.python-2024.6.0\（Windows） - 不能只拷
.vsix，也不能只拷node_modules；server 二进制藏在子目录如server/volar-server或dist/pyright里 - Verilog-HDL 插件同理：确认
extension/server/下有verilog-server或verilog-server.exe，没有就得手动补
批量部署时漏掉依赖插件？别信“Recommended”，要看 extensionDependencies
团队统一配环境时，靠人肉下载很容易漏掉隐式依赖。比如装了 esbenp.prettier-vscode 却没装 bradlc.vscode-tailwindcss，格式化 Tailwind 类名就失效；装了 ms-python.python 却漏了 ms-python.pylance，类型推导直接归零。
兼容性影响：依赖缺失不会报错，只会让部分功能静默降级，排查成本远高于预防。
- 最稳方式：在已配好的联网机器上执行
code --list-extensions > extensions.txt，导出真实启用的 ID 列表 - 依赖不在推荐栏里，而在
.vsix解压后的package.json的extensionDependencies字段中 - 批量下载推荐用
vsce download：例如vsce download ms-python.python@2024.6.0，比手动拼 URL 更可靠 - 注意版本锁死：
ms-python.python-2024.6.0.vsix和ms-python.pylance-2024.7.0.vsix要匹配，否则可能因engines.vscode不一致而互相排斥
extensionDependencies 字段和 server/ 子目录的存在性——它们不体现在安装界面，也不出现在命令行输出里，但决定了你打开文件那一刻，是高效编码还是纯文本发呆。 
