composer安装league/iso3166失败主因是php版本（v4.0.0+需≥8.1，旧版用v3.1.0）、composer版本（v1需升级至v2）、镜像源同步问题；引入后需确保autoload.php已加载、命名空间拼写正确；查码时注意大小写与空格校验严格，中文名仅支持简体；推荐用findbyalpha2而非findbyname提升稳定性。
Composer 安装 league/iso3166 失败：常见报错和解决路径
直接运行 composer require league/iso3166 大概率失败，不是包不存在，而是 PHP 版本或 Composer 自身版本不匹配。
- 该包最新版
v4.0.0+要求 PHP >= 8.1；若你用 PHP 7.4 或 8.0，得降级到v3.1.0 - Composer v1 用户会遇到
Your requirements could not be resolved—— 升级到 Composer v2 是最省事的解法（composer self-update） - 国内镜像源有时不同步，临时切回官方源：
composer config -g repo.packagist composer https://packagist.org
引入后调用 League\ISO3166\ISO3166 报类未找到
安装成功 ≠ 自动可用。这个包不提供全局函数，必须手动 require 或走自动加载。
- 确认
vendor/autoload.php已在脚本开头引入（漏掉这行是最高频错误） - 命名空间拼写必须完整：
new \League\ISO3166\ISO3166()，少一个反斜杠或大小写错（如iso3166）都会报Class 'League\ISO3166\ISO3166' not found - 如果用在 Laravel 等框架里，不需要额外
require，但首次使用前建议跑一次composer dump-autoload
查国家码时 alpha2 和 alpha3 返回空数组
不是数据缺失，是输入值校验比想象中严格：大小写、空格、编码都影响匹配结果。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
$iso->alpha2('CN')可以，但$iso->alpha2('cn')或$iso->alpha2(' CN ')全部返回空数组 - 中文名搜索只支持简体（如
$iso->findByName('中国')），不支持「中华人民共和国」或「China」 - 用
$iso->all()查全量数据时注意性能：返回约 250 条记录，别在循环里反复调用
想把国家码转成中文名，但 findByName 不稳定
这个方法本质是模糊匹配，靠字符串包含判断，不是精确查表。
- 推荐改用
findByAlpha2('US')→ 得到数组后取['name']字段，稳定且快 - 如果只有中文名要反查码，先用
$iso->all()缓存一次，再用array_filter手动匹配，避免多次遍历 - 注意港澳台地区：HK、MO、TW 都存在，但返回的
name是英文（Hong Kong、Macao、Taiwan），没有内置简体中文映射
真正麻烦的是 ISO 标准本身有多个版本，这个包固定用 ISO 3166-1:2020，但有些业务系统沿用旧版（比如去掉某些争议地区）。别指望靠换包解决，得自己建映射表兜底。
