插件未生成文件夹说明安装被静默中断，常见原因包括vsix损坏、依赖缺失、权限不足、路径错误或非绝对路径；手动解压需严格匹配命名规范和结构；应优先用code命令安装并确认进程已退出。
code --install-extension 后 extensions 目录没生成插件文件夹
这说明安装流程被静默中断，不是“装上了但不生效”，而是根本没写入成功。VSCode 在校验失败、权限拒绝或依赖缺失时，不会报错，只跳过写入动作。
常见触发条件：
-
vsix文件被浏览器/杀毒软件解压重打包过：VSCode 要求原始二进制格式，用unzip -t plugin.vsix校验完整性；若报错，重新下载 - 插件有强依赖但未一并安装：例如
ms-python.python必须搭配ms-toolsai.jupyter，缺一则整个安装被丢弃，且无提示 - 目标
.vscode/extensions目录不可写：WSL 挂载的 Windows 分区、企业 NTFS 卷、macOS SIP 保护的系统路径都可能拦截写入 - 用了相对路径或波浪号：
code --install-extension ./python.vsix或~/Downloads/python.vsix均无效，必须用绝对路径（如/home/user/Downloads/python.vsix）
手动解压到 extensions 目录后插件仍不显示
绕过 code 命令直拷文件虽能躲过签名校验，但结构和命名必须严格匹配 VSCode 的加载规则，否则扩展主机启动时直接忽略该目录。
关键检查点：
- 解压后的文件夹名必须是
publishername.extensionname-version格式，例如ms-python.python-2024.6.0；不能是extension-unpacked或其他随意命名 - 该文件夹内必须包含
package.json，且其中main、activationEvents字段存在且路径可读 - 确认目标路径正确：
Windows：%USERPROFILE%\.vscode\extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 重启 VSCode 前，先在终端运行
code --status确保无残留进程；Windows 还需在任务管理器中结束所有Code Helper进程
extensions 目录路径不统一导致脚本失效
硬编码 $HOME/.vscode/extensions 在 WSL、Docker 容器、多用户系统中极易出错——比如 WSL1 默认挂载 /mnt/c/Users/xxx，而 VSCode 实际读取的是 /home/xxx/.vscode/extensions。
真正可靠的解法是不猜路径，改用 VSCode 自身机制驱动：
- 优先走
code --install-extension /abs/path/to/plugin.vsix，它内部会自动定位并写入正确的extensions目录 - 若
code命令不可用，先运行Shell Command: Install 'code' command in PATH（Cmd+Shift+P），再重启终端 - 批量部署时，用
code --list-extensions验证是否已注册，比检查文件夹是否存在更准确
装完插件列表为空，但 extensions 目录里有文件夹
这通常意味着插件已落盘，但扩展主机（Extension Host）在激活阶段崩溃或被禁用——尤其是语言类插件（Python/Go/Rust），它们依赖离线可用的语言服务器（LSP），而 LSP 二进制文件往往不随 .vsix 一起下发。
排查方向：
- 按
Ctrl+Shift+P输入Developer: Toggle Developer Tools，切换到 Console 标签页，筛选ERR或WARN，重点看Activating extension后是否立刻跟failed - 检查插件文档是否要求额外下载 LSP：例如 Python 插件需手动放
pyright或pdm到~/.vscode/extensions/ms-python.python-*/dist - 运行
code --disable-extensions启动，再逐个启用插件，快速定位冲突源 - 别忽略
~/.vscode/extensions下带.incomplete后缀的残留文件夹，它们会阻塞后续安装，直接删掉
code --status 仍可能显示活跃进程，此时新安装会被静默丢弃。
