Dev Containers 中隐藏文件由 VSCode 的 files.exclude 设置控制,而非容器或宿主机属性;需在工作区 .vscode/settings.json 中配置,路径相对于容器内挂载的工作区根目录,且修改后须关闭文件夹并执行“Reopen in Container”才能生效。

Dev Containers 里隐藏文件由谁控制?
不是容器系统本身,也不是宿主机的隐藏属性,而是 VSCode 的 files.exclude 设置在起作用。即使你在容器里用 ls -a 能看到 .env 或 .git,只要 VSCode 的 files.exclude 包含 "**/.*": true,这些文件在左侧资源管理器里就永远不会出现——和本地打开项目时表现完全一致。
为什么改了 .devcontainer/devcontainer.json 没用?
因为 devcontainer.json 不处理文件显示逻辑,它只管容器构建、挂载、扩展安装等运行时行为。想控制文件树是否显示点文件、node_modules 等,必须改设置文件:
- 优先编辑
.devcontainer/devcontainer.json同级的.vscode/settings.json(即工作区设置),VSCode 连入容器后会自动加载它 - 如果没这个文件,就手动创建:
.vscode/settings.json,内容至少包含"files.exclude"字段 - 别去改用户级设置(
$HOME/Library/Application Support/Code/User/settings.json等),远程容器窗口不读它
files.exclude 在容器里怎么写才生效?
路径全部相对于容器内挂载后的**工作区根目录**,不是宿主机路径,也不是容器镜像里的原始路径。常见错误写法和对应修正:
-
"./.git": true→ 错误:点开头的相对路径不被支持,应写".git": true(仅匹配根目录)或"**/.git": true(递归匹配) -
"**/node_modules/**": true→ 可用但冗余,"**/node_modules": true就够了;多加/**在files.exclude中反而可能破坏匹配 -
"dist/": true→ 斜杠结尾非必需,"dist": true更稳妥 - 想保留
.env但隐藏其他点文件?不能删整行"**/.*": true,得拆开写:"files.exclude": { "**/.DS_Store": true, "**/.git": true, "**/.*": false }
改完设置为什么资源管理器还是没变?
Dev Containers 场景下,VSCode 不会热重载 files.exclude 变更。必须执行完整刷新流程:
- 关闭当前窗口:
File > Close Folder - 重新连接容器:
Command Palette (Ctrl+Shift+P) > Dev Containers: Reopen in Container - 不要只点
Rebuild Container或Restart Container,那不会刷新文件树缓存 - 如果用了
search.exclude,也得同步检查——它和files.exclude完全独立,漏配会导致文件“看得见但搜不到”
最常被忽略的是:你以为改的是容器内的设置,其实编辑的是宿主机上 .vscode/settings.json 文件;而 VSCode 是把这个文件的内容同步进容器进程里生效的。路径、语法、重载动作,三者缺一不可。


















