code命令未注册是首要原因，需先运行which code或where code验证，再通过ctrl+shift+p执行shell command: install 'code' command in path修复；路径须绝对、含空格需加双引号、离线安装须加--allow-unverified参数。
code --install-extension 命令不生效？先看它是否真的可用
命令行安装的前提是 code 命令本身能被系统识别。很多人执行 code --install-extension xxx.vsix 报 command not found: code，不是路径写错了，而是 VSCode 根本没注册 CLI 工具。
验证方式：终端运行 which code（Linux/macOS）或 where code（Windows）。无输出即未注册。
修复方法：
- 在已打开的 VSCode 中按
Ctrl+Shift+P，输入并执行Shell Command: Install 'code' command in PATH - Windows 推荐用正斜杠路径写法，例如：
code --install-extension "C:/ext/python-2024.6.0.vsix"，避免反斜杠转义问题 - macOS/Linux 用户若用 SSH 连虚拟机，需确认
~/.bashrc或~/.zshrc中已source新增的 PATH
路径、空格、签名：三个最容易卡住的硬性条件
code --install-extension 对输入极其敏感，错一个条件就静默失败，不报具体错误。
必须满足：
- 使用绝对路径——相对路径如
./python.vsix或ext/python.vsix一律无效 - 路径含空格或中文时，必须用英文双引号包裹整个路径，例如：
code --install-extension "/Users/张三/Downloads/prettier-9.10.3.vsix" - 离线环境无法校验微软签名链，会触发
INVALID_SIGNATURE错误，必须加--allow-unverified参数，例如：code --install-extension python.vsix --allow-unverified
装上了却没功能？语言插件的 LSP 服务根本没下载
像 ms-python.python、volarjs.volar 这类语言插件，.vsix 只是前端壳子。首次启用时才会拉取 pyright-server、volar-server 等 native 二进制服务——离线环境下卡在 “Downloading…” 就是这个原因。
真正离线可用的做法：
- 在有网机器上，用**相同版本** VSCode 安装该插件
- 打开一个对应文件（如
test.py），等状态栏显示Ready，确保 LSP 已落地 - 完整拷贝整个扩展目录，例如：
~/.vscode/extensions/ms-python.python-2024.6.0/ - 粘贴到内网机同路径下，并**彻底退出 VSCode（包括托盘进程）再重启**
ARM Mac 装 x64 插件、VSCode 版本太低：静默失败不报错
VSCode 不会提示“架构不匹配”或“版本不兼容”，而是直接跳过加载，插件面板显示已安装，但功能缺失。
排查要点：
- 运行
code --version，查看 Help → About 显示的架构（x64/arm64）；解压.vsix后检查package.json是否含darwin-arm64或darwin-x64字段 - 用
unzip -p plugin.vsix package.json | grep engines查插件要求的最低 VSCode 版本，再对比本地code --version输出 - 版本不匹配时，去 Marketplace 的
/versionhistory页面手动选旧版下载，例如：https://marketplace.visualstudio.com/items/ms-python.python/versionhistory
真正的难点不在命令本身，而在「装完之后是否真能用」——前端显示正常、LSP 服务缺失、架构错位、依赖插件未同步，这些都不会报错，只会让功能静默失效。
