应选 symfony/console：php 8.0+ 用 ^6.4，php 7.4 用 ^5.4；颜色能力内置，无需额外配色包，且需确保命令通过 application::run() 执行而非直调 run() 方法。
composer require 时该选哪个包？
Symfony CLI 彩色输出能力来自 symfony/console 自身，不是靠额外“配色包”。你不需要装 symfony/var-dumper 或 monolog/monolog 来开颜色——只要 symfony/console 版本 ≥ 4.2（推荐 ≥ 5.4 或 ≥ 6.2），默认就支持 ANSI 颜色，且自动检测终端是否支持。
常见错误是误以为要加 symfony/color 这类不存在的包，或者去装旧版 symfony/console（如 3.4）却没意识到它默认关闭颜色、需手动启用。
- PHP 8.0+ 项目：直接
composer require symfony/console:^6.4（稳定、颜色开箱即用） - 仍用 PHP 7.4 的项目：选
symfony/console:^5.4（5.4 是最后一个支持 7.4 的大版本） - 别用
^4.4—— 它虽支持颜色，但默认Terminal::hasColorSupport()返回false，容易白忙活
为什么 $output->writeln('ok ') 没颜色？
这是最常卡住的地方：标签语法本身没问题，但实际生效依赖两个条件——命令类必须继承 Command，且调用时必须走 Symfony 的执行流程（即通过 Application run），不能直接 new Command()->run()。
错误写法示例：
$cmd = new MyCommand();<br>$cmd->run(new ArrayInput([]), new NullOutput());
这种绕过
Application 的调用，OutputFormatter 不会初始化，<info></info> 标签直接原样输出。
- 确保命令注册到
Application实例后调用$app->run() - 测试时用
php bin/console my:command --env=test，而不是直调方法 - 临时调试可强制启用：
$output->getFormatter()->setDecorated(true)，但只是补救，不解决根本路径问题
Windows CMD / Git Bash 下颜色不显示怎么办？
Windows 旧版 CMD 默认禁用 ANSI 转义序列，不是你的代码或 Composer 配置错了。Git Bash 通常 OK，但某些 Windows 终端（如 VS Code 集成终端旧版）也可能关了颜色支持。
关键不是降级依赖，而是让终端配合：
- Win10 1607+：管理员运行
reg add HKCU\Console /v VirtualTerminalLevel /t REG_DWORD /d 1，重启终端 - VS Code：设置里搜
terminal.integrated.env.windows，加"TERM": "xterm-256color" - CI 环境（如 GitHub Actions）：默认无 TTY，
<info></info>标签会被自动 strip，此时应改用$output->isDecorated()判断后分支处理
如何安全地降级或锁定 console 版本？
如果你被迫维护老项目（比如 Laravel 6.x 锁死 symfony/console:^4.3），别硬升——4.3 的 OutputFormatter 对 <fg></fg> 解析不全，<error></error> 可能失效。
更稳妥的做法是：保持原有版本，用底层 ANSI 字符兜底。
- 不用标签，直接拼接：
$output->writeln("\033[31mError!\033[0m"); - 封装小工具函数，只在
$output->isDecorated()为 true 时才输出 ANSI - 升级前务必检查所有自定义
OutputFormatter子类——5.0+ 把Style类拆得更细，getErrorStyle()行为有变
颜色不是装饰，是 CLI 应用的可读性基础设施；但它的稳定依赖终端、PHP 版本、console 版本三者对齐，缺一不可。最容易被忽略的是：你以为在调命令，其实没进 Application 生命周期。
