PHP 7.3 CLI 模式下 autoload 已废弃且不触发，必须用 spl_autoload_register 注册加载器；路径需基于 __DIR 向上定位，避免依赖 getcwd()；环境变量须手动加载。
PHP 7.3 中自动加载机制在 CLI 模式下基本可用，但有几个关键点容易出错，尤其和 Web 环境表现不一致。
__autoload 已被废弃，CLI 下不可用
PHP 7.2 起 __autoload() 函数已被正式弃用，7.3 中调用它会触发 E_DEPRECATED 警告；更重要的是，CLI 模式下该函数默认不会被触发——即使你定义了，也不会自动执行。这不是 Bug，而是设计行为：CLI 启动时不注册任何默认加载器，必须显式启用。
- 不要在 CLI 脚本里依赖
function __autoload($class) { ... } - 若旧项目仍含此函数，需立即迁移到
spl_autoload_register()
spl_autoload_register 是唯一可靠方式
CLI 模式下必须使用 spl_autoload_register() 注册加载逻辑，且推荐在脚本最开始就注册（早于任何类引用）。它支持多次调用，可叠加多个加载器，也兼容 Composer 的 autoloader。
- 注册后，只要 new 一个未定义的类、或使用未引入的接口/trait，就会按注册顺序逐个调用加载器
- 建议用闭包注册，避免全局函数污染：
spl_autoload_register(function ($class) { require __DIR__ . '/src/' . str_replace('\', '/', $class) . '.php'; }); - 若使用 Composer，只需
require 'vendor/autoload.php';即可，它内部已用spl_autoload_register注册好 PSR-4 规则
CLI 与 Web 加载路径可能不一致
CLI 执行时的当前工作目录（getcwd()）往往不是项目根目录，而自动加载器中常依赖 __DIR__ 或相对路径。比如 require 'app/Model/User.php' 在 Web 请求中能跑通，但在 cd /tmp && php /path/to/project/artisan user:sync 下就会失败。
立即学习“PHP免费学习笔记（深入）”；
- 所有路径应基于项目根目录计算，例如：
$base = dirname(__DIR__); // 假设 autoload.php 在 project/vendor/autoload.php - 避免硬编码相对路径，优先用
__DIR__向上定位，或提前定义常量如define('ROOT_PATH', __DIR__ . '/../'); - 可通过
echo getcwd() . " ";在 CLI 脚本开头调试实际执行路径
环境变量与配置加载需手动触发
CLI 不会自动读取 .env 文件（如 Laravel、ThinkPHP），也不会加载 Web 环境下的配置缓存。如果自动加载的类依赖数据库连接或 API 密钥，而这些值来自环境变量，那很可能因未加载 .env 导致运行时报错。
- Laravel：在命令行入口（如
artisan）顶部加DotenvDotenv::createImmutable(__DIR__)->safeLoad(); - ThinkPHP 6+：在
think入口文件末尾加Env::load(); - 自建项目：建议统一在自动加载器注册前完成环境初始化
