Carbon需用composer require安装并引入autoload.php；默认时区为UTC，须手动设Asia/Shanghai；解析字符串会自动修正错误日期，关键业务应禁用柔化模式。
装 Carbon 不是“点下一步就行”的事，composer require nesbot/carbon 这条命令本身没问题，但执行完就写 new Carbon() 报错、时间显示为 UTC、解析日期不报错却悄悄改了日子——这些才是真实卡点。
Class 'Carbon' not found？先查 autoload 和命名空间
最常见错误不是没装上，而是没加载自动加载器或漏写 use。Composer 装完包后不会自动在你代码里加 use，也不会替你引入 vendor/autoload.php。
- 确保入口文件（如
index.php）第一行是：require __DIR__ . '/vendor/autoload.php'; - 在使用 Carbon 的 PHP 文件顶部必须声明：
use Carbon\Carbon;（v3 必须全限定名，不能只写use Carbon;） - 别写
use Carbon\Carbon as Carbon;——PHP 解析器会直接报Parse error - 如果用了 Laravel，别以为“框架自带”就不用
use：Laravel 的Carbonalias 指向的是Illuminate\Support\Carbon，和原生nesbot/carbon行为不完全一致
PHP 版本不匹配导致装了也用不了
v3 要求 PHP ≥ 8.0，但很多旧项目还在 PHP 7.4；装错版本轻则方法不存在，重则 composer require 直接失败。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- PHP 8.1+：直接运行
composer require nesbot/carbon（默认装 v3.x） - PHP 7.2–7.4：显式指定兼容版本，例如
composer require nesbot/carbon:^2.60 - 如果已装过 v3 却报
Root composer.json requires nesbot/carbon ^3.0 -> found [...] but these were not loaded，先跑composer dump-autoload - 检查
composer.json里有没有"minimum-stability": "dev"——这会让 Composer 优先拉dev-main而非稳定版
Carbon::parse() 不报错反而更危险
它默认开启“柔化解析”，Carbon::parse('2026-02-30') 不抛异常，而是静默转成 2026-03-02。表单、API 入参、日志字段一旦混入脏数据，时序就乱了。
- 生产环境务必包裹
try/catch：try { $date = Carbon::parse($input); } catch (\Exception $e) { /* 拒绝请求或 fallback */ } - 对已知格式的输入，优先用
Carbon::createFromFormat('Y-m-d', $input)，它不柔化，错就直接 throw - MySQL 零日期
'0000-00-00'也会触发异常，需提前过滤：!empty($input) && $input !== '0000-00-00' ? Carbon::parse($input) : null
时区和本地化不设，等于白装
Carbon 默认用系统时区（通常是 UTC），formatLocalized() 和 diffForHumans() 默认输出英文——这两点上线后最容易被忽略，且一出问题就是整站时间偏移或中文变英文。
- 不要依赖
date_default_timezone_set()全局设时区，它影响所有 DateTime 实例，不可控 - 推荐每次实例化时显式传时区：
Carbon::now('Asia/Shanghai')或Carbon::parse($input)->tz('Asia/Shanghai') - 中文本地化要两步：先
Carbon::setLocale('zh');，再调用->translatedFormat('Y年m月d日')或->diffForHumans() -
Carbon::setTestNow()是测试专用，别在生产环境调用
真正难的从来不是敲下那条 composer require，而是后续每一步是否都绕开了柔化、时区、命名空间、版本这几道暗坑——尤其当你的业务要算“上个月最后一天”或者“节假日顺延”时，差一秒都可能让账单或提醒出错。
