Yii2中Composer自动加载生效的关键是正确配置composer.json的autoload并执行dump-autoload：本地模块用项目根目录psr-4映射，命名空间末尾双反斜杠、路径相对且不加./；必须运行dump-autoload而非仅install/update；入口文件需先加载vendor/autoload.php。
Yii2 项目中用 composer 配置自动加载，核心不是改 Yii2 自身的加载逻辑，而是让 composer 正确生成并维护 vendor/autoload.php，再确保 Yii2 启动时加载它——绝大多数问题出在 autoload 配置写错路径或没触发重生成。
composer.json 中的 autoload 配置怎么写才生效
必须区分两种场景：你开发的是一个独立组件（要发布到 Packagist），还是只是在当前 Yii2 项目里本地开发一个私有模块。前者配 autoload 是为别人用；后者配错位置根本不会被加载。
- 如果是本地开发的组件（比如
common/components/MyHelper.php），直接在项目根目录的composer.json里加psr-4映射：{ "autoload": { "psr-4": { "common\\components\\": "common/components/" } } } - 路径必须是相对于
composer.json所在目录的相对路径，不能写成./common/components/或绝对路径 - 命名空间末尾的反斜杠
\\必须保留，否则composer dump-autoload会忽略该规则 - 改完后一定要运行
composer dump-autoload，仅composer install或update不会重新生成 autoload 文件（除非依赖变更触发）
为什么 Yii::createObject() 能用但 new 报类找不到
这通常说明类文件确实没被自动加载，但 Yii 的 DI 容器可能通过别名（Yii::setAlias()）或配置间接加载了类——掩盖了 autoload 配置失效的问题。
- 检查是否误用了
classmap：它只扫描指定路径下所有 PHP 文件并硬编码进autoload_classmap.php，不支持命名空间映射，且新增类必须再次执行dump-autoload - 确认类文件名和类名严格匹配 PSR-4 规则，例如
MyHelper.php内必须声明namespace common\components; class MyHelper - 用
composer show -p查看当前 autoload 映射是否已注册成功，或临时在代码里打印require_once __DIR__ . '/vendor/autoload.php'; var_dump($GLOBALS['_composer_autoload_path']);
引入私有 Git 仓库组件时 autoload 不起作用
很多人以为只要在 repositories 里加了 Git 地址，再 require 就能自动加载，其实漏了关键一步：组件自身的 composer.json 必须包含有效的 autoload 配置，且主项目的 composer.json 不能覆盖或忽略它。
- 私有组件的
composer.json必须有autoload段，例如：{ "name": "myorg/my-component", "autoload": { "psr-4": { "myorg\\mycomponent\\": "src/" } } } - 主项目中用
composer require myorg/my-component:dev-main，不要手动改vendor目录 - 如果组件没发版，用
"minimum-stability": "dev"和"prefer-stable": false避免安装失败 - 遇到类找不到，先进
vendor/myorg/my-component/看composer.json是否存在、内容是否合法，再查vendor/composer/autoload_psr4.php里有没有对应条目
最常被忽略的一点：Yii2 的 index.php 入口文件里那行 require __DIR__ . '/../vendor/autoload.php'; 必须存在且路径正确。删掉它，或者把它放在 Yii::createApplication() 之后，autoload 就完全失效——此时连 yii\helpers\ArrayHelper 都会报错，更别说你的自定义类。
