suggest 字段仅在安装成功后显示提示，不自动安装包；其值必须为字符串说明，包名需准确且带 ext- 前缀，PHP 扩展名不可省略；提示仅在非静默模式下输出，CI/CD 默认禁用；README、post-install 脚本或专用脚本可增强提示效果。
suggest 字段根本不会安装任何包，它只是装完后弹一行提示
。很多人看到
"monolog/monolog": "用于记录调试日志"
就以为加了这个字段，项目跑起来就能自动用上 Monolog——结果运行时直接报
Class 'Monolog\Logger' not found
。这不是 Composer 漏装，而是你误解了它的作用。
composer
.json 里怎么写 suggest 字段
直接在根级加一个
suggest
键，值是对象，每个键必须是合法包名（如
monolog/monolog
），值只能是字符串说明，不能带版本号、不能是数组或布尔值。
错误写法：
"monolog/monolog": "^3.0"
→ Composer 解析失败
错误写法：
"ext-redis": true
→ 布尔值不被接受，必须是字符串，比如
"ext-redis": "启用 Redis 缓存驱动"
包名要拼对：
guzzlehttp/guzzle
不是
guzzle/guzzle
，
psr/cache
不是
psr-cache
PHP 扩展名必须带
ext-
前缀，否则会被当包名处理（而 Packagist 上没有
gd
这个包）
为什么装完没看到 suggest 提示
默认只在
composer install
或
composer update
成功结束后输出，且要求非静默模式。以下情况会导致提示消失：
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
用了
--quiet
、
--no-ansi
，或命令被重定向（如
> /dev/null
）
执行的是
composer require some/package
，但该包自身的
suggest
只在它被首次安装时触发输出——后续再
require
其他包，不会重新刷出它的
suggest
CI/CD 中默认加了
--no-suggest
，这是有意为之，不是配置错了
终端滚动太快导致提示被刷走？加
composer install --verbose
能把输出放慢，或用
composer install 2>&1 | tail -20
快速回溯
如何让用户真正注意到并装上建议包
suggest
本身不解决“没人看”的问题，它只是个安静的文本字段。想让它起作用，得靠外部手段补位：
最轻量有效的方式是在
README.md
顶部复述
suggest
内容，并附带可复制的命令：
composer require monolog/monolog
在
post-install-cmd
脚本里用 PHP 解析
vendor/composer/installed.json
，筛选出刚装的包的
suggest
，然后
echo
加粗提示（用
\033[1;33m
ANSI 色码）
提供
bin/install-suggested
可执行脚本，列出所有未安装的建议包，支持交互式选择（需用户手动运行）
别依赖
composer show --all
查
suggest
——它输出太杂，要用
php -r ''
脚本直读
installed.json
才准
最容易被忽略的一点是：Composer 只读取项目根目录下的
composer.json
的
suggest
，不会递归合并依赖包里的
suggest
。你在库 A 里写了
suggest
，然后把 A 装进项目 B，B 的安装输出里根本看不到 A 的建议——因为 A 的
suggest
被完全忽略了。
