解决安装报错的VSCode插件离线下载与配置检查-VSCode-PHP中文网

code命令未找到的根本原因是未注册到path，需运行which code验证，无输出则通过vscode命令面板执行“shell command: install 'code' command in path”并重启终端。

解决安装报错的vscode插件离线下载与配置检查

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 打开确认。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

插件列表显示“已安装”，但补全/跳转不工作

语言类插件（如 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（含托盘进程）再重开。