code命令找不到是因vscode未注册cli到path，非插件问题；应执行shell command安装code命令或用绝对路径临时调用，切勿加sudo。
code 命令找不到，根本不是插件问题
执行 code --install-extension 报 command not found，90% 是 VSCode 没把 CLI 工具注册进系统 PATH，和插件文件是否缺失完全无关。官方 .deb/.rpm 包、macOS ZIP 版默认不自动配置 code 命令。
实操建议：
- 先运行
which code（Linux/macOS）或where code（PowerShell），无输出就确认命令不可见 - 在 VSCode 中按
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行，再重启终端 - 临时应急：用绝对路径安装，如
/usr/bin/code --install-extension /path/to/xxx.vsix（Linux）或/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code --install-extension /path/to/xxx.vsix（macOS） - 别加
sudo：否则插件会装到 root 用户目录，普通用户启动 VSCode 后根本看不到
.vsix 文件解压后缺 extension/package.json
VSCode 安装时第一件事就是读取 extension/package.json，如果这个文件不存在或路径不对，就会报 Extension is corrupt 或静默失败——不是程序文件“缺失”，而是你手动生成的 vsix 结构不合法。
实操建议：
- 用
unzip -l plugin.vsix查看顶层目录，必须有extension/package.json；若显示一堆零散 JS/CSS 文件，说明已被解压重打包过 - Windows 下别用资源管理器双击打开再保存，会破坏 ZIP 文件头；改用 PowerShell：
Expand-Archive plugin.zip -DestinationPath unpacked，再用Compress-Archive重新打包 - Linux/macOS 下验证完整性：
unzip -t plugin.vsix，输出OK才算可用 - 下载后务必核对官网页面右下角的 SHA256 值，浏览器断点续传或杀毒软件拦截都可能导致文件头损坏
装完插件目录里没生成对应文件夹
VSCode 安装成功后，应在 ~/.vscode/extensions/（Linux/macOS）或 C:\Users\{用户名}\.vscode\extensions\（Windows）下看到形如 ms-python.python-2024.6.0/ 的文件夹。没出现，说明安装过程被静默跳过，常见于以下情况：
实操建议：
- 检查
code --version输出版本（如1.92.2），再解压 vsix 运行unzip -p plugin.vsix extension/package.json | grep engines，确认"vscode": "^1.85.0"这类字段中声明的最低版本 ≤ 你本地版本 - ARM 架构机器（如 M 系列 Mac）不能装 x64 构建的 vsix：Help → About 里看架构，再去 Marketplace 的
versionhistory页面手动选对应平台旧版下载 - 权限被锁死：WSL 挂载的 Windows 分区、企业 NTFS 卷、或 macOS SIP 保护的系统盘可能导致写入失败；可临时用
--extensions-dir指向用户主目录下的可写子目录，例如code --extensions-dir "$HOME/vscode-ext" --install-extension python.vsix - 插件依赖缺失：如
ms-python.python强依赖ms-toolsai.jupyter，离线时只装主包会静默失败且无提示；需一并下载所有extensionDependencies字段列出的插件 ID
语言插件装上了但 Python/Vue 功能不工作
这不是插件没装好，而是关键的 Language Server（LSP）二进制未部署。VSCode 插件安装只是注册，首次启用才触发 LSP 下载（如 pyright-server、volar-server），离线环境卡在 “Downloading…” 或报 spawn ENOENT。
实操建议：
- 在有网机器上完整触发一次：打开一个
.py文件 → 等状态栏不再显示 “Downloading” → 再去$HOME/.vscode/extensions/ms-python.python-2024.6.0/整个拷贝该文件夹（含node_modules和子目录里的 native 二进制） - 不能只拷
.vsix，也不能只拷package.json或extension.js；LSP 可执行文件通常藏在out/或dist/子目录下 - 复制完必须彻底退出 VSCode（包括右下角托盘里的
Code Helper进程），否则缓存不刷新，新 LSP 不加载 - Vue 插件同理：Volar 需要
volar-server，它不在 vsix 包里，而在扩展安装后的子目录中
package.json 的显式字段里，却决定功能是否可用。
