files.exclude仅控制资源管理器显示,不处理只读状态;要同时隐藏且禁编辑,需组合配置:files.readonly指定路径为只读,files.exclude将其从侧边栏剔除。

files.exclude 不能隐藏“只读文件”,它只管显示逻辑
VSCode 里所谓“受保护且无法编辑的文件”,通常指系统级只读(如 chmod 444 或 Windows 属性勾选“只读”)或编辑器级标记为只读(通过 files.readonly 配置)。但注意:files.exclude 对这两类文件完全无效——它只决定资源管理器是否渲染路径,不感知文件权限或编辑状态。
如果你发现某个文件明明是只读、却还“刺眼地挂在侧边栏”,那不是它没被保护,而是你误用了 files.exclude 去处理本该由权限或 files.readonly 管理的场景。
-
files.exclude的作用对象是路径(如"**/.env"),不是文件属性 - 系统只读文件仍会出现在资源管理器、
Ctrl+P、甚至搜索结果中(除非同时配了search.exclude) - 编辑器级只读(
files.readonly)不会让文件消失,只会禁用保存按钮、灰掉右下角状态,并在尝试保存时弹出提示
想让只读文件“视觉上消失”,得组合配置
真正让一个受保护文件既不可编辑、又不在侧边栏出现,需要两步:先用 files.readonly 锁住编辑行为,再用 files.exclude 把它从资源管理器剔除。两者独立生效,缺一不可。
- 在项目根目录的
.vscode/settings.json中写入:
{
"files.readonly": ["**/config.local.js", "**/.env.production"],
"files.exclude": {
"**/config.local.js": true,
"**/.env.production": true
}
}
-
files.readonly是字符串数组,支持 glob;files.exclude是键值对,键也是 glob 模式 - 两个配置都必须用
**/开头,否则只匹配根目录下的同名文件 - 如果文件已打开,改完需执行
Developer: Reload Window才能刷新只读状态
常见错误:把 files.readonly 当成 files.exclude 用
有人在设置里加了 "files.readonly": ["node_modules"],结果发现 node_modules 还在侧边栏——这很正常,因为 files.readonly 根本不控制显示。更糟的是,这种写法还会导致 VSCode 在打开 node_modules 下任意文件时都报“只读”,干扰正常调试。
- 正确做法:隐藏
node_modules只用"files.exclude": {"**/node_modules": true} -
files.readonly应只用于明确要“防误改”的配置类文件,比如tsconfig.json、.prettierrc、package-lock.json - 别对整个目录设
files.readonly,它会对该目录下所有匹配文件强制只读,包括你可能想临时编辑的子文件
系统级只读文件的隐藏更简单,但也更危险
如果你用 chmod 444 .env 或 Windows 属性设了只读,VSCode 会自动识别并显示“Read-only”状态,但资源管理器照常列出。此时若想隐藏,仍得靠 files.exclude;不过要注意:
- 系统只读 +
files.exclude组合后,该路径彻底不可见、不可通过Ctrl+P打开、也不参与搜索——比编辑器级只读更“干净” - 但这也意味着你失去了快速访问它的能力。一旦真需要编辑,得先删掉
files.exclude规则、重载窗口、再手动改权限,流程冗长 - 团队协作时,系统权限不随 Git 提交,而
files.exclude是工作区配置,容易同步;所以优先用files.readonly+files.exclude组合,而非依赖系统权限
真正难处理的是那些“本该只读、但又偶尔需要临时放开”的文件——它们不适合硬编码进 files.exclude,也不宜长期锁死系统权限。这种边界情况,得靠人盯住,而不是指望配置自动兜底。











