Carbon需显式引入命名空间或用完整路径调用，v3要求PHP≥8.1且移除setTestNow()无参用法，本地化需intl扩展、symfony/translation包及系统locale配合。

Carbon 不是独立安装的“库”，而是 Laravel 框架默认集成的日期处理扩展，直接 composer require nesbot/carbon 就能用——但多数人装完发现 Carbon::now() 报错，问题不在安装，而在自动加载或命名空间没配对。

为什么 composer require nesbot/carbon 后仍报 Class 'Carbon' not found

这是最常卡住的地方：Carbon 本身不注册全局类名，必须显式引入或使用完整命名空间。

• 错误写法：echo Carbon::now();（未 use、未前缀）
• 正确写法一（推荐）：use Carbon\Carbon; + echo Carbon::now();
• 正确写法二（临时）：echo \Carbon\Carbon::now();（带根命名空间）
• 如果你在 Laravel 项目里，AppServiceProvider 中已自动别名了 Carbon，但纯 PHP 项目或非 Laravel 环境不会自动做这事

Carbon v2 和 v3 的关键兼容差异

v3（2023 年起默认）要求 PHP ≥ 8.1，且移除了静态工厂方法如 Carbon::createFromDate()；v2 仍支持 PHP 7.3+，但已停止维护。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 装 v2（兼容旧项目）：composer require nesbot/carbon:^2.72
• 装 v3（新项目首选）：composer require nesbot/carbon（当前最新即 v3）
• v3 中 Carbon::parse('next Monday') 仍可用，但 Carbon::now()->addDays(3)->toDateString() 这类链式调用行为一致，不用重写逻辑
• 注意：v3 移除了 Carbon::setTestNow()，改用 Carbon::setTestNow($date)（参数必传），漏传会抛 TypeError

在非 Laravel 项目中启用 Carbon 的本地化（中文/日语等）

Carbon 默认只加载英文语言包，Carbon::setLocale('zh') 无效，除非你手动引入翻译文件。

• 先确保已安装 intl 扩展（PHP 配置中启用 extension=intl）
• 执行：composer require symfony/translation（v3 必需，v2 可选）
• 代码中加：use Carbon\Carbon; + Carbon::setLocale('zh'); + echo Carbon::now()->diffForHumans();（输出“1秒前”）
• 若仍显示英文，检查是否漏了 setlocale(LC_TIME, 'zh_CN.UTF-8') ——Carbon 依赖系统 locale 做部分格式化，尤其 formatLocalized()

Carbon 的坑不在安装命令，而在于命名空间引用、PHP 版本绑定、以及本地化时 intl 扩展和系统 locale 的隐式依赖——这三个点没对齐，装十遍也白搭。