webstorm左侧project面板无分层深度设置，其展开逻辑依赖手动点击记忆与视图模式；settings→directories中的depth仅影响索引扫描，不控制ui显示，误调会导致模块识别异常。
WebStorm 左侧 Project 面板没有“分层显示深度”设置
你找不到「设置展开到第 N 层」的选项，不是操作遗漏，而是 WebStorm 根本不提供这个功能。它不按数字深度控制折叠，而是靠手动展开记忆 + 视图模式优化视觉层级。强行在 Settings → Directories 里调 Depth 值，只会干扰索引和模块识别，对左侧目录树毫无影响。
真正起作用的两个视图开关：Hide Empty Middle Packages 和 Flatten Packages
这两个选项能改变你“看到的层级感”，但逻辑完全不同：
-
Hide Empty Middle Packages：适合前端项目。比如路径src/pages/home/index.tsx存在，但pages和home文件夹下没任何文件（只有子文件夹），启用后会跳过这两层，直接在src下显示index.tsx节点。右键点击 Project 面板顶部蓝条（有 “Project” 字样）→Tree Appearance→ 勾选它。 -
Flatten Packages：主要为 Java/Maven 项目设计。把com.example.utils这类嵌套包名压成单个节点com.example.utils，视觉上变扁平。但对src/components/ui/button这种前端结构反而更难定位——你会看到一堆带点号的长名字，且无法右键单独操作ui文件夹。右键 Project 面板空白处启用。
Expand All 是临时方案，不持久
右键某个父文件夹 → Expand All 确实能瞬间展开所有子孙，但以下情况会让努力白费：
- 重启 WebStorm 或刷新项目后，全部收起回默认状态（通常只展开 2 层）
- 项目被错误识别为非当前类型（如本是 Vue 项目却被当成普通文件夹），
modules.xml里路径配置异常，导致 Expand All 失效 - 该文件夹未被标记为
Sources或Resources，IDE 不将其纳入项目结构索引，自然不渲染子项
为什么改了 Directories 的 Depth 没用还可能出问题
Settings → Directories 中的 Depth 是给扫描器用的，不是给 UI 看的。它决定 WebStorm 在标记文件夹用途（比如设为 Sources）时，往子目录递归几层去找 package.json、tsconfig.json 或 pom.xml。调高它可能导致：
-
import补全误引入深层同名模块（如utils/string.ts和lib/utils/string.ts冲突） - 运行配置自动推导的
Working directory错跑到子文件夹 - Vue/React 插件找不到组件根路径，
@/components别名失效
复杂点在于：视觉层级是状态记忆 + 视图模式共同作用的结果，不是配置值驱动的；而最容易被忽略的是——你以为在调 UI，其实动的是底层索引逻辑。
