如何通过Composer引入 PHP-Console-Highlighter 库在终端中高亮显示代码段

作者：袖梨 2026-07-13

PHP-Console-Highlighter已废弃，官方推荐迁移到php-parallel-lint/PHP-Console-Highlighter或更活跃的替代方案如clue/rainbow；原库未发布至Packagist，直接composer require会失败，需手动下载或改用现代轻量库。

直接 require 会报错：找不到 `php-console-highlighter` 包

因为这个库在 Packagist 上已废弃，官方推荐迁移到 php-console-highlighter 的继任者 —— nikic/php-parser 配合 symfony/console 自行渲染，或改用更活跃的替代方案 graham-campbell/exceptions（含终端高亮）或 spiral/console。但如果你明确需要原 php-console-highlighter 的行为（比如旧项目兼容），它实际托管在 GitHub，未发布到 Packagist，所以 composer require php-console-highlighter 必然失败。

运行 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 转义序列，且维护活跃。它比原 php-console-highlighter 更可靠，也更易集成。

执行 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 echo 1; ?>', 'php');
缺点：无法被 Composer autoloader 管理；PHP 8+ 可能触发 Deprecated: Methods with the same name as their class will not be constructors（因类名与构造方法同名）