推荐用composer require安装Yii2扩展，它自动写入composer.json、下载包并注册PSR-4自动加载；但必须在config中显式注册组件或模块才能生效，且应锁定版本如~2.0.0避免不兼容升级。
直接用 composer require 装，别手动复制文件、别改 autoload 手动映射、别碰 vendor/autoload.php —— 这些操作不仅多余，还会导致类找不到或版本错乱。
composer require 是唯一推荐的安装方式
Yii2 的扩展包（如 yiisoft/yii2-redis、yiisoft/yii2-swiftmailer）全部遵循 PSR-4，Composer 安装后自动注册命名空间，vendor/autoload.php 会原生支持。
- 运行
composer require yiisoft/yii2-redis，它会：自动写入composer.json的require段、下载到vendor/yiisoft/yii2-redis、更新自动加载映射 - 不要用
git clone或解压到vendor/目录下再手动改配置 —— 这绕过了 Composer 的依赖解析，后续composer update会清掉你的手动改动 - 避免在
composer.json里手写autoload.psr-4映射扩展路径，比如"yii\redis\": "vendor/yiisoft/yii2-redis/src/"—— 这是扩展自身composer.json里已声明的内容，重复写反而可能冲突
装完不配置 = 白装：必须在 config 中注册组件或模块
Composer 只负责「让类能被 new 出来」，但 Yii2 的组件、模块、行为等功能，必须显式注册进应用配置才能生效。
- 像
yii edisCache这类组件，需在config/web.php的components数组中配置：'cache' => ['class' => 'yii edisCache'] - 像
yiidebugModule这类模块，需在modules和bootstrap中同时声明：'bootstrap' => ['debug'], 'modules' => ['debug' => 'yiidebugModule'] - 像
yiigiiModule这类工具模块，还涉及路由权限控制，只配不加allowedIPs会导致 403
版本约束写错会升级到不兼容版
Yii2.0.x 项目若用了 ^2.0 或 *，composer update 可能拉到 2.1.0+，而该系列已不兼容 PHP 7.2–7.4 且破坏部分接口。
- 生产项目务必锁定主版本：用
~2.0.0（等价于>=2.0.0 ），不是 <code>^2.0 - 执行
composer require yiisoft/yii2-bootstrap5:~2.0.0比:^2.0更安全 - 升级前先看扩展的
composer.json里require.yiisoft/yii2字段，确认是否仍支持你当前的 Yii2 版本
前端资源（CSS/JS）不能靠 Composer 直接发布
Composer 管 PHP 类，不管浏览器能加载的静态文件。像 Bootstrap 的 JS、jQuery、Font Awesome 这类，不能指望 composer require twbs/bootstrap 后直接 use 进视图。
- 旧方案
fxp/composer-asset-plugin已废弃，且与 Composer 2.x 不兼容 - 正确做法：用
yarn add bootstrap或npm install bootstrap，然后在自定义AssetBundle中通过sourcePath指向node_modules/bootstrap - 发布时注意
publishOptions.forceCopy = true是否必要 —— 开发环境设为false可避免重复拷贝，提升刷新速度
最容易被忽略的是：扩展装好了、配置也写了，但没检查 vendor/autoload.php 是否真被入口脚本引入（index.php 里那行 require __DIR__ . '/../vendor/autoload.php';），漏了这句，整个自动加载链就断了。
