Carbon需用composer require安装并引入autoload.php；默认时区为UTC，须手动设Asia/Shanghai；解析字符串会自动修正错误日期，关键业务应禁用柔化模式。
Carbon 不是插件，也不是 PHP 内置类，必须用 composer require nesbot/carbon 安装；装完不引入 vendor/autoload.php 就会报 Class 'Carbon' not found，这是最常见、最直接的失败原因。
为什么 composer install 不能装 Carbon？
因为 composer install 只按 composer.lock 恢复已有依赖，它不会识别新包。你得明确告诉 Composer：“我要加这个库”——所以必须用 composer require nesbot/carbon。
- 执行后自动写入
composer.json的require区，并下载到vendor/nesbot/carbon - 如果项目已通过 Laravel 的
illuminate/support间接加载了 Carbon，composer show nesbot/carbon会有输出，此时再require可能引发版本冲突 - 重复安装时，Composer 默认会升级到最新版，但 PHP 8.1+ 才支持 Carbon 3.x，PHP 7.4–8.0 应锁版本如
^2.60
装完就报 Class 'Carbon' not found 怎么办？
不是没装好，而是没加载自动加载器。Carbon 是 Composer 管理的类库，不走 include 或 require_once 手动路径那一套。
- 确保脚本开头有
require __DIR__ . '/vendor/autoload.php';（路径按你项目结构调整） - 别把
use Carbon\Carbon;放在require autoload前面——顺序错会导致命名空间失效 - 如果改过
composer.json但没生效，运行composer dump-autoload -o强制重建自动加载映射 - 手动复制
Carbon.php文件进项目？不行。它依赖symfony/polyfill-mbstring等底层包，缺一不可
为什么 Carbon::now() 时间不对？
Carbon 默认不读 date.timezone 配置，fallback 到 UTC。你在东八区看到 2026-04-07T02:42:00Z，就是 UTC 时间，不是 bug，是默认行为。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 必须在首次实例化前调用
date_default_timezone_set('Asia/Shanghai') - 或者显式指定时区：
Carbon::now('Asia/Shanghai')或Carbon::parse('2026-04-07')->tz('Asia/Shanghai') -
Carbon::create(2026, 4, 7)不推荐裸用——没传时区参数时，它用系统时区，但不透明，容易和createFromTimestamp()混淆 - 注意：时区设置要早于任何
Carbon::*调用，否则已创建的对象不会自动更新时区
Carbon 解析字符串时“自动修正”很危险
比如 Carbon::parse('2026-02-30') 不会报错，而是默默变成 2026-03-02（非闰年）或 2026-03-01（闰年）。这种柔化模式掩盖输入校验逻辑，上线后可能引发资损。
- 业务关键场景（如订单截止日、合同生效日）禁用柔化：
Carbon::createFromFormat('Y-m-d', '2026-02-30', 'Asia/Shanghai')会在格式不符时直接抛异常 - 避免对用户输入直接
parse()，先用正则或checkdate()做前置校验 -
Carbon::parse(null)返回当前时间，不是null——空值必须显式判断，否则逻辑分支被绕过
真正卡住人的从来不是“怎么装”，而是装完后时区没设、自动加载漏了、解析太柔、版本撞墙——这些点不提前踩一遍，线上时间错位连日志都难排查。
