根本原因是code命令未注册到系统path或shell环境未加载正确path；应先运行which code或where code验证，再通过vscode命令面板执行“shell command: install 'code' command in path”修复。
code --install-extension 报“找不到文件”或静默失败
根本不是路径写错了，而是 code 命令本身不可用，或当前 shell 环境压根没加载正确的 PATH。Windows 的 CMD 和 PowerShell、macOS/Linux 的 zsh 和 bash，环境变量互不共享，同一台机器上可能一个终端能跑，另一个就报错。
实操建议：
- 先运行
which code（Linux/macOS）或where code（PowerShell），无输出即命令未注册 - 不要手动改
/usr/bin或C:\Users\...\AppData\Local\Programs\Microsoft VS Code\bin这类路径——VSCode 自身的 CLI 注册机制才是正解 - 在 VSCode 里按
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行，然后重启终端 - 临时救急可用绝对路径：Linux/macOS 是
/usr/bin/code --install-extension /full/path/to/plugin.vsix；macOS ZIP 版是/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code --install-extension ...
插件装完却没出现在 ~/.vscode/extensions 下
VSCode 没报错，但 ~/.vscode/extensions（Linux/macOS）或 %USERPROFILE%\.vscode\extensions（Windows）里空空如也，说明安装过程被静默跳过——常见于权限锁死、挂载路径不可写或自定义扩展目录失效。
实操建议：
- 检查是否用了
--extensions-dir启动参数或在settings.json里配置了"extensions.installDir"：若路径不存在或不可写，VSCode 会放弃写入且不提示 - WSL 中挂载的 Windows 分区、企业 NTFS 卷、macOS SIP 保护的系统盘，都可能拒绝写入；临时改用
--extensions-dir ~/vscode-ext更稳妥 - 别加
sudo执行code --install-extension：插件会落到/root/.vscode/extensions，普通用户启动 VSCode 后完全不可见 - 确认用户数据目录可写：
ls -ld ~/.config/Code（Linux/macOS）或icacls "%APPDATA%\Code"（Windows），确保当前用户有完整控制权
拖拽 .vsix 后卡在 “Installing…” 或无反应
这不是网络问题，图形界面拖放依赖后台进程调度和签名校验，断网时它不报错，只挂起或丢弃操作。全屏、远程桌面（RDP/TeamViewer）、多显示器焦点偏移都会导致拖放事件根本没送达 VSCode 进程。
实操建议：
- 确保 VSCode 窗口有系统焦点：任务栏图标高亮，非最小化状态；退出全屏再试
- 验证文件完整性：用
unzip -l plugin.vsix看顶层是否含extension/目录；若显示一堆零散 JSON 或 JS 文件，说明已被解压重打包过，VSCode 拒绝加载 - 路径含中文或空格？Windows 必须用英文双引号包裹，如
"C:\my ext\ms-python.python-2024.6.0.vsix" - 虚拟机共享文件夹（如
/mnt/hgfs）拖入常失败：先复制到本地路径（如~/Downloads/），再拖
离线安装后插件存在但功能缺失
很多插件（比如 ms-python.python、volarjs.volar）只装 .vsix 只是注册前端 UI，真正干活的语言服务器（pyright-server、volar-server）需首次启用时联网下载。离线环境下卡在 “Downloading…” 就是这个原因。
实操建议：
- 在有网机器上完整触发一次：打开对应类型文件（
.py、.vue），等状态栏显示 “Ready”，再把整个插件目录（如~/.vscode/extensions/ms-python.python-2024.6.0/）连同子目录里的 native 二进制一起拷到内网机 - 覆盖前必须彻底退出 VSCode：包括右下角托盘残留进程，否则缓存不刷新，旧逻辑仍生效
- ARM 架构（M 系列 Mac）装 x64 插件不会报错，但 native 部分静默失效；检查
Help → About显示的架构，再去 Marketplaceversionhistory页面选对平台版本下载
code 命令是否真可用，再盯住扩展目录的实际写入位置，最后留意语言服务器这类“半离线”组件的真实落地方式。
