code命令未注册是安装失败主因：Windows需检查PATH、macOS/Linux需建立软链；命令可用后，再处理路径空格、权限、签名、版本兼容及语言服务器依赖等问题。
code 命令根本没注册到系统，是绝大多数“安装失败”的真正原因——不是插件问题，而是连命令都找不到。
code --install-extension 报 command not found
这说明终端压根不认识 code 这个命令，后续所有安装逻辑都不会触发。
- Windows：检查环境变量
PATH是否包含C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin；若没勾选安装时的 “Add to PATH”，需手动添加并重启终端 - macOS：运行
ls -l /usr/local/bin/code，若无输出或链接失效，用sudo ln -s /Applications/Visual\ Studio\ Code.app/Contents/Resources/app/bin/code /usr/local/bin/code重建软链 - Linux（Snap 版）：
code命令默认不可用；改用官网.deb或.tar.gz包，或手动把解压后bin/code软链到/usr/local/bin/code - 验证是否生效：在全新终端窗口中执行
code --version，有输出才继续下一步
code --install-extension 执行后静默失败
命令能跑，但扩展没装上、也没报错，常见于路径、权限或签名校验环节被跳过。
- 路径含空格或中文时，必须用双引号包裹：
code --install-extension "D:\my ext\python-2024.6.0.vsix" - 别用
sudo执行该命令：否则插件会装进/root/.vscode/extensions/，普通用户启动 VSCode 后完全看不到 - 离线环境默认拒绝未签名扩展，加
--allow-unverified参数：code --install-extension prettier.vsix --allow-unverified - 确保 VSCode 已完全退出（
code --status应无运行中进程），否则扩展可能被缓存锁住
装上了但不生效或报 incompatible
扩展出现在列表里，却灰色禁用、提示 API 不兼容，本质是版本契约没对齐。
- 用
unzip -p plugin.vsix package.json | grep engines提取插件要求的 VSCode 版本，例如"vscode": "^1.85.0" - 执行
code --version确认本地版本；若为 1.79.2，则必须升级 VSCode（离线需下载匹配的.deb或.tar.gz） - 某些插件依赖语言服务器二进制（如
pyright、rust-analyzer），仅装 .vsix 不够，需额外部署 server 文件并配置python.defaultInterpreterPath或rust-analyzer.serverPath - 检查
~/.vscode/extensions/目录权限是否归属当前用户：ls -ld ~/.vscode/extensions；若显示root，运行chown -R $USER:$USER ~/.vscode/extensions
最常被忽略的是：VSCode 的 CLI 安装和 GUI 安装走的是两套路径，GUI 拖拽失败时别指望命令行自动兜底——必须确认 code 命令本身可用、路径可写、版本匹配、签名策略适配，四者缺一不可。
