webstorm 默认隐藏 .git 文件夹是因将其硬编码进“ignore files and folders”列表,只需在 settings/preferences → editor → file types 中删除 .git 条目即可显示,无需重启,且不影响 git 命令行功能。

WebStorm 默认会隐藏 .git 文件夹,这不是 Git 本身的问题,而是 IDE 的文件过滤策略在起作用 —— 只需关闭对应过滤规则即可立刻显示。
为什么 WebStorm 里看不到 .git 文件夹
WebStorm 把以点(.)开头的目录默认归类为“应忽略的系统/元数据文件”,统一列在 Ignore files and folders 设置里。它不修改磁盘上的隐藏属性,只是 IDE 内部不渲染、不索引、不显示这些条目。
-
.git被硬编码进默认忽略列表(和.idea、.DS_Store等一起) - 即使你在系统级已开启“显示隐藏文件”,WebStorm 仍按自己规则过滤
- 该设置不影响 Git 命令行操作,
git status等一切照常工作
关闭 .git 忽略的实操步骤
路径和操作在所有主流版本(2020.1–2026.x)中一致,Mac 和 Windows 仅菜单入口略有差异:
- 打开
Preferences(macOS)或Settings(Windows/Linux) - 进入
Editor > File Types - 在右侧
Ignore files and folders输入框中,找到并删掉.git(注意保留前后逗号分隔,例如把.git,.idea改成.idea) - 点击
Apply或OK,无需重启,项目视图立即刷新
常见误操作和副作用
改错地方或改过头,容易引发其他问题:
- 别去改
Appearance > System Settings > Show hidden files—— 这个开关只影响系统级文件选择器,对项目树无效 - 不要手动删掉整个
Ignore files and folders内容,否则.DS_Store、node_modules等也会意外显示,拖慢索引 - 如果删掉
.git后仍不显示,检查是否启用了Hide ignored files(右键项目根目录 →Reload project from disk有时可触发重载) - 团队协作时,这个设置不共享 —— 每人本地独立配置,不影响
.gitignore行为
真正要注意的是:显示 .git 文件夹后,别误删或误编辑里面的内容;WebStorm 虽然能展开它,但内部对象(如 objects/ 下的二进制 blob)并不适合手动干预。











