项目树文件消失是因Content Root路径丢失或Source Root未标记，需手动重设Content Root路径并逐一标记源目录，再清缓存重启。
项目树里文件全没了，不是删了，是 PhpStorm 没“看见”——99% 是 Content Root 配置断了，得手动重指路径，再补标 Source Root。
Content Root 路径丢失是最常见原因
PhpStorm 不靠“打开文件夹”自动识别结构，它只扫描你明确设为 Content Root 的路径。一旦这个路径被清空、指向错误位置（比如指向了上级空目录），整个项目树就变空，但磁盘上文件完好无损。
- 典型诱因：
OpenZIP 解压后的文件夹、重命名项目目录后直接Open、误点Remove from Project - 检查方法：右键项目名 →
Open Module Settings（Ctrl+Alt+Shift+S）→ 左侧选Project→ 右侧看Content root字段是否为空或明显错位 - 修复动作：点击右侧文件夹图标，精准定位到你项目真正的顶层目录（如
/var/www/my-app或C:\xampp\htdocs\my-app），确认后 IDE 会立刻触发重新索引
Source Root 没标记，文件就“不参与开发流程”
即使 Content Root 正确，如果 src、app、public 这类目录没被显式标记为 Sources Root 或 Resources Root，它们可能不展开、PHP 文件不提示、路由解析异常。
-
src或app目录：右键 →Mark Directory as→Sources Root -
public或web目录：右键 →Mark Directory as→Resources Root（不是Sources Root） -
vendor、node_modules、logs：右键 →Mark Directory as→Excluded（避免拖慢索引） - 注意：
Content Root必须精确到项目根，多一层少一层都不行；Source Root标记必须手动逐个设置，IDE 不会猜
缓存卡住导致改动不生效
改完 Content Root 和标记后仍不显示？大概率是旧缓存没刷新。单纯重启不够，必须清缓存 + 强制重索引。
phpstorm 2026.1 Mac
下载
PhpStorm 2026.1 Mac 版已针对 Apple Silicon（M1/M2/M3/M4）芯片进行原生优化，实现了极速启动与流畅运行。该版本不仅深度适配 Laravel 13 与 Livewire 框架，还创新性地集成了 MCP 服务器，允许开发者直接在 IDE 内调用 Claude Code 等 AI 智能体辅助编程。配合优化的索引机制与 macOS 原生界面风格，它为 Mac 用户
立即学习“PHP免费学习笔记（深入）”；
- 菜单栏
File→Invalidate Caches and Restart… - 勾选
Invalidate and Restart（别选Just Restart） - 重启后等右下角出现
Indexing…提示完成，再检查项目树 - 若仍缺目录：进
Settings→Directories页面，手动Add Content Root补全遗漏项
文件列表工具窗本身被隐藏了
如果连左侧整个项目树区域都空白或不可见，不是配置问题，而是工具窗被手动关掉了。
- 按快捷键
Alt+1（Windows/Linux）或Cmd+1（macOS）直接唤出Project工具窗 - 如果
Alt+1没反应，试试Alt+2～Alt+9，其他数字对应不同工具窗（如Alt+7是Find） - 也可通过菜单：
View→Tool Windows→Project
最常被忽略的其实是两件事：Content Root 路径必须一字不差地指向项目最外层目录；Source Root 标记不能依赖 IDE 自动推断，必须你亲手一个个点进去设。漏掉其中任意一个，文件就“隐身”。
