code命令找不到是因未添加到path，需通过shell command命令修复；离线安装插件须用绝对路径、正确解压到extensions目录并匹配版本架构。
code 命令找不到？先看 PATH 有没有注册成功
离线安装插件失败，十次里有七次是 code 命令压根没生效——不是插件问题，是 VS Code 的 CLI 工具根本没进系统路径。
安装时没勾选“添加到 PATH”，code 就只在图形界面启动的终端里可用；PowerShell/CMD/WSL 里执行会直接报 command not found: code。
- 验证方式：终端运行
where code（Windows）或which code（macOS/Linux），无输出即未注册 - 补救方法：打开 VSCode →
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 注意权限差异：System Installer 写的是系统级 PATH，User Installer 只写当前用户 PATH；普通用户装了 System 版却没管理员权限，也可能导致注册失败
code --install-extension 必须用绝对路径
VS Code CLI 不做路径补全，相对路径在脚本或非图形终端中基本等于无效。常见现象是命令静默返回、无报错、插件也不出现——其实文件压根没读到。
- Linux/macOS 正确写法：
code --install-extension /home/user/ext/ms-python.python-2024.6.0.vsix - Windows 推荐用正斜杠：
code --install-extension C:/ext/prettier-9.10.3.vsix；若用反斜杠，必须双写：C:\ext\prettier.vsix - 路径含空格或中文？必须加英文双引号：
code --install-extension "/mnt/internal drive/python.vsix"
手动复制 .vsix 到 extensions 目录时，路径结构不能错
这不是把文件丢进去就完事的操作。VS Code 要求每个插件必须解压为独立子目录，且目录名必须严格匹配 .vsix 内部顶层结构——否则日志里只会显示 Extension 'xxx' is not installed，连错误提示都懒得给。
- 先查结构：
unzip -l my-ext.vsix，看第一行是不是类似esbenp.prettier-vscode-9.10.3/这样的目录 - 目标路径要对齐：
- Windows：
%USERPROFILE%AppDataRoamingCodeExtensions - macOS：
$HOME/Library/Application Support/Code/extensions/ - Linux：
$HOME/.vscode/extensions/
- Windows：
- 复制的是整个解压后的目录（含
package.json和node_modules），不是.vsix文件本身，也不能只复制里面的内容 - 操作后必须彻底退出 VSCode（包括托盘进程），否则缓存不刷新，新插件不会加载
离线安装前必须确认 VSCode 主版本与架构兼容
Extension is not compatible with VS Code x.x.x 这类报错，和你写的版本号无关，而是 engines.vscode 字段校验失败——VS Code 对插件有硬性约束，主版本号（如 1.85 vs 1.90）、CPU 架构（x64 / arm64）都得严丝合缝。
- 查当前环境：VSCode → Help → About → 记下 Version 后括号里的内容，比如
1.90.2 (arm64) - 下载插件必须去官方市场点 “Download Extension”，别用第三方打包或 GitHub 源码；Pylance、Jupyter 等还依赖其他扩展，得一并下载、按依赖顺序安装
- 版本不匹配时，
--force参数无效，强行覆盖也起不来
.vsix 解压后的目录命名——这两处出错，VS Code 不会报具体路径错误，只会静默失败或提示“未安装”，排查时得盯住 where code 和 unzip -l xxx.vsix 这两个动作。
