PhpStorm项目目录变空是因Content Root或Source Root配置丢失或错误，而非文件丢失；需先重设Content Root路径，再手动标记Sources Root和Excluded目录，最后清缓存重启并等待索引完成。
为什么 PhpStorm 里项目目录突然变空或不显示文件
不是项目真丢了，而是 PhpStorm 的 Content Root 或 Source Root 配置被意外清除或错配。常见诱因包括：重命名项目文件夹、从 ZIP 解压后直接打开、用「Open」而非「Open Folder」导入、或误点了 Remove from Project。此时项目树显示为空，但文件实际完好存在磁盘上。
检查并重设 Content Root（关键第一步）
PhpStorm 不是靠“打开文件夹”自动识别项目结构的，它依赖明确配置的 Content Root 路径来扫描内容。如果该路径丢失或指向错误位置，整个目录树就不可见。
- 右键项目名 → Open Module Settings（或按
Ctrl+Alt+Shift+S） - 左侧选
Project→ 右侧看Project structure → Content root - 如果路径为空或明显错误（比如指向了上级空目录），点击右侧
...重新定位到你项目真正的根文件夹（例如/var/www/my-app或C:\xampp\htdocs\my-app） - 确认后点
OK，IDE 会立即触发重新索引
标记 Source Root 和 Excluded 目录（避免误判为非源码）
即使 Content Root 正确，如果 PhpStorm 没把 src、app 或 public 这类目录显式标记为 Source Root，它们可能不会展开显示，或 PHP 文件不参与代码提示/跳转。
- 在项目树中右键目标目录（如
src）→ Mark Directory as → Sources Root - 对
vendor、node_modules、logs等非源码目录，右键 → Mark Directory as → Excluded（避免索引拖慢性能） - 注意：
public或web目录通常应设为Resources Root，否则路由/静态资源路径解析可能异常
强制刷新与索引重建（当改动后仍不生效）
PhpStorm 的缓存有时会卡住旧状态，尤其在跨平台迁移或版本升级后。单纯重启不够，需清缓存+重索引。
立即学习“PHP免费学习笔记（深入）”；
- 菜单栏 File → Invalidate Caches and Restart…
- 勾选
Invalidate and Restart（不要选 “Just Restart”） - 重启后等待右下角出现
Indexing…提示完成，再检查目录树 - 若仍不显示，检查
Settings → Directories页面是否列出了所有预期的根目录 —— 缺失项需手动Add Content Root
最常被忽略的是：Content Root 必须精确指向项目顶层，不能多一层也不能少一层；而 Source Root 标记必须逐个手动设置，PhpStorm 不会自动推断。这两步漏掉任意一个，目录就“隐身”。
