VSCode离线安装失败90%因用户权限异常导致静默拒绝，核心是~/.vscode/extensions目录不可写或VSCode进程无对应用户上下文；需修复目录权限、确保进程以正确用户运行，并可临时禁用签名验证。
VSCode 离线安装失败，90% 是用户权限异常导致的静默拒绝，不是 .vsix 文件损坏或版本不兼容——关键在于 .vscode/extensions 目录不可写，或 VSCode 进程没拿到对应用户的文件系统上下文。
为什么 Install from VSIX 会一闪而过、无报错、也不进列表
这不是 UI 卡顿，而是底层解压和写入被操作系统拦截。VSCode 执行离线安装时，会：
- 解压 .vsix（本质是 zip）到
~/.vscode/extensions/下新建子目录 - 在
~/.vscode/extensions/extensions.json中追加一条记录 - 触发 extension host 重新加载该插件
只要第一步 mkdir 失败，后续全跳过，且默认不弹详细错误（除非开开发者工具看 console）。常见现象包括：
- 拖入 .vsix 后进度条闪一下就消失
-
extensions.json文件时间戳没更新 -
ls -la ~/.vscode/extensions/显示 Permission denied（Linux/macOS），或 Windows 下提示“拒绝访问”但没指明路径
检查并修复 ~/.vscode/extensions 目录权限
这个目录必须对当前登录用户有完整读写权限。Windows 和类 Unix 系统处理方式不同：
- Windows：打开 PowerShell，运行
icacls "%USERPROFILE%\.vscode\extensions" /grant "%USERNAME%:(OI)(CI)F"（递归赋予完全控制） - macOS/Linux：终端执行
chmod -R u+rw ~/.vscode/extensions；若仍报错，先确认父目录权限：ls -ld ~/.vscode，必要时补上chmod u+rx ~/.vscode - 别用
sudo chown -R $USER ~/.vscode暴力重置——可能覆盖掉某些扩展依赖的 uid/gid，尤其当之前用 sudo 启动过 VSCode
避免 VSCode 进程以错误用户上下文启动
即使目录权限正确，如果 VSCode 本身是以管理员/其他用户身份运行的，它写入的文件 owner 会变成那个用户，下次普通用户启动时就无法覆盖。
- Windows：右键 VSCode 快捷方式 → “属性” → “兼容性” → 取消勾选“以管理员身份运行此程序”
- macOS：不要用
sudo code .启动；检查 Dock 中图标是否来自/Applications/Visual Studio Code.app而非终端临时拉起的进程 - Linux：确保桌面环境（GNOME/KDE）启动的是用户级 desktop 文件，而非 root 的
code --user-data-dir命令残留
验证方法：启动 VSCode 后，在命令面板（Ctrl+Shift+P）运行 Developer: Toggle Developer Tools，切换到 Console 标签页，输入 process.env.USER（Linux/macOS）或 process.env.USERNAME（Windows），确认输出与你当前登录用户名一致。
绕过签名校验干扰（仅限可信 .vsix）
VSCode 1.85+ 默认强制校验 .vsix 签名，离线环境下若证书链缺失或时间不同步，会导致安装直接终止，连目录写入都不尝试。
- 临时关闭：在
settings.json中添加"extensions.installVerification": false - 注意：该设置仅影响本地 .vsix 安装，不影响在线市场行为；验证通过后建议改回
true - 不要同时设
"extensions.autoUpdate": false来“配合”——它只控制自动更新，跟离线安装无关
真正容易被忽略的是：即使你断网启动 VSCode，只要之前连过网，它仍可能缓存了旧的 marketplace 元数据并尝试校验签名。最干净的做法是，在断网状态下，首次启动 VSCode 后立刻安装 .vsix，不要先打开任何远程窗口或设置页。
