答案是右键点击Project标签页取消勾选Compact View。Compact Mode会隐藏文件名只留图标;高DPI缩放或字体设置不当会导致文字被裁切;.idea目录损坏或插件/主题冲突也可能引发该问题。

Project 视图被设为 Compact Mode 导致只显示图标
WebStorm 的 Project 左侧栏默认会显示文件名,但如果意外切换到紧凑模式(Compact Mode),就会隐藏文字、只留图标。这不是崩溃或配置损坏,而是视图模式被手动改了。
解决方法很简单:
- 右键点击 Project 标签页(即左侧栏顶部写着
Project的那个区域) - 在弹出菜单中取消勾选
Compact View - 如果已勾选,取消后文件名立刻恢复显示
字体缩放或 UI 缩放设置干扰了文字渲染
某些高 DPI 屏幕或系统级缩放设置(比如 Windows 设置为 125% / 150%)会让 WebStorm 的 UI 元素挤压,导致文件名被截断或完全不渲染,看起来像“只有图标”。这不是隐藏,是文字被裁掉了。
检查并调整:
- 进入
Help → Find Action(快捷键Ctrl+Shift+A/Cmd+Shift+A) - 输入
Appearance,打开Settings → Appearance - 检查
UI Options → Use custom font是否开启;若开启,确认字号 ≥ 12 - 更关键的是:关闭
Override default fonts by(如有启用),或把该值调高至14或以上再重启
.idea 目录损坏导致 Project 视图异常初始化
虽然更常见的是整个目录消失,但部分损坏的 .idea 配置(尤其是 .idea/workspace.xml 中关于 projectView 的状态)也可能让 Project 视图加载时跳过文本渲染逻辑,只画图标占位符。
验证和修复步骤:
- 完全退出 WebStorm(确保进程结束,macOS 注意菜单栏残留图标)
- 进入项目根目录,删除整个
.idea文件夹(不是隐藏它,是彻底删除) - 重新用 WebStorm 打开该项目(不要用 “Open Recent”,要从文件系统路径重开)
- 首次加载会重建
.idea,Project 视图恢复默认行为
插件冲突或 UI 主题覆盖了文件名样式
少数第三方主题(如某些 Darcula 变体)或 UI 插件(例如 Material Theme UI 的旧版本)会强制重写 TreeCellRenderer 样式,导致文字颜色透明、字号为 0 或 foreground 被设为背景色——结果就是“看得见图标,看不见字”。
临时排查方式:
- 启动 WebStorm 时按住
Shift键(Windows/Linux)或Cmd(macOS),直到出现 “Safe Mode” 提示 - 选择以安全模式启动(禁用所有第三方插件)
- 观察 Project 栏是否恢复正常显示
- 若恢复,说明是某个插件问题;可逐个启用插件定位,重点检查 UI 相关插件
Compact View 开关和 .idea/workspace.xml 里的视图元数据是两个最常被忽略的修改点。别急着删配置,先右键看一眼菜单里有没有勾选 Compact View——90% 的“只显图标”问题,就卡在这一步。


















