PhpStorm无法直接恢复被删的依赖包映射文件，但可快速重建：误删composer.json可用Local History恢复；删vendor目录需执行composer install重建；删autoload.php则运行composer dump-autoload修复；External Libraries不显示需确认composer.json存在、项目根标记为Sources Root、PHP解释器及语言级别配置正确，并执行Reload project或Invalidate Caches and Restart。
PhpStorm 无法直接恢复被删的依赖包映射文件（如 composer.json、vendor/autoload.php 或 IDE 内部的 External Libraries 索引节点），因为这些不是普通源码文件，而是由工具链生成或由 IDE 动态解析的产物——但你可以快速重建它们，关键在于分清「文件物理存在」和「IDE 映射关系」两层问题。
误删的是 composer.json 或 vendor 目录？先检查磁盘是否真没了
Local History 对 composer.json 有效（只要它曾被编辑并保存过），但对整个 vendor/ 目录无效——因为该目录默认被 PhpStorm 排除在索引外（见 Settings → Editor → File Types → Ignore files and folders）。所以：
- 如果只是删了
composer.json：右键项目根目录 →Local History → Show History，找带Deleted标记的条目，定位并Revert它 - 如果删了整个
vendor/：别指望 Local History 恢复——它压根没存这个目录的快照；你得靠composer install重建 - 如果删的是
autoload.php但vendor/还在：说明 Composer 自动加载器损坏，运行composer dump-autoload即可修复
External Libraries 不显示？不是文件丢了，是映射断了
PhpStorm 左侧项目树里 “External Libraries” 下空空如也，常见于以下情况：
-
composer.json被删或路径错位 → IDE 找不到依赖声明，不触发自动扫描 - 项目根目录未标记为
Sources Root→ 即使composer.json存在，IDE 也不认为这是 PHP 项目上下文 - PHP 解释器未配置或版本太低（如低于 7.4）→ Composer autoloading 解析失败，
vendor/不被识别 -
vendor/目录被手动标记为Excluded（右键 → Mark Directory as → Excluded）→ IDE 主动忽略它
解决方法：确认 composer.json 存在且格式合法 → 右键项目根目录 → Mark Directory as → Sources Root → File → Reload project from disk → 等右下角索引完成。
立即学习“PHP免费学习笔记（深入）”；
vendor/autoload.php 重建后 External Libraries 仍不出现？检查 PHP Language Level
即使 vendor/ 和 autoload.php 都完好，External Libraries 也可能不加载，典型原因是 PHP 语言级别与 Composer 包不兼容：
- 打开
Settings → Languages & Frameworks → PHP - 确认
CLI interpreter已选且能执行php -v - 检查
Language level是否 ≥ 项目中最低要求（如 Laravel 11 要求 PHP 8.2+） - 若用 Docker 或 Remote Interpreter，确保容器内已安装
composer且vendor/在共享卷中可读
改完需重启索引：File → Invalidate Caches and Restart… → Invalidate and Restart。
composer.json 被删且 Local History 找不到？别硬试，用最小化重建法
当 composer.json 物理丢失、又无 Git 历史、Local History 也失效时，最稳路径不是猜内容，而是还原结构：
- 进终端，cd 到项目根目录，运行
composer init，按提示填包名、描述、依赖项（可先空着） - 若记得关键依赖（如
laravel/framework），立即补上：composer require laravel/framework:^11.0 - 完成后，PhpStorm 会自动检测新
composer.json并触发vendor/重索引 - 若项目含自定义 autoload 规则（如 PSR-4 的
"App\": "app/"），手动补到composer.json的"autoload"字段再运行composer dump-autoload
真正容易被忽略的是：External Libraries 的刷新完全依赖 composer.json 的存在和解析成功，而不是 vendor/ 文件夹本身是否存在——哪怕你把整个 vendor/ 复制回来，没有有效的 composer.json，IDE 依然不会认。
