直接装nesbot/carbon需谨慎：先检查是否已存在，再按PHP和Laravel版本选兼容版本（如PHP7.4–8.0+Laravel≤8用^2.60），安装后必须设时区并注意本地化配置。
直接装 nesbot/carbon 就行，但别只敲一条命令完事——不配置时区、不处理 PHP 版本兼容、不注意 Laravel 是否已内置，后续调用会出奇怪的偏移或报错。
确认当前项目是否已含 Carbon
很多 Laravel 项目（5.5+）默认已通过 illuminate/support 间接加载了 Carbon，重复安装可能引发版本冲突。先检查：
composer show nesbot/carbon
如果返回 “Package not found”，再安装；如果已存在，优先查它的版本：composer show nesbot/carbon | grep version。Laravel 9+ 默认带 Carbon 2.x，而 Carbon 3 要求 PHP ≥ 8.1 —— 若你用 PHP 7.4，硬升 Carbon 3 会直接 composer install 失败。
用 composer require 安装并锁定兼容版本
根据你的 PHP 和框架环境选命令：
- PHP 7.4–8.0 + Laravel ≤ 8：运行
composer require nesbot/carbon:^2.60 - PHP 8.1+ + Laravel 9+：可选
composer require nesbot/carbon:^3.0 - 纯 PHP 项目（无 Laravel）：加
--no-dev避免拉入测试依赖：composer require nesbot/carbon --no-dev
不写版本号（如 composer require nesbot/carbon）会让 Composer 自动选最新版，容易踩 PHP 版本墙。Carbon 3.0 发布后，很多老项目因此在 CI 上突然构建失败。
安装后必须设默认时区，否则 new Carbon() 返回的时间是 UTC
Carbon 默认不读 date.timezone ini 设置，而是 fallback 到 UTC。你在东八区 new Carbon('now') 却拿到 2024-06-10T00:00:00Z，就是这个原因。
正确做法是在项目启动处（如 public/index.php 或 Laravel 的 bootstrap/app.php）加一行：
Carbon::setLocale('zh'); // 可选：设中文本地化
Carbon::setTestNow(null); // 清除测试时间（防止测试污染）
date_default_timezone_set('Asia/Shanghai');
Carbon::setUtf8(true); // 中文星期/月份显示正常
注意：date_default_timezone_set() 必须在 use Carbon\Carbon; 之后、首次实例化 Carbon 之前调用，否则无效。
常见报错与绕过方式
遇到这些提示别急着重装：
-
Class 'Carbon' not found：没自动加载，执行composer dump-autoload -o -
DateTime::__construct(): Failed to parse time string：传了非法格式字符串，比如Carbon::parse('2024-13-01')，改用Carbon::createFromFormat('Y-m-d', '2024-13-01')并捕获异常 - Laravel 中
created_at显示为 UTC：模型里加protected $casts = ['created_at' => 'datetime:Y-m-d H:i:s'];，或在config/app.php改'timezone' => 'Asia/Shanghai'
Carbon 不是“装完就能随便用”的库，它对时区、格式化上下文、序列化行为都敏感。一个 Carbon::now()->toDateTimeString() 在 CLI 和 Web SAPI 下可能返回不同结果——根本原因常是 CLI 的 php.ini 和 FPM 的不一致。
