离线安装VSCode插件失败主因是权限问题：~/.vscode/extensions目录不可写、code命令无执行权限或Windows UAC拦截，导致静默失败且无明确报错；需检查CLI注册、目录写权限、进程是否彻底退出，并确保.vsix解压后按扩展ID命名复制到正确路径。
离线安装 VSCode 插件失败，八成不是文件下错了，而是权限没到位——~/.vscode/extensions 目录不可写、code 命令没权限执行、或 Windows 下 UAC 拦截了写入，都会导致静默失败，连错误提示都不给。
为什么 code --install-extension 报 “Unable to install extension” 却不报具体原因
这个模糊错误基本锁定在权限链断裂：VSCode 找到了 .vsix，也尝试解压，但卡在往 extensions 目录写文件这一步。它不会告诉你“Permission denied”，只说“Unable to install”。
- 先确认
code命令本身有执行权限：Windows 上运行where code，Linux/macOS 运行which code；若无输出，说明 CLI 未注册，不是插件问题 - 再检查目标 extensions 目录是否可写：
touch ~/.vscode/extensions/test（Linux/macOS）或在该目录里手动新建文件（Windows），失败即为权限不足 - 如果用
--extensions-dir自定义路径，必须确保该路径存在且当前用户有write权限——VSCode 不会自动创建，也不会提醒你缺权限 - WSL 用户特别注意：
/mnt/c/...路径下chmod无效，extensions目录必须放在 WSL 原生路径（如~/vscode-ext）
.vsix 拖进 VSCode 没反应，其实是窗口权限被系统拦截
拖拽安装最省事，但也最依赖 GUI 环境的底层权限。很多“没反应”不是 VSCode 拒绝，是系统直接吞掉了拖放事件。
- VSCode 窗口必须处于焦点状态：点击编辑器空白处，看任务栏图标是否高亮；远程桌面（RDP/TeamViewer）或全屏模式下拖放常被禁用
- 拖的是原生
.vsix文件，不是解压后的文件夹、.zip或杀软重命名的prettier.vsix.bak - 企业策略可能禁用扩展安装：右下角状态栏若显示
Extensions disabled by policy，拖拽必然无效，只能走 CLI - macOS 上若曾以
sudo启动过 VSCode，会导致~/Library/Application Support/Code/Extensions/归属 root，后续普通用户拖拽会静默失败
手动复制 .vsix 到 extensions 目录为何不生效
VSCode 不识别 .vsix 文件本身，只认已解压、且目录名严格匹配扩展 ID 的子文件夹。直接扔进去等于白放。
- 必须先解压：
unzip my-ext.vsix -d unpacked，然后看unpacked/下顶层目录名（如ms-python.python-2024.6.0） - 把这个完整目录（不是里面的内容）复制到你的
extensions路径下；Windows 是%USERPROFILE%\AppData\Roaming\Code\Extensions\，macOS 是$HOME/Library/Application Support/Code/Extensions/ - 复制完必须彻底退出 VSCode：包括托盘进程（Windows 任务管理器查
code.exe，macOS 运行code --status），否则缓存不刷新，新目录不会加载 - 别漏掉权限继承：Windows 下复制后右键目录 → “属性” → “安全” → 确保当前用户有“修改”权限；Linux/macOS 执行
chown -R $USER:$USER ~/.vscode/extensions
真正卡住人的，从来不是“怎么装”，而是装完发现插件列表里没有、点开设置又找不到入口——这时候大概率是 extensions 目录权限错乱，或者 VSCode 进程还挂着旧缓存。重启不是万能的，清缓存+验权限+关干净进程，三步缺一不可。
