code命令未找到的根本原因是未注册到PATH，需运行which code验证，无输出则通过VSCode命令面板执行“Shell Command: Install 'code' command in PATH”并重启终端。
code --install-extension 报 command not found 怎么办
根本不是插件问题，而是 code 命令根本没注册进 shell。VSCode 官方安装包（尤其是 .deb/.rpm 或国产系统）默认不自动写入 PATH，SSH 登录或非交互终端里尤其常见。
验证方式：which code 无输出即失败。
临时解法：用绝对路径，比如 /usr/bin/code --install-extension /path/to/extension.vsix（Linux/macOS）或 "C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd" --install-extension "D:\ext.vsix"（Windows）。
永久解法：
- 在 VSCode 内按
Ctrl+Shift+P，输入并执行Shell Command: Install 'code' command in PATH - 关掉所有终端，新开一个；若仍不行，检查
~/.bashrc或/etc/environment是否真加入了/usr/bin，然后source ~/.bashrc - 国产系统（如统信UOS、麒麟）需注意：root 用户装的 VSCode，普通用户也得单独执行一次注册命令
报 “Extension is not compatible with Code” 怎么快速定位
这不是提示你“升级 VSCode”，而是明确告诉你：插件声明的最低版本 > 你本地版本。VSCode 不会降级适配，只做硬拒绝。
必须比对三处：
- 运行
code --version，取主版本号（如1.84.2→1.84） - 解压
.vsix（它本质是 zip），查看extension/package.json中"engines": {"vscode": "^1.85.0"}字段 - Help → About 里括号中的架构（
x64/arm64）是否与插件构建目标一致 —— ARM Mac 装 x64 版本的pyright会静默失败
别猜，直接查：unzip -p extension.vsix extension/package.json | grep engines（macOS/Linux）或用 7-Zip 打开确认。
插件列表显示“已安装”，但补全/跳转不工作
语言类插件（如 ms-python.python、dbaeumer.vscode-eslint、volarjs.volar）只是“壳”。它们首次启用时才会拉取真正的语言服务（LSP server）、调试器后端等二进制组件 —— 这些东西不打包进 .vsix，离线时必然卡住。
典型现象：
- 状态栏右下角一直显示
Downloading Pylance或Downloading volar-server -
Ctrl+Shift+U打开 Output 面板，选对应通道，看到spawn ENOENT或连接超时日志 - 打开
.py或.vue文件后，语法高亮有，但 Ctrl+Click 跳不到定义、无智能提示
解决方法不是重装 .vsix，而是：在联网机器上完整启用一次该插件 → 确认 server/ 子目录和对应平台二进制（如 volar-server-darwin-arm64）已下载完成 → 整个插件文件夹（如 volarjs.volar-1.14.0/）拷到内网机的 $HOME/.vscode/extensions/ 下 → 彻底退出 VSCode（含托盘进程）再重开。
拖拽 .vsix 没反应，GUI 安装静默失败
VSCode 的拖放逻辑有硬前提，缺一不可：
- 必须已加载一个工作区（哪怕只是空文件夹），纯欢迎页或远程 SSH 未连接完成时拖放被忽略
- 窗口要有系统焦点：任务栏图标高亮，且不能处于全屏、RDP/VNC 远程桌面、或多显示器缩放偏移状态
- 拖的是原始
.vsix文件，不是浏览器自动加了.zip后缀的xxx.vsix.zip，也不是手动解压后的文件夹
验证文件完整性：unzip -l your-extension.vsix 必须显示顶层为 extension/ 目录，且含 extension/package.json。任何结构异常（如顶层是 package.json 直出）都说明文件已被破坏或非官方来源。
国产系统（UKUI/Cinnamon/DDE）下更要注意：Wayland 会话或远程桌面常拦截拖放事件，此时唯一可靠方式就是命令行 + 绝对路径 + --force 参数。
