Project面板不见先按Alt+1（Win/Linux）或Cmd+1（macOS）唤出；若为空则检查Content Root路径是否正确并重设，再手动标记Sources Root和Resources Root，最后清缓存重启。
Project面板完全空白或根本没出现
不是项目坏了，是Project工具窗口被关了。Windows/Linux按Alt+1，macOS按Cmd+1——这是最直接的开关。如果没反应，先检查是否进了全屏（F11）或Zen模式（Shift+Esc），退出后再试一次。View → Tool Windows → Project菜单项必须勾选，这个状态和快捷键互不干扰，可能你上次手动取消了。
Project面板弹出来了但里面空空如也
说明IDE“看见”了窗口，但没加载目录结构。99%是Content Root路径断了：右键项目名 → Open Module Settings（Ctrl+Alt+Shift+S）→ 左侧选Project → 右侧看Content root字段是否为空或指向错误位置（比如指向了上级空文件夹）。点击右侧文件夹图标，精准选中你项目真正的顶层目录（如/var/www/my-app），点OK后立刻触发重索引。
-
Content Root必须一字不差地指向项目最外层目录，多一层少一层都不行 - 即使
Content Root正确，src、app这类目录也得手动右键 →Mark Directory as → Sources Root -
public或web目录应设为Resources Root，不是Sources Root
文件树显示部分目录，但关键文件（如.env、.git）始终不出现
不是路径问题，是被PhpStorm默认忽略。打开Settings / Preferences → Appearance & Behavior → System Settings → File Types，在Ignored files and folders里删掉.env;.git（注意分号分隔），别删.*——否则所有隐藏文件都涌进来拖慢性能。再点Project视图右上角漏斗图标，取消勾选Hide ignored files，最后右键空白处选Reload project from disk。
改完配置仍不生效，索引卡在“Indexing…”
缓存没清干净。菜单栏File → Invalidate Caches and Restart…，必须勾选Invalidate and Restart，不能只选Just Restart。重启后等右下角提示Indexing…完成，再检查。若还缺目录，进Settings → Directories页面，手动Add Content Root补全遗漏项。
立即学习“PHP免费学习笔记（深入）”；
真正容易被忽略的是：Content Root 和 Source Root 是两套独立配置，漏掉任意一个，目录就“隐身”。PhpStorm 从不自动推断，必须你亲手点进每个目录去标记。
