composer suggests不是合法命令，会报错；真正可用的是composer show vendor/package（需已安装）或解析vendor/composer/installed.json获取完整suggests内容。
suggests 字段不触发任何自动行为，它唯一的作用是“让人看见可选功能的存在”——但这个“看见”本身就很脆弱，容易被忽略或误读。
为什么运行 composer suggests 会报错
因为这根本不是 Composer 的合法命令。官方从未提供 composer suggests，执行时必然返回 Command "suggests" is not defined。你真正能用的只有 composer show vendor/package，前提是该包已安装在当前项目中。
- 如果包没装过，
composer show直接提示 “Package not found” - 即使装了，
composer show --installed也不会显示suggests，它只列包名和版本 - 终端输出的
suggests提示仅出现在composer require或首次composer install时；后续update若无新包加入，就不会再刷出来 - CI/CD 流水线里加了
--no-interaction或重定向 stdout，这些提示就彻底消失了
如何查到所有已安装包的 suggests 内容
真实数据藏在 vendor/composer/installed.json 里，不是靠命令拼凑，而是直接读 JSON。
- Linux/macOS 下可用
jq快速提取：jq -r '.packages[] | select(.suggests) | "\(.name) → \(.suggests | to_entries[] | "\(.key): \(.value)")"' vendor/composer/installed.json - 没装
jq？用 PHP 脚本更稳妥：php -r '$i = json_decode(file_get_contents("vendor/composer/installed.json"), true); foreach ($i["packages"] as $p) { if (!empty($p["suggests"])) { echo $p["name"] . ":\n"; foreach ($p["suggests"] as $k => $v) echo " - $k: $v\n"; } }' - 别信
composer show monolog/monolog输出末尾那几行——多行说明会被截断，且颜色浅、易漏看；JSON 才是唯一完整来源
suggests 里的 ext-xxx 和普通包名怎么区分
键名是否带 ext- 前缀，决定了它是 PHP 扩展还是 Composer 包，处理方式完全不同。
-
"ext-gd": "Required for image processing"→ 表示需系统级启用 GD 扩展，检查用php -m | grep gd，安装靠系统包管理器或编译 PHP，不是composer require -
"symfony/cache": "Enables PSR-6 caching layer"→ 是标准 Composer 包，确认代码里真调用了CacheInterface相关逻辑后再装，否则只是冗余依赖 - 写错成
"gd": "..."（漏ext-）？Composer 会当真去 Packagist 找gd这个包，结果当然是 404
代码里怎么安全响应 suggests 推荐的功能
不能假设用户一定装了建议项，必须运行时检测 + 降级处理。
- 检测扩展是否存在：
extension_loaded('redis')，而不是class_exists('Redis')（后者可能被其他包提前加载） - 检测类是否存在：
class_exists(\Monolog\Logger::class)，注意带完整命名空间 - 检测函数是否存在：
function_exists('mb_strlen')，尤其对ext-mbstring这类核心扩展 - 不要抛出模糊异常，比如 “Cache not available”，而应提示 “Install symfony/cache and call CacheManager::enableSymonfyCache() to enable PSR-6 support”
最常被跳过的一步：很多库写了 suggests，却没在代码里做任何检测逻辑——结果就是建议白给，功能永远无法激活。真正的引导意义，不在 composer.json 里那一行文字，而在运行时那几行 if (class_exists(...)) 的判断。
