直接用 composer require php-console-table 安装，但需手动实例化 Table 类并调用 setHeaders() 和 setData() 才能渲染表格，注意版本兼容性、UTF-8 编码及宽度设置以避免输出错位。
直接用 composer require 就能装，但默认不带命令行入口，得手动调用类或写个简易脚本才能渲染表格。
安装 php-console-table 时要注意 autoload 和版本兼容性
这个库在 Packagist 上叫 php-console-table，不是 console-table 或其他变体。PHP 7.4+ 可用最新版（v2.x），PHP 7.2–7.3 建议锁定 "php-console-table": "^1.2"，否则会报 Declaration of ConsoleTable\Table::render() must be compatible 类型声明错误。
执行安装命令：
composer require php-console-table
安装后检查 vendor/autoload.php 是否存在，这是后续加载类的前提。
立即学习“PHP免费学习笔记（深入）”；
手动实例化 Table 类并传入二维数组数据
它不提供全局命令行命令（比如 php-table --data=...），必须自己写 PHP 脚本调用 ConsoleTable\Table 类。常见错误是直接 new 一个空 Table 后没 setHeaders 或 setData，导致输出空白或报 Undefined index: headers。
- 必须先调用
$table->setHeaders($headers)，哪怕只是空数组 -
$table->setData($rows)接收的是二维索引数组，不是关联数组；若传关联数组，列顺序会乱，且表头不会自动提取 - 支持 UTF-8 中文，但终端需启用 UTF-8 编码（Linux/macOS 一般默认 OK，Windows CMD 需先执行
chcp 65001）
最小可用示例：
<?php
require 'vendor/autoload.php';
use ConsoleTable\Table;
$table = new Table();
$table->setHeaders(['ID', 'Name', 'Status']);
$table->setData([
[1, 'Alice', 'active'],
[2, 'Bob', 'inactive'],
]);
echo $table->render();
避免 CLI 输出被缓冲或截断的几个实际细节
在某些 CI 环境或重定向输出时（如 php table.php > out.txt），表格边框可能错位，原因是 render() 默认按终端宽度自动换行，而管道中 exec('tput cols') 失败，fallback 宽度为 80，但内容超宽就会折行破坏结构。
- 可显式设置宽度：
$table->setWidth(120)，再调用render() - 禁用自动换行：
$table->setAutoWrap(false)，适合导出纯文本场景 - 如果用
print_r()或var_dump()调试数据结构，注意它们会干扰表格输出格式，建议用echo json_encode($data, JSON_UNESCAPED_UNICODE)查看原始结构
真正麻烦的不是装库，而是每次都要手写那几行初始化代码——没封装成命令就等于没真正接入 CLI 工作流。如果项目里频繁用，值得抽个简单 wrapper 函数或加到 bin/ 下做成可执行脚本。
