Carbon需通过composer require nesbot/carbon装入项目（非全局），PHP≥8.0用最新版，7.4则指定^2.73；使用时须use Carbon\Carbon或写全名，parse()不支持中文等非标准格式，3.x已移除下划线方法如date_diff_in_days，改用diffInDays()等驼峰式。
Carbon 怎么装进项目里（不是全局）
Carbon 不是 Composer 的插件，它是 PHP 的一个独立日期时间库，通过 Composer 安装到当前项目中即可。别搜“Carbon 插件”，搜不到——它压根不是插件，是 nesbot/carbon 这个包。
执行这行命令就行：
composer require nesbot/carbon
它会自动写进 composer.json 的 require 区，同时安装依赖并生成/更新 vendor/autoload.php。不需要手动启用、注册或配置插件机制。
- 别用
composer global require—— 全局安装后项目里use Carbon\Carbon;仍会报错，因为自动加载只认当前项目的vendor - PHP 版本要 ≥ 8.0（Carbon 3.x 要求），如果项目还在用 PHP 7.4，得加版本约束：
composer require nesbot/carbon:^2.73 - 装完不生效？检查是否漏了
require 'vendor/autoload.php';—— Laravel 等框架自动做了，但原生 PHP 脚本必须手动引
为什么 new Carbon() 报错 Class 'Carbon' not found
这是最常见问题：类名没正确引入，或者命名空间搞混了。Carbon 3.x 默认使用完整命名空间 Carbon\Carbon，不再支持裸 Carbon。
正确写法只有两种：
- 用全名：
$date = new Carbon\Carbon(); - 或提前 use：
use Carbon\Carbon;，再写$date = new Carbon();
别写 new Carbon() 且没 use，也别写 use Carbon;（少了个 Carbon\，这是旧版写法，3.x 已废弃）。
另外注意：如果你用的是 Laravel，它在 config/app.php 里预置了 Carbon\Carbon 的 alias，所以 Blade 或控制器里看似能直接用 Carbon::now() —— 但这只是框架的便利，不是 Carbon 本身的特性。
Carbon::parse() 解析失败的几个典型原因
Carbon::parse() 看似万能，但实际很挑输入格式。它底层调用 PHP 原生 strtotime()，所以不支持模糊或非标准写法。
- 输入含中文（如
"2024年5月1日"）→ 直接返回false或异常，必须转成英文或标准 ISO 格式（"2024-05-01"） - 输入带毫秒但没指定格式（如
"2024-05-01 12:00:00.123"）→ 可能截断，建议用Carbon::createFromFormat('Y-m-d H:i:s.u', $str) - 时区未声明又含偏移（如
"2024-05-01T12:00:00+08:00"）→ 解析成功但时区可能被忽略，最好显式传第二个参数：Carbon::parse($str, 'Asia/Shanghai')
调试时可加 var_dump(Carbon::parse($input));，如果返回 bool(false)，基本就是格式或时区问题。
Carbon 2.x 升 3.x 后 date_diff_in_days() 没了
Carbon 3.x 移除了大量带下划线的旧方法名，统一用驼峰。这不是 bug，是故意的 breaking change。
对应关系很简单：
-
$a->diffInDays($b)✔️（替代date_diff_in_days） -
$a->addWeeks(2)✔️（不是add_weeks） -
$a->isToday()✔️（不是is_today）
所有方法都去掉了下划线，且多数要求至少一个参数（比如 diffInDays() 必须传参，不能空着）。查文档时认准 diffInXxx() 这类命名，别翻旧版 API。
升级前跑一遍 diffInXxx()，把残留的下划线方法全找出来改掉，否则运行时报 grep -r "date_.*_in\|->add_.*_" app/。
