code命令不可用导致安装失败，主因是cli未注册到path；需先运行which code验证，无输出则用绝对路径临时解决，或在vscode中执行shell command: install 'code' command in path永久修复。
code 命令不可用导致安装静默失败
执行 code --install-extension 报 command not found，不是插件问题，而是 VSCode 的 CLI 工具根本没注册进系统 PATH。官方 .deb/.rpm 包和 macOS ZIP 版默认不自动配置 code 命令，尤其在 SSH 终端或虚拟机非交互式环境下更常见。
- 先运行
which code：无输出即确认未注册 - 临时解决：用绝对路径，如
/usr/bin/code --install-extension /path/to/plugin.vsix（Linux）或/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code --install-extension /path/to/plugin.vsix（macOS） - 永久修复：在 VSCode 内按
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行，再重启终端 - 切勿加
sudo：否则插件会装到 root 用户目录，普通用户启动 VSCode 后完全看不到
拖拽 .vsix 文件无响应或卡在 “Installing…”
图形界面拖放依赖后台网络请求做签名验证和解压调度，断网时它不报错，只挂起或丢弃操作——这不是 VSCode 崩溃，是机制性阻塞。
- 确认 VSCode 窗口有焦点：任务栏图标是否高亮？全屏或远程桌面（RDP/TeamViewer）下拖放常被拦截，需退出全屏再试
- 检查文件是否真为未解压的
.vsix：运行unzip -l plugin.vsix，顶层必须含extension/package.json；若显示零散文件，说明已被解压或损坏 - 路径含中文或空格？Windows 下必须用英文双引号包裹，如
"C:\my ext\ms-python.python-2024.6.0.vsix" - 虚拟机共享文件夹（如
/mnt/hgfs）拖入常失败：先复制到本地路径（如~/Downloads/），再拖拽
插件装上了但功能完全不生效
离线安装成功 ≠ 插件立即可用。语言类、格式化类插件（如 ms-python.python、esbenp.prettier-vscode）首次启用时会静默尝试下载 LSP 服务或 CLI 二进制，断网即卡在 “Starting Python Server…” 或 “Downloading…”，且无提示、无错误日志。
- 插件状态可能为禁用：VSCode 离线安装后默认将插件设为 disabled，需手动点击「启用」或彻底重启编辑器才加载
- LSP 未落地：仅安装
.vsix只注册前端逻辑，pyright、volar-server 等 native 组件并未部署。正确做法是在有网机器上打开一个.py或.vue文件，等状态栏显示 “Ready” 后，整份拷贝~/.vscode/extensions/ms-python.python-2024.6.0/（含node_modules、dist、所有子目录）到内网机对应路径 - 复制后必须彻底退出 VSCode：包括右下角托盘进程、后台
Code Helper进程，否则缓存不刷新，新插件不会激活
版本或架构不匹配导致静默拒绝
VSCode 不会明确报错 “版本不兼容”，而是直接跳过加载——你看到插件出现在已安装列表里，点开却无任何反应，大概率是 engines.vscode 字段校验失败或 ARM/x64 架构错配。
- 运行
code --version，取前两位（如1.92.2→1.92） - 解压
.vsix并查声明：unzip -p plugin.vsix extension/package.json | grep engines，看"vscode": "^1.85.0"这类字段 - 本地版本必须 ≥ 插件要求的最低版本；差一个小版本（如
1.92vs^1.93.0）就会静默拒绝 - ARM 架构机器（如 M-series Mac）不能装 x64 构建的
.vsix：Help → About 里看架构，再去 Marketplace 的versionhistory页面手动选对应平台旧版下载
