PhpStorm怎么让同名但不同后缀的文件折叠在一起_文件树视图优化设置【进阶】

很多 PhpStorm 用户在管理项目文件时都会遇到一个挺让人挠头的问题：明明 UserService.php 和 UserServiceTest.php 就是同一套业务的不同侧面，可编辑器里它们就是各占一行，没法自动收进同一个折叠节点。其实 PhpStorm 压根没有“同名自动折叠”这个内置机制——你看到的那个能把小文件收起来的操作，全靠一个叫「文件分组（Group Files by Name）」的功能撑场面。它本质是按文件主名称做视觉聚类，不是代码折叠（Code Folding）那一套，跟编辑器里按 Ctrl + - 收索代码完全是两码事。

PhpStorm 文件树里同名不同后缀的文件不自动分组？这不是折叠，是“文件分组”功能

启用之后，UserController.php、UserControllerTest.php、UserController.php.bak 这些文件会乖乖出现在同一行下面，点一下小三角就能展开看到它们各自的子项。但有几个关键点你得记牢：

• 开启入口藏在 Project 视图右上角的齿轮图标里，勾选 Group Files by Name 才生效。注意这玩意儿只对当前 Project 视图管用，不会自动保存为全局设置——你切换到 Packages 或 Scratches 视图后，得重新勾一遍。
• 它支持按照主名称匹配，但仅限于同一级目录。比如 Api/UserService.php 和 Tests/Api/UserServiceTest.php 虽然主名称也带 UserService，但路径不同，分组逻辑直接判定失败，不会归到一起。
• 后缀白名单由 PhpStorm 内置规则控制，.php、.phpunit、.test.php 这些常用测试后缀都能识别，但如果你的项目里用到 .mock.php、.stub.php 之类的自定义后缀，就得手动处理一下了。

怎么让 PhpStorm 认出 .stub.php、.fixture.php 这类自定义后缀并参与分组

默认分组逻辑只识别标准后缀，遇到 Config.stub.php 和 Config.php 不分组，是因为 PhpStorm 把 .stub.php 当成一个独立后缀，而不是 Config 的变体。解决办法其实不复杂：把自定义后缀“绑定”到主类型上就行。

• 进入 Settings / Preferences → Editor → File Types
• 在 Recognized File Types 列表里找到 PHP（也可以新建一个自定义类型，但建议直接加到 PHP 下）
• 在 Registered Patterns 区域点击 +，添加 *.stub.php、*.fixture.php 等模式
• 务必检查一下上方的文件类型列表，确保这些新加的模式没有被其他类型（比如 Text、Plain File）提前抢走——有冲突就删掉或调整顺序
• 最后重启 Project 视图（关闭再打开侧边栏），或者直接按 F5 刷新目录，分组才会更新生效

为什么开了 Group Files by Name，.vue 和 .ts 文件还是分开显示

这个问题其实是语言类型的锅。Vue 单文件组件（.vue）默认被识别为 Vue SFC 类型，TypeScript（.ts）是完全独立的语言类型，它们的主名称提取规则互不兼容。就算文件名叫 Login.vue 和 Login.ts，分组机制也不会把它们合并到一起。

目前没有哪个开关能强行跨语言分组。如果想减轻视觉分散，可以试试这几个替代方案：

• 把相关文件统一放进同一个子目录，靠文件夹层级来视觉聚类。比如在 src/views/Login/ 下放 Login.vue、Login.api.ts、Login.spec.ts——这样至少它们在目录结构上挨在一起。
• 用 Scratches and Consoles → New Scratch File 手动建一个临时分组页签，把多个同名文件标签拖进去。但这是纯手工组织，不联动磁盘结构，只适合临时查看。
• 实在不行就放弃分组，改用 Ctrl + Shift + N 搜索 Login，结果按路径排序后自然相邻，反而比在分组里翻来翻去更省事。

文件树分组后，双击无法直接打开文件？光标卡在父节点

这是 Group Files by Name 一个众所周知的交互缺陷：你双击父节点（比如 Login）时，焦点会停在那行，但不会自动展开；更糟的是双击可能触发重命名，而不是打开第一个子文件。正确姿势是：

• 鼠标悬停在父节点右侧的小三角上，等展开箭头出现，单击展开。
• 展开后用方向键 ↓ 移动到第一个子文件（比如 Login.vue），按 Enter 打开。
• 或者干脆直接用 Ctrl + N 搜索文件名——在分组里翻找真不如搜索来得快。
• 如果频繁遇到这个痛点，建议暂时关闭分组功能，转而启用 Autoscroll from Source（同样在 Project 视图齿轮菜单里）。这样编辑器打开哪个文件，Project 视图就自动定位并高亮它，比手动折腾分组省心多了。

说到底，文件树分组并不是什么智能合并魔法，它依赖后缀注册、路径一致性，以及你每次打开 Project 视图后记得手动点齿轮开启。真正高效的办法，往往是少依赖它，多用搜索和目录结构约束命名。习惯就好。