PhpStorm侧边栏默认隐藏.git、.env等点开头文件,需在Settings→File Types→Ignored files中删除对应条目,并关闭Project视图右上角“Hide ignored files”过滤,必要时调整Color Scheme中Hidden文件文字颜色。

PhpStorm侧边栏里看不到 .git、.env 这类隐藏文件
默认情况下,PhpStorm 的 Project 视图会过滤掉以点(.)开头的文件和目录,这不是 bug,而是 IDE 的主动隐藏策略。它基于操作系统级“隐藏文件”概念做了映射,但实际行为由 IDE 自己控制,和系统设置无关。
要让它们显示出来,关键不是改系统设置,而是调整 PhpStorm 的文件过滤规则:
- 打开
Settings / Preferences(Windows/Linux 用Ctrl+Alt+S,macOS 用Cmd+,) - 进入
Appearance & Behavior > System Settings > Project Settings > File Types - 在右侧 “Ignored files and folders” 输入框中,删掉类似
.*或.git;*.env这样的条目(注意分号分隔) - 点击
OK,无需重启,侧边栏会立即刷新
⚠️ 注意:.* 是通配符,会屏蔽所有点开头的文件;如果只想隐藏部分(比如不要 .DS_Store 但要 .env),就只删掉对应项,别全清。
为什么改了设置后还是不显示?检查是否启用了“Tree View”过滤
即使关掉了全局忽略规则,Project 视图右上角可能有个小漏斗图标(Filter Options),点开后常默认勾选了 Show Excluded Files 或 Hide Ignored Files —— 这个开关是独立于全局设置的,优先级更高。
立即学习“PHP免费学习笔记(深入)”;
操作步骤:
- 确保侧边栏已展开(用
Alt+1或Cmd+1) - 在
Project面板右上角找到漏斗图标,点击它 - 取消勾选
Hide ignored files(不是“excluded”,是“ignored”) - 如果看到
Flatten Packages或Compact Middle Packages,也建议暂时关掉,避免路径折叠导致误判
想永久禁用隐藏逻辑,但又不想影响性能
完全关闭隐藏逻辑(比如删光所有 ignore 规则)可能导致侧边栏塞满临时文件、日志、node_modules 子项等,拖慢响应。更稳妥的做法是精准放行:
- 在
File Types > Ignored files and folders中,只删除你明确需要的项,例如:.env;.env.local;.gitignore - 保留
node_modules;dist;build;.idea;.DS_Store等真正无用的条目 - 对 Git 相关文件,确认
VCS > Git > Ignore files设置没重复屏蔽(这里只影响 Git 操作,不影响侧边栏显示) - 如果项目用了 Composer,
vendor/默认不会被忽略,但若手动加过 ignore 规则,也要一并检查
改完后,右键侧边栏空白处选 Reload project from disk 能强制重载文件索引,比重启快得多。
Mac 上 Darcula 主题下文件名变透明?不是隐藏文件问题
这是另一个高频干扰项:当你把主题设为 Darcula,又没同步设置编辑器字体颜色或侧边栏背景,会导致 .xxx 类文件名文字灰得几乎看不见,看起来像“没显示”,其实是渲染问题。
解决方式很直接:
- 进
Settings > Editor > Color Scheme > File Status - 找到
Ignored或Hidden对应的行,点开修改文字颜色(比如调成#AAAAAA) - 或者更省事:回到
Color Scheme主页,换回Default或High Contrast主题再切回来,有时能重置异常样式 - 不需要重启 IDE,改完立刻生效
这个现象和“是否显示隐藏文件”是两套机制,别混着调 —— 文件没出现是过滤逻辑问题,文件出现了但看不清是颜色配置问题。


















