WebStorm Project工具窗口无“分层深度”配置，仅通过右键菜单的Hide Empty Middle Packages和Flatten Packages控制嵌套显示，二者互斥且需手动刷新；Expand All不持久，重启或项目识别异常会导致收起。
WebStorm 的 Project 工具窗口不提供「分层深度」数值配置，所谓“展开到第 3 层”或“默认只显示 2 层”是误解——它没有该开关，强行调 Settings → Directories → Depth 不仅无效，还会干扰模块识别和路径解析。
Project 面板的层级显示由两个视图选项控制
真正影响你看到多少“嵌套感”的，只有这两个右键菜单里的开关，其他地方都无效：
-
Hide Empty Middle Packages：启用后，跳过纯中转文件夹。例如src/pages/home/index.tsx存在，但pages和home下无任何文件（只有子文件夹），则直接在src下显示index.tsx节点。适合 React/Vue 前端项目。 -
Flatten Packages：把com.example.utils这类 Java 包名压成单节点。对前端项目有害——src/components/ui/button会变成一堆带点号的长名字，且无法单独右键操作ui文件夹。
两者互斥，别同时开；启用后需手动刷新（Ctrl + Shift + O）或重启面板才生效。
为什么 Expand All 不持久、点了又收回去
右键文件夹 → Expand All 是临时动作，不是状态保存。以下情况会让它失效：
- Linux 版 WebStorm 重启后必然全部收起（Windows/macOS 有时能记忆，但不可靠）
- 项目被错误识别为“普通文件夹”而非对应框架项目（如 Vue 项目没检测到
vue.config.js或package.json中的vue字段），导致modules.xml中路径未正确注册 - 目标文件夹未标记为
Sources Root（右键 →Mark Directory as → Sources Root），IDE 根本不索引其子项，自然不渲染
Directories 设置里的 Depth 到底管什么
Settings → Directories → Depth 控制的是“扫描器递归查找配置文件的层数”，不是 UI 显示逻辑：
- 设太高（如 10）：可能让 WebStorm 在
lib/utils/string.ts和src/utils/string.ts之间误判 import 补全目标 - 设太低（如 1）：Vue/React 插件找不到
@/components别名根目录，tsconfig.json的baseUrl解析失败 - 它还会影响运行配置自动推导的
Working directory—— 可能错跑到src/api而非项目根
默认值 3 对大多数项目足够；改之前先确认你真在解决索引问题，而不是想调 UI。
Structure 面板和 Project 面板根本不是一回事
别指望 Structure（Alt+7）能替代 Project 面板看文件结构：
-
Structure是单文件结构索引器：只显示当前打开文件内的函数、类、CSS 类、HTML 标签等，不展示文件系统路径 -
Structure里看不到class或id属性值，也不显示对象属性名（如user.name） - 灰色方法名 = WebStorm 找不到定义位置，优先检查该文件是否在
Sources Root内、jsconfig.json是否存在
真实工作流是：用 Project 面板找文件 → 打开 → 用 Structure 面板跳转内部函数。两者分工明确，混用只会卡住。
