先给出一个核心判断：php-console-highlighter 这个老旧的 PHP 终端高亮库，已经不适合在生产环境中使用。它被从 Packagist 下架并非偶然——项目长期停更、不支持现代 PHP 版本，甚至连最基本的 Composer 自动加载机制都没有适配。如果你还在为“如何通过 Composer 引入这个库”而烦恼，大概率会在第一步就卡住。
下面这张图展示了在终端里使用高亮库输出代码的效果，但当前的关键问题是如何正确实现这一功能，而不是死磕一个已经废弃的库。
直接 require 会报错：找不到 php-console-highlighter 包
原因很明确：这个库在 Packagist 上已被标记为废弃，官方推荐迁移到 nikic/php-parser 配合 symfony/console 自行渲染代码高亮，或者改用更活跃的替代方案，比如 graham-campbell/exceptions（自带终端高亮）或 spiral/console。但如果你确实需要原库的行为——比如维护旧项目——那就比较棘手：它实际托管在 GitHub 上，并未发布到 Packagist。因此执行 composer require php-console-highlighter 必然失败。
- 运行后提示
Could not find package php-console-highlighter - 原始仓库
https://github.com/barbushin/php-console-highlighter缺少composer.json元数据，也不支持 PSR-4 自动加载 - 即便强行通过
"repositories"指向 GitHub 并设置"minimum-stability": "dev"，拉取下来的代码也不会自动注册到 autoload 中——后续调用new ConsoleHighlighter()仍然会报Class not found
正确做法：改用 phpstan/phpstan 内置的高亮器或手动集成 rainbow
真正稳定、轻量且专为终端设计的 PHP 代码高亮库是 rainbow（clue/rainbow）。它不依赖任何框架，采用纯函数式设计，输出 ANSI 转义序列，维护活跃，比原库更可靠，集成也更简单。
- 直接运行
composer require clue/rainbow即可完成安装 - 使用时无需实例化类，直接调用静态方法：
Rainbow::highlight($code, 'php') - 它支持
php、json、html等常见语言，底层基于正则表达式进行粗略着色——对 CLI 场景完全够用，且性能开销极低 - 唯一需要注意的是：终端必须支持 ANSI（Linux/macOS 默认支持；Windows 10+ 需启用虚拟终端，或借助
ANSICON）
如果非要硬上原库：手动下载 + 手动加载
这种方法只适合调试或临时脚本，绝对不建议用于生产环境。原库只有一个 ConsoleHighlighter.php 文件，没有命名空间，完全依赖 require_once 加载。
- 从
https://raw.githubusercontent.com/barbushin/php-console-highlighter/master/ConsoleHighlighter.php下载该文件 - 保存为
vendor/barbushin/console-highlighter/ConsoleHighlighter.php（路径可自定义，但需保持一致） - 在代码顶部添加：
require_once __DIR__ . '/vendor/barbushin/console-highlighter/ConsoleHighlighter.php'; - 调用方式：
$highlighter = new ConsoleHighlighter(); echo $highlighter->highlight('', 'php'); - 缺点也很明显：无法被 Composer autoloader 管理；在 PHP 8+ 环境下可能触发
Deprecated: Methods with the same name as their class will not be constructors（因为类名与构造方法同名）
输出前务必检查终端是否支持颜色
rainbow 或任何 ANSI 高亮库，如果终端不支持颜色，会输出一堆乱码（比如 33[32m）。这一步绝对不能跳过。
- 用
stream_isatty(STDOUT)判断标准输出是否连接终端（而非重定向到文件） - 再结合环境变量：
getenv('NO_COLOR') === '1'或getenv('TERM') === 'dumb'时强制禁用颜色 - 示例封装：
function safeHighlight(string $code, string $lang = 'php'): string {
if (!stream_isatty(STDOUT) || getenv('NO_COLOR') === '1') {
return $code;
}
return Rainbow::highlight($code, $lang);
}
原库被废弃并非偶然——它没有适配现代 PHP 生命周期，也未处理 Windows 终端兼容性。真正需要终端高亮时，clue/rainbow 是目前最省心的选择；如果已有大量旧代码依赖 ConsoleHighlighter 类名，手动 require 是唯一可行路径，但必须自行处理 PHP 版本兼容和错误兜底。
