离线安装失败主因是VSCode未找到.vsix文件，因路径错误、环境未加载或shell解析失败；需先用which/where code验证CLI注册，再用绝对路径安装，并确保焦点、文件完整性及权限正常。
离线安装失败，90% 不是插件坏了，而是 VSCode 根本没找到 .vsix 文件——路径写错、环境没加载、或 shell 解析失败，它连文件名都读不全。
code --install-extension 报 “ENOENT” 或 “command not found”
这不是网络问题，是终端压根没认出 code 命令，或者你给的路径 VSCode 完全无法解析。
- 先运行
which code（Linux/macOS）或where code（Windows PowerShell），无输出就说明 CLI 没注册 - 别依赖安装时勾选的 “Add to PATH”：Windows 的 CMD 和 PowerShell 不共享环境变量；macOS/Linux 下 zsh/bash 的
$PATH也可能不同 - 临时救急：用绝对路径执行，比如
/usr/bin/code --install-extension /home/user/ext/python.vsix（Linux）或"C:/Users/me/Downloads/ms-python.python-2024.6.0.vsix"（Windows，必须英文双引号包裹） - 永久修复：在 VSCode 里按
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车，再重启终端
拖拽 .vsix 到窗口后没反应
图形界面安装看似简单，但实际依赖三个前提同时满足：VSCode 窗口有焦点、工作区已加载、且文件是原始未解压的 .vsix。
- 确认任务栏图标高亮，远程桌面（RDP/TeamViewer）下拖放常被拦截，试试先最小化再恢复窗口
- 不要从虚拟机共享目录（如
/mnt/hgfs或Z:\）直接拖：先复制到本地路径（如~/Downloads/或C:\Users\me\Downloads\）再拖 - 用
unzip -l plugin.vsix检查顶层是否有extension/package.json；若显示一堆零散文件，说明已被解压或损坏 - 路径含中文或空格？Windows 必须用英文双引号，Linux/macOS 绝对路径中也建议加引号，避免 shell 分词错误
装完插件目录里没生成文件夹
VSCode 安装成功后，必须在 ~/.vscode/extensions（Linux/macOS）或 C:\Users\{用户名}\.vscode\extensions（Windows）下看到对应插件子目录。没出现，说明安装流程被静默跳过。
- 检查
~/.vscode/.extensions-tmp（Linux/macOS）或%USERPROFILE%\.vscode\.extensions-tmp（Windows）是否存在并可写；杀软或云桌面策略可能拦截该临时目录 - 别手动改过
settings.json里的extensions.installDir：路径不存在、拼写错误或权限不足，会导致所有安装静默失败 - 权限问题高频出现在 WSL 挂载的 Windows 分区、NTFS 卷、或 macOS SIP 启用的系统盘；临时改用
--extensions-dir指向用户主目录下的可写子目录更稳妥 - 装完务必彻底退出 VSCode：右下角托盘图标也要右键退出，否则缓存不刷新，新插件不会加载
真正难搞的不是路径本身，而是 VSCode 在后台静默跳过的那些环节——它不报错，只不动。验证必须分层做：先确认 code 命令存在，再确认路径能被 shell 正确传递，最后盯住 .vscode/extensions 目录是否真有写入。任何一层断掉，都会让你以为“文件坏了”。
