PHPStorm中composer.json未生效的根本原因是未启用Composer支持或未手动加载，需右键composer.json选择Load Composer Package，或在设置中启用并重载项目。
PHPStorm 里 composer.json 没生效，vendor/autoload.php 不被识别？
根本原因通常是 PHPStorm 没把项目识别为 Composer 项目，或未启用自动加载索引。它不会主动扫描 vendor/autoload.php，必须显式告诉它“这里有个自动加载入口”。
- 确认项目根目录下存在
composer.json（哪怕内容为空，只要文件存在） - 右键点击
composer.json→ 选择Load Composer Package（不是“Add as Library”） - 如果没看到该菜单项，进
Settings → Languages & Frameworks → PHP → Composer，勾选Enable composer.json support - 完成后等几秒，PHPStorm 底部状态栏会显示
Indexing vendor/...，完成后类名跳转和自动补全就恢复了
手动添加 vendor/autoload.php 作为 PHP Include Path
当项目不用 Composer、或使用自定义自动加载逻辑（比如直接 require 自己写的 autoload.php），就得手动挂载路径。
- 打开
Settings → Languages & Frameworks → PHP → Include Paths - 点击
+，添加完整路径，例如：/path/to/your/project/vendor/autoload.php - 注意：只加
autoload.php文件本身，不要加整个vendor/目录 —— PHPStorm 会自动解析其中的 PSR-4/PSR-0 映射 - 加完后，重启索引（
File → Reload project from disk或手动触发File → Invalidate Caches and Restart → Just Restart）
__autoload() 和 spl_autoload_register() 在 PHPStorm 中不触发自动补全？
PHPStorm 不解析运行时注册的 autoload 函数逻辑，它只依赖静态映射（Composer 配置、include path、或 phpstorm.meta.php）。所以即使代码能正常运行，IDE 也“看不见”类。
- 避免在生产项目中用裸
__autoload()；改用composer.json的autoload字段声明映射 - 若必须用
spl_autoload_register()，可在项目根目录加一个phpstorm.meta.php文件，显式告知映射关系：
/**
* @link https://www.jetbrains.com/help/phpstorm/ide-advanced-metadata.html
*/
namespace PHPSTORM_META {
override(\spl_autoload_register(0), map(['MyApp\*' => '@']););
}这个文件不会被运行，仅用于 PHPStorm 类型推导。
立即学习“PHP免费学习笔记（深入）”；
为什么改了 composer.json 后新类还是标红？
PHPStorm 不会实时监听 composer.json 变更并重载 autoload 映射 —— 它只在你执行 composer install 或手动触发“Reload”时更新。
- 修改
composer.json后，先在终端运行composer dump-autoload（或composer install）生成最新映射 - 再回到 PHPStorm，右键
composer.json→Reload project（或按Ctrl+Shift+O快速重载） - 检查
vendor/composer/autoload_psr4.php是否已更新，这是 PHPStorm 实际读取的映射源 - 如果用了 symlink 或 Docker 卷映射，确保 PHPStorm 打开的是宿主机上的真实路径，而非容器内路径
最常被忽略的是：改了 composer.json 但忘了运行 composer dump-autoload，导致 PHPStorm 加载的仍是旧映射。
