新建文件无法保存主因是路径权限或挂载配置问题。需检查工作区目录可写性、WSL的DrivFS metadata选项、格式化扩展冲突及外部文件修改导致的保存冲突。
新建文件无法保存，90% 是路径权限或挂载配置问题，不是 VSCode 坏了。直接看终端报错和文件系统状态，别在编辑器里反复点保存。
新建文件保存失败时，先确认文件路径是否可写
VSCode 新建的临时文件（比如未命名的 Untitled-1）默认会尝试保存到当前工作区根目录。如果该目录本身不可写，保存必然失败——哪怕你只是点“另存为”，底层仍会先尝试写入临时位置。
- Linux/macOS：运行
ls -ld /path/to/workspace，检查输出中是否有w（写）位，第三列属主是否为你当前用户 - Windows：右键工作区文件夹 →「属性」→「安全」→ 确认你的账户有「完全控制」权限；若「安全」选项卡不可见，先取消勾选「只读」，再进「高级」启用权限继承
- 特别注意：
/mnt/c、\wsl$、OneDrive 同步目录、C:Program Files这类路径默认不支持 POSIX 写权限，新建文件极易失败
WSL 下新建文件保存不了，大概率是 DrivFS 元数据没开
在 WSL 中通过 Windows 端 VSCode 打开 /mnt/c/project 并新建文件，保存失败几乎必然是因为 DrivFS 挂载时没启用 metadata 选项——它让 chmod/chown 生效，否则新建文件属主永远是 root，权限永远是 -r--r--r--。
- 检查配置：打开
/etc/wsl.conf，确认包含：[automount] enabled = true options = "metadata,uid=1000,gid=1000,umask=022"
- 必须执行
wsl --shutdown，再重新打开 WSL 终端，否则配置不加载 - 验证是否生效：在
/mnt/c下运行touch test && ls -l test，看到属主是你且权限含w才算成功
新建文件卡在“正在保存”或提示“未能保存”，重点查格式化扩展
新建文件首次保存时，VSCode 会触发 onWillSaveTextDocument 钩子，Prettier、ESLint、Python 扩展可能介入。一旦它们配置错误或 CLI 不可用，保存就会卡住或静默失败。
- 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），切到 Console，再试保存，看有没有spawn ENOENT或 Promise pending 报错 - 临时禁用所有扩展（
Extensions: Disable All Installed Extensions），再逐个启用，尤其盯prettier、eslint、python这几个 - 快速绕过：把
editor.codeActionsOnSave设为空对象{}，或至少关掉"source.fixAll"和"source.organizeImports"
新建文件提示“文件内容较新”，其实是外部修改冲突
VSCode 新建一个空文件，还没保存，这时你用其他程序（比如记事本、Git Bash 的 echo）往同名路径写了一次，VSCode 就会认为“磁盘版本更新”，拒绝覆盖——它不是权限问题，而是保护机制。
- 报错典型提示：
Unable to save 'xxx': The content of the file is newer. - 解决方法：命令面板运行
Files: Save Conflict Resolution，选overwriteFileOnDisk - 更稳妥做法：避免在 VSCode 外部操作同一文件；如需协同，统一用 Git 或共享存储同步，而非手动改磁盘文件
真正容易被忽略的是：新建文件的保存路径由当前工作区决定，而工作区权限、挂载元数据、扩展钩子三者只要一个出问题，就卡死。修的时候别只盯着 VSCode 设置，得从文件系统层开始往下捋。
