VSCode文件只读的根本原因是操作系统权限不足，需依次检查文件/目录权限（ls -l确认w位）、父目录可写性、Windows属性/安全设置、状态栏Read Only开关及进程句柄占用，缺一不可。
文件系统权限不足（Linux/macOS/WSL 最常见）
VSCode 不会自己锁文件，它只是忠实地反馈操作系统是否允许写入。运行 ls -l 文件名，看权限位里有没有 w（比如 -rw-r--r-- 中第一个 rw- 表示当前用户可读写）。没有？直接加：
- chmod u+w 文件名
- 如果整个目录下都出问题，改父目录：chmod u+w 目录名
特别注意：父目录不可写 会导致保存失败——VSCode 保存时先写临时文件再 rename 替换，缺父目录写权限就卡住，哪怕文件本身可写。
Windows 文件属性或安全权限被设为只读
右键文件 → “属性” → 取消勾选“只读” → 点“应用”。如果仍不行，点“安全”选项卡 → 选当前用户 → 检查“写入”权限是否被拒绝。常见陷阱：
- Git 克隆下来的文件在某些 Windows 环境下默认带只读属性
- 某些备份/同步工具（如 OneDrive、Dropbox）会临时设只读
- icacls 文件名 /reset 可重置权限继承（需管理员权限）
状态栏 Read Only 按钮被手动启用
这不是配置项，是实时开关。编辑器标签页右侧、状态栏右下角出现锁图标或 Read Only 字样时，直接点击它就能切换回可编辑状态——仅对当前文件生效。这个操作不会写入任何配置，也不会同步到其他设备，所以搜 readonly 在 settings.json 里找不到对应字段。
文件被其他进程占用（Windows 最隐蔽）
Windows 对文件句柄极其严格。哪怕另一个程序只是以只读方式打开过该文件（比如 Excel 预览了 CSV、记事本打开了日志、卡巴斯基正在扫描），VSCode 就无法获得写入句柄。表现是：文件属性明明可写，但 Ctrl+S 弹窗报错。解决方法：
- 打开任务管理器 → “性能”选项卡 → “打开资源监视器” → 切到“CPU”页 → 在“关联的句柄”搜索框输入文件名
- 找到占用进程 → 右键“结束进程”（不是关窗口）
- VSCode 插件也可能占句柄：禁用 GitLens、Prettier 后重启验证
真正麻烦的从来不是“怎么关掉只读”，而是你改完权限或点了按钮，结果发现编辑器还是灰的——这时候得回头再看一遍父目录权限和句柄占用，这两处最容易漏。
