yii框架的别名是以@开头的全局路径映射机制，必须在应用启动前注册，否则无效；内置alias如@app不可覆盖但可扩展，配置中须用纯字符串引用，拼接会导致解析失败。
Yii 框架的别名（alias）不是语法糖，而是路径映射的核心机制——它直接决定 Yii::createObject() 能否找到类、require 能否加载文件、view 渲染时路径是否合法。用错 alias，轻则报 Class not found，重则路由跳转到空白页。
alias 必须以 @ 开头，且只能在应用启动前注册
Yii 的 alias 是全局静态映射表（Yii::$aliases），一旦应用进入 run() 阶段，再调用 Yii::setAlias() 不会生效（除非手动清空缓存或重启进程）。
- 正确时机：在
config/web.php或index.php中new yii\web\Application(...)之前注册 - 错误写法：
Yii::setAlias('@common', dirname(__DIR__) . '/common');放在某个 controller 的actionIndex()里 —— 完全无效 - 推荐写法：在
config/bootstrap.php或common/config/bootstrap.php中统一注册，避免散落
@app、@vendor、@runtime 等内置 alias 不能覆盖但可扩展
Yii 自动注册了 @app（应用根目录）、@vendor（Composer 包目录）、@runtime（运行时目录）等基础 alias，它们由 BaseYii::getAlias() 内部硬编码保障，你无法用 setAlias() 修改其值（会触发 warning 并忽略）。
- 可安全扩展：如
Yii::setAlias('@widgets', '@app/widgets')或Yii::setAlias('@tests', dirname(__DIR__) . '/tests') - 注意路径拼接逻辑：
@app/widgets是合法解析，但@app/../console在某些 OS 下可能因 realpath 失败而返回 false - 调试技巧：用
var_dump(Yii::getAlias('@common'));直接验证映射结果，比猜路径更可靠
在配置数组中使用 alias 时，只认字符串字面量，不支持变量拼接
Yii 的配置系统（如 components、modules、view 配置）会自动调用 Yii::getAlias() 解析字符串，但仅限纯字符串。一旦掺入 . 拼接或 sprintf，alias 就失效。
- ✅ 正确：
'class' => 'app\components\MyService'（自动识别@app） - ✅ 正确：
'viewPath' => '@app/views/mail'（明确 alias 字符串） - ❌ 错误：
'viewPath' => '@app' . '/views/mail'（PHP 字符串拼接，Yii 不解析） - ❌ 错误：
'class' => $prefix . '\components\MyService'（变量介入，alias 机制不触发） - 性能提示：频繁调用
Yii::getAlias()有微小开销，但 Yii 内部已缓存解析结果，无需手动优化
alias 看似简单，真正卡住人的往往是「以为它生效了」——比如在 console 应用里用了 @web（只在 web 应用中注册），或者在测试环境下漏配 @tests 导致 fixture 加载失败。每次加新 alias，务必用 Yii::getAlias() 实测输出，别信文档里的默认值。
