插件安装失败首要排查 ~/.vscode/extensions 目录权限，因绝大多数失败源于该目录不可写；需确认 Linux/macOS 下属主为当前用户且权限为 drwxr-xr-x，Windows 下用户具备“修改”和“写入”权限，并避免使用系统保护路径或 WSL 挂载点等权限受限位置。
插件安装失败：先查 ~/.vscode/extensions 目录权限
绝大多数插件安装失败，根本不是网络或 Marketplace 问题，而是 ~/.vscode/extensions 目录不可写。VSCode 默认把所有插件解压到这个路径，如果当前用户没有 write 权限，code --install-extension 或 UI 点击安装都会静默失败，甚至不报错。
常见现象包括：Extension 'ms-python.python' not found（实际已下载但解压失败）、安装后重启消失、更新卡在“Installing…”状态。
- Linux/macOS：运行
ls -ld ~/.vscode/extensions，确认输出中包含drwxr-xr-x且属主是你自己（不是root） - Windows：右键该目录 → “属性” → “安全”选项卡 → 检查你的用户账户是否有“修改”和“写入”权限
- 若属主错误（比如是
root），执行sudo chown -R $USER:$USER ~/.vscode/extensions（Linux/macOS）或用管理员权限重置 ACL（Windows）
自定义插件路径时，--extensions-dir 必须指向可写目录
用 code --extensions-dir /path/to/dir 切换插件位置很常见，但很多人忽略一个关键点：VSCode 不会自动创建该目录，也不会校验写权限。如果路径不存在或不可写，插件安装会直接失败，且错误提示极其模糊（常显示“Unable to install extension”）。
正确做法是手动确保路径存在且权限到位：
- 先执行
mkdir -p /path/to/dir（Linux/macOS）或mkdir /path/to/dir（Windows PowerShell） - 再运行
chmod 755 /path/to/dir（Linux/macOS）或右键设置“完全控制”（Windows） - 验证：用
touch /path/to/dir/test或新建空文件测试是否可写 - 注意：不要用系统保护路径（如
/usr/local、C:\Program Files），即使加了--extensions-dir，UAC/SELinux 仍可能拦截
WSL 下插件路径挂载在 /mnt/c 时权限失效
在 WSL 中打开 Windows 路径（如 /mnt/c/Users/name/project）作为工作区，并启用依赖文件系统监听的插件（如 ESLint、Prettier），常出现“Permission denied”或插件不响应。这不是 VSCode 的 bug，而是 WSL 对 Windows 挂载点的默认权限模型不支持 Linux-style inotify 和执行位。
核心问题在于：/mnt/c 下的文件没有真正的 UID/GID 和 metadata 支持，导致插件无法读取或监听变更。
- 临时方案：把项目移到 WSL 原生路径（如
~/project），插件行为立即正常 - 长期方案：编辑
/etc/wsl.conf，添加[automount]区块并启用metadata：[automount] enabled = true options = "metadata,uid=1000,gid=1000,umask=22"
- 改完必须执行
wsl --shutdown再重启，否则配置不生效
插件读写项目内文件失败：检查工作区目录所有权
有些插件（如 Live Server、Auto Rename Tag）需要在项目目录下创建临时文件、写入缓存或修改 .vscode/ 子目录。如果整个工作区目录由 root 或其他用户创建（例如用 sudo npm create vite@latest），当前用户就无权操作。
典型错误信息：EACCES: permission denied, mkdir '/path/to/project/.vscode' 或终端报错 EPERM: operation not permitted。
- 先确认项目根目录归属：
ls -ld /path/to/project - 若属主不是你，运行
sudo chown -R $USER:$USER /path/to/project（Linux/macOS） - Windows 用户注意：避免在
C:\Windows、C:\Program Files等系统目录下开项目；WSL 用户避免在/mnt/c/Windows下开项目 - CI/CD 或容器场景：确保容器内运行 VSCode Server 的 UID 与宿主机挂载目录 UID 一致
最易被忽略的一点：插件路径权限问题往往不是单一目录的问题，而是多个层级权限叠加失效——比如 ~/.vscode 可写，但 ~/.vscode/extensions 不可写；或者自定义路径存在，但其父目录（如 /data）不可遍历。排查时务必逐级 ls -ld 或属性检查，而不是只盯着最后一级。
