CodeIgniter 不支持自动类别名，必须用 class_alias() 在类加载前手动注册；正确位置是 app/Config/Boot/aliases.php 或 Autoload.php 末尾，不可在控制器中调用，且别名不能含反斜杠、不支持静态调用；推荐优先使用服务容器绑定替代。
CodeIgniter 本身不提供类似 Laravel 的自动类别名机制，所有“全局别名”都必须靠 PHP 原生的 class_alias() 手动注册，且必须在类被加载前完成 —— 否则会报 Class 'X' not found。
为什么不能在控制器里用 class_alias()
类别名必须在类定义被解析后、首次使用前注册。CI 的自动加载器（Loader）按需加载类，一旦某个类已加载（比如 App\Libraries\MyLogger），再调 class_alias() 就无效。常见错误现象：class_alias('App\Libraries\MyLogger', 'Logger') 放在某个控制器方法里，结果调用 new Logger() 时仍报错。
- 正确时机：放在
app/Config/Autoload.php的末尾，或新建app/Config/Boot/aliases.php并确保它被index.php或app/Config/Boot.php提前引入 - 必须确保目标类文件尚未被 require/include —— 所以别把它塞进
autoload['files']里（那会太晚） - 别名不能含命名空间分隔符
\，只能是纯标识符，如Logger、DBHelper
class_alias() 的实际写法与限制
它只做符号映射，不加载类，也不影响 use 语句。你仍需保证原类能被 CI 自动加载器找到（路径正确、命名规范、已注册到 $autoload['files'] 或 $autoload['psr4']）。
- 示例：给
App\Libraries\JwtAuth设别名Jwt，写在app/Config/Boot/aliases.php中：class_alias('App\Libraries\JwtAuth', 'Jwt'); - 之后可在任意控制器中直接
new Jwt()或app()->get('Jwt')（若已注册为服务） - 注意：别名无法用于
static调用上下文（如Logger::log()），除非原类明确支持静态代理 - CI4.4+ 若启用了 PSR-4 自动加载，别名不能覆盖已由 Composer 加载的同名类，否则会触发 fatal error
替代方案：用服务容器绑定更安全
比起全局别名，CI4 推荐用 Services 注册简短服务名。它不污染全局符号表，还能控制实例生命周期和依赖注入。
- 在
app/Config/Services.php中追加：public static function logger($getShared = true) { return $getShared ? self::getSharedInstance('logger') : new \App\Libraries\Logger(); } - 然后 anywhere：
service('logger')->info('hello')，比class_alias()更可控 - 如果坚持要“像类一样 new”，可配合工厂闭包：
$services->add('fastdb', function() { return new \App\Libraries\FastDB(); });，再通过service('fastdb')获取 - 这种写法天然规避了命名冲突、加载时序、IDE 支持弱等问题
真正容易被忽略的是：别名一旦注册就不可撤销，也无法条件化（比如仅开发环境启用）。如果你项目里混用 Composer 包和自定义类，优先走服务容器或配置类，class_alias() 只适合极简场景下的临时速记 —— 比如调试时把 App\Models\UserModel 缩成 UM，但上线前最好删掉。
