VSCode没有“只读编辑器标签”独立概念,其只读表现源于文件系统权限或files.readonly+glob匹配的编辑器行为控制;需设files.readonly匹配路径、禁用files.saveWithoutWatching、配合Keep Open锁定标签,并辅以系统级只读权限才能真正防误改。

VSCode 里没有“只读编辑器标签”这个独立概念,所谓只读表现,全是文件系统权限或编辑器行为控制的副产品。你看到的锁图标、灰色保存按钮、无法 Ctrl+S,都不是标签本身的属性,而是 VSCode 对当前文件可写状态的实时反馈。
怎么让特定文件打开时自动显示为只读标签
靠 files.readonly 配合 glob 模式匹配路径,这是最常用也最可控的方式:
- 在工作区
.vscode/settings.json中添加规则,例如:"files.readonly": ["**/tsconfig.json", "**/.env*", "**/README.md"]
- 路径必须用双星号
**表示递归匹配,单星号*只匹配当前目录层级 - 该设置只影响“保存”行为(禁用 Ctrl+S、右键 Save),但不阻止你在编辑器里打字或删改——它不是真锁,只是拦截保存入口
- 已打开的文件不会立即响应变更,需执行
Ctrl+Shift+P→Developer: Reload Window才生效
为什么右下角显示 Read-only 却还能编辑、还能 Ctrl+S 弹窗
说明只读机制没真正生效,常见原因有三个:
-
files.saveWithoutWatching默认为true,它会绕过files.readonly检查直接尝试写入——必须手动设为false - 文件本身系统权限仍可写(如
chmod 644),VSCode 会优先信任 OS 权限,忽略编辑器级只读规则 - 你正在编辑的是未保存的临时文件(
document.isUntitled === true),这类文件不受files.readonly约束
怎么防止只读文件被新文件覆盖掉标签
只读文件一旦被预览模式顶掉,就失去所有上下文。关键不是锁文件,而是锁标签生命周期:
- 右键该标签页 → 选
Keep Open(图钉图标),这样从大纲、搜索结果等跳转都不会替换它 - 快捷键更高效:
Ctrl+K Enter(Win/Linux)或Cmd+K Enter(macOS) - 如果想全局禁用预览覆盖,关掉
workbench.editor.enablePreview,但会牺牲快速浏览小文件的体验 -
Keep Open不跨窗口、不跨远程开发会话,断开重连后需重新操作
真正难防的从来不是误保存,而是误关闭或误覆盖——系统级只读(chmod 444 或 Windows 属性勾选)能阻止写入,但拦不住标签被顶;Keep Open 能守住标签,但拦不住你手抖点错。两者得一起用,缺一不可。











