插件安装失败主因是权限、路径或缓存问题：macos/linux需修复~/.vscode归属并避免sudo启动；windows需规避中文/空格路径；临时目录不可写或杀软拦截亦会导致静默失败。
插件安装失败提示“EACCES: permission denied”
这是 macOS 或 Linux 下最常见的权限问题，VSCode 尝试往 ~/.vscode/extensions/ 写入文件时被系统阻止，本质不是 VSCode 本身没权限，而是你当前用户对目标目录的父级路径（比如 /usr/local/bin/code 启动时继承的环境）缺乏写权限。
不要用 sudo code 启动来绕过——这会导致后续所有插件都以 root 身份安装，引发更严重的权限混乱和更新失败。
- 检查实际扩展目录归属：
ls -ld ~/.vscode/extensions，如果显示属主是root，说明之前误用过 sudo，需修复：sudo chown -R $USER:$GROUPS ~/.vscode - 确保 VSCode 是从普通用户身份启动：关闭所有实例，用 Dock 或
code命令（而非sudo code）重新打开 - 若使用 Homebrew 安装的 VSCode，确认
code命令软链未指向 root 权限路径：which code→ls -l $(which code)
插件安装卡在“Installing…”或报“ENOENT: no such file or directory”
这类错误往往不是网络问题，而是 VSCode 找不到正确的扩展缓存或临时解压路径，尤其在自定义了 extensionsInstallPath 或使用符号链接目录时容易触发。
VSCode 默认把下载的 .vsix 包先解压到一个临时子目录再移动到 extensions 目录，如果该临时路径不可写或被杀毒软件拦截，就会静默失败。
- 手动清理临时扩展缓存：
rm -rf ~/.vscode/.extensions-tmp（路径可能因版本略有差异，可查code --status输出里的 “Extensions path”） - 禁用第三方安全软件的实时扫描，特别是针对
~/.vscode/的写入拦截 - 避免将
extensionsInstallPath设为跨文件系统路径（如挂载的 NTFS 分区），某些系统不支持原子重命名操作
Windows 上插件安装失败并提示“Access is denied”或路径含中文/空格
Windows 版 VSCode 对路径中包含空格、括号、中文字符特别敏感，尤其是当用户目录名含中文（如 C:Users张三）或 VSCode 安装在带空格路径（如 C:Program FilesMicrosoft VS Code）时，部分插件的 postinstall 脚本会因 cmd/powershell 解析失败而中断。
这不是插件作者的问题，而是 Node.js 子进程调用时未正确转义参数导致的。
- 把 VSCode 安装到无空格、纯英文路径，例如：
C: scode - 修改用户环境变量
USERPROFILE指向英文路径（不推荐改注册表，风险高），更稳妥的是新建一个英文用户名账户用于开发 - 在 VSCode 设置中显式指定扩展路径为短路径：
"extensions.installPath": "C:\vscode-exts"，并确保该目录存在且当前用户有完全控制权限
插件安装后不生效或反复提示“Reload Required”但重载无效
这通常意味着插件已写入磁盘，但 VSCode 进程未能正确加载其 package.json 或入口模块，常见于扩展目录权限异常、文件损坏或 VSCode 缓存未刷新。
别急着卸载重装，先确认是否真没加载：打开命令面板（Ctrl+Shift+P），输入 Developer: Show Running Extensions，看目标插件状态是否为 “not activated” 或报错。
- 强制重建扩展索引：
Developer: Rebuild Extension Index（需重启 VSCode 生效） - 检查插件目录下是否存在
package.json和extension.js（或extension.ts编译后产物），缺失说明解压过程被中断 - 临时禁用所有其他插件，排除兼容性冲突；再逐个启用，观察是否某插件干扰了 extension host 进程
最麻烦的情况是多个因素叠加：比如 macOS 用户用 brew 安装了 VSCode，又手动改过 extensionsInstallPath，还开了 Time Machine 备份，结果某个备份进程锁住了 .vscode/extensions 目录。这种时候得一层层验证路径权限、进程占用、磁盘只读状态——别跳步骤，顺序错了反而更难定位。
