WebStorm项目树默认不显示文件扩展名,因设计上优先展示语义化名称;仅Editor→Tabs中的Show file extension选项控制顶部标签页后缀显示,对左侧项目栏无效;项目树中显示完整扩展名需新建或重命名时手动输入全名(如utils.ts)并确保扩展名已注册。

WebStorm 默认不显示文件扩展名,但可以强制开启——关键在于 Editor Tabs 设置页里的 Show file extension 选项,不是在项目工具窗口(Project Tool Window)里改。
为什么项目树里看不到 .js/.ts 后缀?
因为 WebStorm 的项目工具窗口默认隐藏扩展名,只靠图标和颜色区分类型。它优先展示“语义化名称”,比如把 index.js 显示为 index,哪怕你右键重命名时输的是完整名字,显示层仍会剥离后缀。
- 这不是 bug,是设计行为,且无法通过“文件类型关联”或“外观设置”关闭/开启
-
Settings → Editor → File Types只影响语法高亮和识别逻辑,不影响显示 - 操作系统级文件管理器的“显示扩展名”开关对 WebStorm 项目树完全无效
怎么让左边项目栏显示扩展名?
目前没有官方支持的全局开关让 Project 工具窗口显示扩展名。但有三个实际可用路径:
- 右键文件 →
Rename,手动在名字末尾加上.js等后缀(WebStorm 会保留它,且后续重命名时不会自动删掉) - 新建文件时,直接输入完整名称,例如
utils.ts而非utils;只要扩展名已注册(如.ts),它就会以完整形式出现在项目树中 - 使用
Ctrl+Shift+A搜索 “Show file extension”,确认它只存在于Editor → Tabs设置中——这个选项只控制顶部编辑器标签页是否显示后缀,对左侧项目栏无效
Editor Tabs 的 Show file extension 有什么用?
它只影响顶部打开的文件标签页(tab),比如你开了 5 个文件,每个 tab 标题上是否显示 .vue、.jsx 这类后缀。开启后,App 变成 App.jsx,方便快速区分同名不同类型的文件。
- 路径:
Settings → Editor → Tabs → Show file extension - 勾选后需重启标签页(关掉再打开)才生效,已打开的 tab 不会实时刷新
- 该设置与项目树无关,很多人误以为开了它就能让左边也显示,结果白调半天
真正想在项目树里一眼看清扩展名,唯一稳定办法就是:新建/重命名时坚持写全后缀,并确保该后缀已注册为有效文件类型(比如 .md 默认支持,.env.local 就需要手动关联)。WebStorm 不会主动“补全”或“还原”你省略的扩展名,它只忠实地渲染你输入的内容。


















