正确命令是 composer require nesbot/carbon，它自动写入 composer.json 并安装到 vendor；需手动引入 vendor/autoload.php 才能使用，且要注意时区处理差异。
直接用 composer require nesbot/carbon 就能装上，但装完不等于会用——Carbon 的核心价值不在安装，而在它怎么帮你绕过 PHP 原生 DateTime 的一堆坑。
为什么不是 composer install？
因为 Carbon 是一个独立的第三方库，不是你项目里已有的依赖。你得显式告诉 Composer：“我要加这个包”。composer install 只读 composer.lock 装已有依赖，对新库没反应。
- 正确命令是：
composer require nesbot/carbon - 执行后会自动写入
composer.json的require区，并安装到vendor/nesbot/carbon - 如果项目已锁定 PHP 版本（比如
"php": "^8.0"），而 Carbon 最新版要求 PHP 8.1+，Composer 会自动降级选兼容版本——别硬加@latest
use Carbon\Carbon; 之后为什么还报错 Class not found？
常见于没引入自动加载机制。Composer 安装后不会自动生效，必须确保你的脚本加载了 vendor/autoload.php。
- 在入口文件（如
index.php）开头加：require_once 'vendor/autoload.php'; - 如果是 Laravel、Symfony 等框架，这步已内置，不用手动加
- 如果用的是纯 PHP 脚本且报
Class 'Carbon\Carbon' not found，八成是漏了这行require - 注意路径：如果脚本不在项目根目录运行，
vendor/autoload.php路径要写对，别直接抄绝对路径
Carbon 实例化时传字符串 vs 传时间戳的区别
看似都能创建对象，但底层行为和时区处理完全不同，容易导致时间偏移。
-
Carbon::parse('2024-03-15')：按当前时区（通常是服务器本地或date_default_timezone_set设置的）解析，结果带时区信息 -
Carbon::createFromTimestamp(1710489600)：直接按 Unix 时间戳构造，UTC 时间为基准，再转成当前时区显示 -
Carbon::create(2024, 3, 15)：不推荐裸用，没指定时区时默认用系统时区，但不显式，易混淆 - 最安全写法：
Carbon::parse('2024-03-15')->tz('Asia/Shanghai')或Carbon::createFromFormat('Y-m-d', '2024-03-15', 'Asia/Shanghai')
Carbon 的“优雅”不来自语法糖，而来自它把时区、格式化、相对时间这些边界情况都封装进方法里了；但前提是你要理解它默认怎么处理时区，而不是只记 ->diffForHumans() 这种表面功能。
