答案是右键点击Project标签页取消勾选Compact View。Compact View模式会隐藏文件名只留图标,非插件或主题问题,关闭后即恢复显示。

WebStorm 左侧栏不显示文件夹名只留图标?先确认是不是 Compact View
这不是插件风格,是视图模式被误启用了。WebStorm 的 Project 工具窗口顶部右键菜单里有个 Compact View 选项,一旦勾选,就会隐藏所有文件/文件夹名称,只保留类型图标(如 src 显示一个文件夹小图标,但没文字)。这不是插件效果,也不是主题问题,关掉就行。
操作路径:右键点击左侧栏顶部写着 Project 的标签区域 → 取消勾选 Compact View → 文件名立刻恢复显示。
常见诱因包括:误按 Ctrl+Shift+A 搜 “compact” 后回车、高 DPI 缩放下 UI 渲染异常、或某些旧版 Material Theme 插件自动启用该模式。
想改左侧栏里「文件类型」的图标?装 Atom Material Icons 插件
WebStorm 原生只提供基础文件图标(如 .js 是个 JS 字母,.ts 是个 TS 字母),要换成更现代、带颜色/轮廓的插件风格图标,得靠第三方插件。目前最稳定、适配新 UI 的是 Atom Material Icons。
安装后无需额外配置,重启即生效。它会替换 Project 视图和编辑器 Tab 中所有文件类型的图标,比如 package.json 显示齿轮、vue 显示 Vue 彩色徽标、md 显示 Markdown 标志等。
注意点:
- 不要同时启用多个图标插件(如
Material Theme UI自带图标功能),容易冲突导致图标消失或错位 - 插件仅影响文件图标,不影响项目根目录旁那个灰色文件夹图标(那个真不能换)
- 如果更新 WebStorm 后图标失效,进
Settings | Plugins点击插件右侧的Reload plugin按钮即可
为什么项目根目录旁的灰色文件夹图标始终换不了?
这个图标由 WebStorm 内部硬编码渲染,取决于项目类型识别结果(是否为 Git 仓库、是否有 package.json、是否被标记为 Sources Root 等),但不暴露任何配置入口。你改 .idea/workspace.xml、删 .idea、甚至重装 IDE,它都还是那个灰色文件夹。
官方从未提供类似 project.icon 的设置项,社区插件也无权覆盖这一层级的渲染逻辑。所谓“换图标”,实际能动的只有三处:
- 编辑器 Tab 标签页左侧的文件类型图标(
Atom Material Icons管这个) - 工具栏按钮图标(
Settings | Appearance & Behavior | Menus and Toolbars里可上传 PNG) - 操作系统级快捷方式图标(Windows 快捷方式属性 → 更改图标;macOS 用
SetFile -a C命令)
别在 .idea 配置里浪费时间找不存在的字段。
改完图标后发现文字被裁切或看不见?检查字体缩放和 UI 主题
启用图标插件后,若 Project 栏文字变模糊、被截断、或干脆透明,大概率是 UI 缩放或主题样式冲突。特别是开启 Use custom font 但字号设得太小(如 10),或使用了非 JetBrains 官方推荐字体(如某些中文字体在 Linux 下渲染异常)。
快速排查步骤:
- 进
Settings | Appearance & Behavior | Appearance,关闭Use custom font,让 IDE 回退到默认 Inter 字体 - 若必须自定义字体,字号至少设为
12,并禁用Enable font ligatures(某些连字字体与图标插件不兼容) - 临时以安全模式启动(启动时按住
Shift/Cmd),若此时图标+文字都正常,说明是某个插件干扰了 TreeCellRenderer 样式
真正稳定的组合是:官方 Darcula 或 Light UI 主题 + Atom Material Icons 插件 + 默认 Inter 字体。其他搭配容易出不可预测的渲染问题。


















