Class 'Carbon\Carbon' not found 的根本原因是 PHP 版本与 Carbon 版本不兼容或未正确加载 autoload，如 PHP 7.4 应用 Carbon 2.x（^2.60），PHP 8.2 用 Carbon 3.x（^3.0），且入口文件必须包含 vendor/autoload.php。
为什么直接 composer require nesbot/carbon 后仍报错 Class 'Carbon\Carbon' not found
常见原因是未引入自动加载机制，或 PHP 版本不兼容。Carbon 2.x 要求 PHP ≥ 7.1.8，Carbon 3.x 要求 PHP ≥ 8.1；若项目用 PHP 7.4，却装了 Carbon 3，composer install 会成功但运行时类找不到——Composer 不报错，但 autoload.php 根本没注册 Carbon 的命名空间。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先确认 PHP 版本：
php -v，再选对应 Carbon 版本：PHP 7.4 用composer require nesbot/carbon:^2.60；PHP 8.2 用composer require nesbot/carbon:^3.0 - 确保入口文件（如
index.php）开头已包含：require __DIR__ . '/vendor/autoload.php'; - 别跳过
composer dump-autoload—— 尤其在手动改过composer.jsonautoload 段后
Carbon 实例化时传入字符串失败，比如 new Carbon('2024-10-05 14:30:00') 报错
Carbon 构造函数对格式敏感，不是所有 ISO 字符串都能直接解析，尤其含时区或毫秒时容易失败。默认只识别标准格式（如 Y-m-d H:i:s），而 '2024-10-05T14:30:00+08:00' 这类带 T 和时区偏移的字符串，需显式指定格式或使用静态方法。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 优先用静态工厂方法：
Carbon::parse('2024-10-05 14:30:00')或Carbon::createFromFormat('Y-m-d H:i:s', '2024-10-05 14:30:00') - 若字符串含时区（如
'2024-10-05T14:30:00+08:00'），Carbon::parse()可处理；但new Carbon($str)在 Carbon 3 中已弃用构造函数传字符串的方式 - 避免依赖隐式解析：生产环境建议始终用
createFromFormat()并捕获InvalidArgumentException
Carbon 时区转换结果不对，比如 fromTimestamp() 后 format('e') 显示 UTC 而非预期 Asia/Shanghai
Carbon 实例默认使用系统时区（date_default_timezone_get()），但 fromTimestamp() 创建的是 UTC 时间戳对应的本地时间，不是“把时间戳当作本地时间再转时区”——这是最常混淆的点。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 明确区分两种场景：
– 时间戳是 UTC 值 → 用Carbon::createFromTimestamp(1728100200)->tz('Asia/Shanghai')
– 时间戳是本地（如东八区）值 → 先用Carbon::createFromTimestamp(1728100200, 'Asia/Shanghai')指定时区再转换 - 全局设默认时区（可选）：
Carbon::setTestNow(Carbon::now('Asia/Shanghai'))或在bootstrap.php中调date_default_timezone_set('Asia/Shanghai') - 验证时区是否生效：
$dt->tzName比$dt->format('e')更可靠，后者受格式化影响
Carbon 3 中 formatLocalized() 报 Call to undefined method，且中文 locale 不生效
formatLocalized() 在 Carbon 3 中已被移除，因其依赖已废弃的 setlocale()，且线程不安全。改用 isoFormat() 或 translatedFormat()，但后者需额外加载语言包。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 替换写法：
$dt->isoFormat('YYYY年MM月DD日 HH:mm:ss')（支持中文占位符，无需 locale） - 若需完整翻译（如 “January” → “一月”），需安装
symfony/intl并调用$dt->translatedFormat('LLLL')，同时确保intl扩展已启用 - 注意：
isoFormat()的模板语法与 Moment.js 兼容，不是 PHP date() 格式；'YYYY-MM-DD'有效，'Y-m-d'无效
