直接安装 php-var-dumper 会失败，因其未发布在 Packagist 上且无 composer.json；应手动下载 VarDumper.php 并 require_once 引入，调用 VarDumper::dump()，避免与 xdebug 等工具冲突；推荐改用 symfony/var-dumper 或 kint-php/kint 等活跃 Composer 包。
直接安装 php-var-dumper 会失败，因为它不是标准 Composer 包
php-var-dumper 并未发布在 Packagist 上，也没有 composer.json 元数据，所以执行 composer require php-var-dumper/php-var-dumper 会报错 Package php-var-dumper/php-var-dumper not found。它本质是一个轻量级单文件调试工具，作者未走标准包发布流程。
手动引入方式最稳妥，且能避开 autoloader 冲突
该库只有一个核心文件 VarDumper.php，推荐直接下载并 require 进项目：
- 从 GitHub 仓库（robinvdvleuten/php-var-dumper）下载最新版
VarDumper.php - 存入项目目录，例如
vendor/robinvdvleuten/var-dumper/VarDumper.php - 在需要调试的脚本顶部添加：
require_once __DIR__ . '/vendor/robinvdvleuten/var-dumper/VarDumper.php';
- 调用时用
VarDumper::dump($var)或VarDumper::dumpExit($var)
不建议用 autoload.files 注册，因为它的 dump() 函数会覆盖全局同名函数，容易和 xdebug 或其他调试工具冲突。
替代方案：用更活跃的 composer 包实现相同效果
如果你坚持走 Composer 流程，可改用功能重叠、维护更积极的包：
立即学习“PHP免费学习笔记（深入）”；
-
symfony/var-dumper：支持彩色输出、交互式展开、CLI/Web 双模式，需额外配置Symfony\Component\VarDumper\VarDumper::setHandler()控制输出行为 -
kint-php/kint：提供Kint::dump()和dd()，默认启用 HTML 输出，适合 Web 环境 - 注意：两者都依赖
ext-mbstring，若 CLI 环境无该扩展，symfony/var-dumper的dump()可能退化为纯文本，但不会报错
调试输出被截断或乱码？检查输出上下文和字符编码
php-var-dumper 默认使用 UTF-8 编码和 ANSI 颜色序列，但在某些终端或 CGI 环境下可能失效：
- CLI 下运行时，确保终端支持 ANSI，Windows 用户建议用 Windows Terminal 或 Git Bash
- Web 环境中，若页面显示方块或乱码，确认响应头已设
Content-Type: text/html; charset=utf-8 - 若变量含大量嵌套对象或资源（如
mysqli），php-var-dumper 默认深度限制为 5 层，可通过修改$maxDepth属性调整，但不要设为无限 —— 容易触发内存溢出
真正麻烦的是资源类型和闭包的处理：php-var-dumper 不递归展开资源，也不尝试序列化闭包，这点比 symfony/var-dumper 更保守，但反而更安全 —— 尤其在线上环境临时加 dump 时，不容易意外触发资源释放或作用域异常。
