先看ls -l文件权限与属主，再ls -ld检查父目录写权限，最后mount | grep确认挂载点是否含metadata；三步可定性是文件、目录还是挂载配置问题。

VSCode 保存失败报 “权限不足” 或进入只读模式，90% 情况不是编辑器坏了，而是你当前用户对目标路径没有写权限——要么文件/目录属主是 root，要么挂载点（如 /mnt/c）没配好 POSIX 权限支持，要么 VSCode 本身被 sudo code 污染过。

怎么一眼判断是文件、目录还是挂载点的问题

别猜，终端里三行命令定性：

• ls -l /path/to/file：看第一列权限（比如 -r--r--r-- 就真没写位），第三列所有者（root？那大概率就是它）
• ls -ld /path/to/file 的父目录：即使文件可写，若目录本身是 dr-xr-xr-x 且你非属主，照样不能覆盖保存（Linux 要求对目录有 w 才能删/重命名/覆盖文件）
• mount | grep $(dirname /path/to/file)：如果路径在 /mnt/c 或网络盘里，重点看输出里有没有 metadata ——没这个选项，chmod 和 chown 在 Windows 文件上基本无效

Linux/WSL 下修复 /mnt/c 类路径的 Permission Denied

Windows 文件被挂进 WSL 后默认不认 chmod，必须启用元数据支持：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 编辑 /etc/wsl.conf，确保包含：

  [automount]
  enabled = true
  options = "metadata,uid=1000,gid=1000,umask=022"

• 改完必须执行 wsl --shutdown，再重新打开 WSL 终端——不重启，配置不生效
• 验证是否生效：touch /mnt/c/test && ls -l /mnt/c/test；如果能看到类似 -rw-rw-rw- 且属主是你，说明成了

为什么 sudo chown -R $USER: . 有时还是不行

常见于以下三种情况：

• 路径在 /proc、/sys、/dev 这类虚拟文件系统里——它们压根不走磁盘权限模型，chown 直接报错或静默失败
• 目录被 noexec、nosuid 或 ro（只读）挂载，mount 输出里能看到这些 flag，得去 /etc/fstab 改挂载参数
• 文件被其他进程锁住（比如另一个 VSCode 窗口、tail -f、IDEA 正在索引），用 lsof +D /path 查，别硬 chmod

VSCode 自身权限污染的清理动作

一旦用过 sudo code .，后续哪怕你关掉终端再开，VSCode 可能仍带着残留上下文：

• 删掉缓存：rm -rf ~/.config/Code/{Cache,CachedData,GPUCache}（Linux/macOS）
• 检查 ps aux | grep code，确认没有 root 用户跑的 code 进程
• 永远改用桌面图标或应用菜单启动 VSCode，而不是从终端输 code ——除非你明确知道当前 shell 是普通用户且没提权

真正容易被忽略的是挂载点元数据和 VSCode 进程继承关系。前者要改配置+重启 WSL，后者要清缓存+换启动方式，两个动作缺一不可。修完别急着写代码，先 echo test > file 验证下底层写入是否通。