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 配置失效的问题。

One-click installation of GitHub projects

GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。

下载

• 检查是否误用了 classmap：它只扫描指定路径下所有 PHP 文件并硬编码进 autoload_classmap.php，不支持命名空间映射，且新增类必须再次执行 dump-autoload
• 确认类文件名和类名严格匹配 PSR-4 规则，例如 MyHelper.php 内必须声明 namespace commoncomponents; 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 就完全失效——此时连 yiihelpersArrayHelper 都会报错，更别说你的自定义类。