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 类型推导。

为什么改了 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，导致 PHP