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

PhpStorm侧边栏里看不到 .git、.env 这类隐藏文件
如果你发现PhpStorm的Project视图里死活找不到.git、.env这类点开头的文件,先别急着怀疑人生。这根本不是系统设置的问题,而是PhpStorm自己“贴心”地帮你过滤掉了。没错,IDE默认就会隐藏以点(.)开头的文件和目录,这属于它的主动行为策略。
想让它们重见天日?关键操作在于调整IDE内部的过滤规则:
- 打开
Settings / Preferences(Windows/Linux按Ctrl+Alt+S,macOS按Cmd+,) - 依次进入
Appearance & Beha vior > System Settings > Project Settings > File Types - 在右侧的“Ignored files and folders”输入框里,找到类似
.*或.git;*.env这样的条目(注意它们是用分号分隔的) - 果断删掉你希望显示的文件对应的条目,然后点击
OK。通常无需重启,侧边栏会立刻刷新。
⚠️ 这里有个细节需要注意:.*是个通配符,意味着它会屏蔽所有点开头的文件。如果你只想显示.env但继续隐藏.DS_Store这类临时文件,那就别一股脑全删,只精准移除你需要的条目即可。
为什么改了设置后还是不显示?检查是否启用了“Tree View”过滤
有时候,明明全局忽略规则已经关了,文件却依然“隐身”。这时候,问题很可能出在Project视图的局部过滤开关上。在侧边栏的右上角,通常有一个小漏斗图标(Filter Options),点开后你会发现,像Show Excluded Files或Hide Ignored Files这类选项可能是默认勾选的——这个开关的优先级,比全局设置还要高。
操作步骤其实很简单:
- 首先确保侧边栏是展开状态(快捷键
Alt+1或Cmd+1) - 在
Project面板右上角找到那个漏斗图标并点击 - 在弹出菜单中,务必取消勾选
Hide ignored files(注意,是“ignored”文件,不是“excluded”文件) - 如果看到
Flatten Packages或Compact Middle Packages这类选项,也建议暂时关闭,它们有时会导致路径显示异常,干扰判断
想永久禁用隐藏逻辑,但又不想影响性能
彻底关闭所有隐藏规则,听起来一劳永逸,但副作用也很明显:侧边栏可能会被各种临时文件、日志、以及像node_modules这样庞大的依赖目录塞满,直接拖慢IDE的响应速度。
更稳妥的策略是进行精准放行:
- 在
File Types > Ignored files and folders设置中,只删除你明确需要访问的条目,例如:.env;.env.local;.gitignore - 对于
node_modules、dist、build、.idea、.DS_Store这些通常无需频繁操作的文件或目录,建议保留在忽略列表里 - 另外,别忘了检查
VCS > Git > Ignore files这里的设置,它只影响Git版本控制操作,不影响侧边栏显示,但容易造成混淆 - 对于使用Composer的PHP项目,
vendor/目录默认不会被忽略,但如果你手动添加过规则,也需要一并核查
完成设置后,在侧边栏空白处点击右键,选择Reload project from disk,可以强制IDE重新加载文件索引,这比重启整个IDE要快得多。
Mac 上 Darcula 主题下文件名变透明?不是隐藏文件问题
这可能是最让人困惑的情况之一:文件明明已经显示在侧边栏了,但文件名却灰得几乎看不见,尤其在Mac系统使用Darcula深色主题时。这其实不是文件被隐藏了,纯粹是颜色渲染出了问题。
解决起来也很直接:
- 进入
Settings > Editor > Color Scheme > File Status - 找到
Ignored或Hidden对应的条目,点击修改其文字颜色(比如调成一个更明显的灰色,如#AAAAAA) - 还有一个更快捷的方法:回到
Color Scheme主页,先切换到Default或High Contrast主题,然后再切回Darcula,有时能自动重置异常的样式 - 所有这些颜色调整都是即时生效的,不需要重启IDE
记住,这是两个独立的问题:文件没出现,是过滤逻辑;文件出现了但看不清,是颜色配置。千万别把它们混为一谈,否则只会越调越乱。
