根本原因是code命令未加入path或shell环境不一致；需先验证which code/where code，再通过vscode命令注册cli，并用绝对路径安装vsix，注意文件完整性、依赖、版本兼容性及权限问题。
vscode --install-extension 报错“找不到文件”
根本原因不是路径写错了，而是 code 命令没进系统 PATH，或者你用了错误的 shell 环境。Windows 上 CMD 和 PowerShell 默认不共享环境变量，macOS/Linux 下 zsh 和 bash 的 PATH 也可能不同。
实操建议：
- 先在终端里运行
which code（macOS/Linux）或where code（Windows PowerShell），确认命令是否可执行；如果报“未找到”，说明 VSCode 没把 CLI 工具注册进系统 - 手动添加：macOS 打开 VSCode → Command Palette（
Cmd+Shift+P）→ 输入Shell Command: Install 'code' command in PATH并执行；Windows 在 VSCode 设置里勾选 “Add to PATH”（安装时或设置中） - 路径必须用绝对路径：
code --install-extension /home/user/downloads/python.vsix，不能用~/downloads/...或相对路径（如./python.vsix），VSCode 不解析波浪号或点号 - Windows 用户注意反斜杠问题：别写
C:downloadspython.vsix，要么全用正斜杠C:/downloads/python.vsix，要么双反斜杠C:\downloads\python.vsix
离线安装后插件目录里没生成文件夹
VSCode 安装 .vsix 后，应该在 ~/.vsix/extensions（Linux/macOS）或 C:Users{用户名}.vscodeextensions（Windows）下看到对应插件文件夹。没出现，说明安装过程被静默跳过或校验失败。
常见触发条件：
- .vsix 文件损坏或被解压重打包过：VSCode 要求原始二进制格式，不要用压缩软件打开再保存；下载后建议核对官网页面右下角的 SHA256 值
- 插件依赖缺失：比如
ms-python.python强依赖ms-toolsai.jupyter，离线时只装主包会失败且无提示；需一并下载所有dependencies字段列出的插件 ID - VSCode 版本太低：某些新插件在
package.json中声明了"engines": {"vscode": "^1.85.0"}，若你用的是 1.79，安装会被拒绝——此时要降级插件版本，而非升级 VSCode - 权限被锁死：WSL 中挂载的 Windows 分区、企业版 NTFS 卷、或 macOS 上启用了 SIP 的系统盘，都可能导致写入
.vscode/extensions失败；临时改用--extensions-dir指向用户主目录下的可写子目录更稳妥
想批量装插件但 extensions 目录路径不统一
不同机器上 .vscode/extensions 可能因系统、用户、安装方式差异而位置不一致，硬编码路径会导致脚本失效。真正的解法是绕过路径，用 VSCode 自身机制驱动安装。
推荐做法：
- 导出插件清单时加
--profile参数（VSCode 1.84+）：code --list-extensions --profile=default > ext-list.txt，避免多 profile 冲突 - 批量安装不用循环调
code --install-extension，改用--extensions-dir统一指向一个干净目录，再用code --install-extension配合--extensions-dir一起执行，例如：code --extensions-dir /tmp/vscode-exts --install-extension python.vsix - 验证是否真装进去了：别依赖 GUI 刷新，直接
ls /tmp/vscode-exts看文件夹是否存在；VSCode 启动时才会加载该目录，所以安装完再启动才生效 - 跨平台脚本中避免拼接路径：用
code --extensions-dir指定路径即可，VSCode 内部自动处理分隔符，无需自己判断是/还是
为什么 Developer: Show Extensions Folder 找不到刚装的插件
这个命令只打开当前 VSCode 实例正在使用的扩展目录，而它取决于你如何启动 VSCode。如果你用 code --extensions-dir /custom/path 启动，那它就打开 /custom/path；如果你双击图标启动，它打开默认路径。两者完全独立，互不影响。
最容易被忽略的一点：
- 同一个插件，可能同时存在于多个 extensions 目录里：默认路径下有旧版，
--extensions-dir下有新版，VSCode 只加载启动时指定的那个——你以为装上了，其实它根本没读那个目录 - 检查当前生效路径的最可靠方式：打开命令面板 → 输入
Developer: Inspect Context Keys→ 查看extensionsDir的值，这才是真实加载路径 - 卸载插件也得匹配路径：用图形界面卸载，只会删当前
extensionsDir下的；若你之前用命令行装到别处，得手动rm -rf对应文件夹，否则残留冲突
