Carbon无需单独安装，Laravel中自动加载；纯PHP项目需用composer require nesbot/carbon安装，注意PHP版本匹配（8.0及以下用^2.75，8.1+用默认v3），并正确使用命名空间或完整类名调用。
Carbon 不需要单独“安装”——它随 Laravel 自动加载，纯 PHP 项目才需手动引入，且必须通过 Composer 安装，不能直接下载文件或用 CDN。
composer require carbonphp/carbon 会失败
这是最常卡住的第一步。Carbon 官方包名不是 carbonphp/carbon，也不是 nesbot/carbon（旧版已归档），当前唯一受支持的正式包是 carbonphp/carbon？不对——实际是 nesbot/carbon 已重定向，但 Composer 仍要求显式使用新命名空间下的包。
真正有效的命令是：
composer require nesbot/carbon
常见错误现象：Could not find package nesbot/carbon 多因 Composer 镜像源过期或缓存未更新；Root composer.json requires nesbot/carbon ^3.0 -> found nesbot/carbon[dev-main, 3.x-dev] 则说明 PHP 版本低于 8.1，Carbon 3 要求 PHP ≥ 8.1。
- PHP 8.0 及以下 → 必须用
composer require nesbot/carbon:^2.75 - PHP 8.1+ → 直接
composer require nesbot/carbon（默认装 v3） - 装完检查
vendor/autoload.php是否已包含，Carbon 依赖自动注册，无需额外require
new Carbon() 报 Class 'Carbon' not found
不是没装成功，而是没正确引入命名空间。Carbon 是一个完全基于命名空间的类库，不提供全局函数，也不支持裸名调用。
典型错误写法：new Carbon()、Carbon::now()（未 use）
正确做法只有两种：
- 在文件顶部加
use Carbon\Carbon;，之后可用new Carbon()或Carbon::now() - 全程用完整命名空间：
new \Carbon\Carbon()或\Carbon\Carbon::now()
注意：Laravel 框架中 use Carbon\Carbon; 可省略，因为框架在 config/app.php 的 aliases 里预设了 'Carbon' => Illuminate\Support\Carbon::class，但这只是 Laravel 的封装，和原生 Carbon 类不同（部分方法行为有差异）。
Carbon::parse('2024-02-30') 不报错但结果诡异
Carbon 默认开启“日期柔化”（flexible parsing），遇到非法日期如 2 月 30 日，不会抛异常，而是自动修正为 3 月 1 日或 2 月 29 日（闰年），极易掩盖逻辑 bug。
真实使用场景中，表单提交、API 入参、日志时间字段都可能含脏数据，放任柔化会导致时序错乱、统计偏差。
- 严格模式下解析非法日期应立即失败：
Carbon::createFromFormat('Y-m-d', '2024-02-30')—— 这个会抛InvalidArgumentException - 若必须用
parse()，可配合Carbon::setTestNow()或提前验证字符串格式（正则或checkdate()） - Carbon 3 默认仍柔化，无全局开关；别依赖
Carbon::useStrictMode(true)，它只影响部分静态构造方法，不覆盖parse()
Carbon 的核心陷阱不在安装，而在“看起来能跑通”的默认行为——比如自动时区转换、月末计算跨月、中文翻译需额外加载语言包。这些都不是配置问题，是设计选择，得靠读文档里的 Carbon::setLocale()、CarbonImmutable、Carbon::createFromTimestamp() 等具体方法去对齐预期。
