在 ThinkPHP 6.0 中应使用 dump() 替代 var_dump，因其美化输出、不中断执行且仅调试模式生效；配合 Trace 调试面板、结构化日志（Log::debug）及 Xdebug 断点调试可安全高效定位问题。
在 ThinkPHP 6.0 开发中，直接使用 var_dump 输出变量会中断响应、破坏 JSON 格式、暴露敏感数据，还可能因未关闭调试代码导致线上报错。
用 dump() 替代 var_dump
ThinkPHP 自带的 dump() 函数支持美化输出、自动判断是否为 CLI 环境、不中断执行流程。
在控制器或模型中直接调用：dump($data);
该函数默认仅在调试模式（app_debug = true）下生效，生产环境自动静默，无需手动注释或删除。
开启调试面板：Trace 和 Log 实时查看
确保配置文件 config/app.php 中已启用：
'trace' => true, 和 'log' => ['level' => ['error', 'info', 'debug']]
访问页面后，右下角会出现可折叠的调试面板图标，点击即可查看本次请求的 SQL 查询、路由匹配、中间件执行顺序、变量快照等信息。
【必须确保浏览器未禁用 XHR 请求，否则面板无法加载数据】
向日志写入结构化调试信息
方法一：使用 think\facade\Log 写入带上下文的调试行
Log::debug('用户登录验证开始', ['user_id' => $uid, 'ip' => request()->ip()]);
这行会生成带时间戳、级别、上下文数组的结构化日志，存于 runtime/log/年月/日.log，比 echo 更易检索和分析。
方法二：临时写入独立调试文件，避免污染主日志
file_put_contents(runtime_path() . 'debug_trace.txt', print_r($data, true) . "\n\n", FILE_APPEND | LOCK_EX);
注意：此方式绕过日志驱动，不推荐长期使用，仅限快速定位某段逻辑时临时插入。
断点调试：配合 PhpStorm + Xdebug 完整走查请求链路
第一步：确认 PHP 已启用 xdebug 扩展，且 xdebug.mode=debug，xdebug.client_host=host.docker.internal（Docker 环境）或 127.0.0.1（本地）
第二步：在 PhpStorm 中打开 Preferences → Languages & Frameworks → PHP → Debug，校验 DBGp Proxy 设置与端口一致
第三步：在控制器方法开头打上断点，点击右上角「Start Listening for PHP Debug Connections」按钮，再刷新浏览器请求
此时代码会在断点处暂停，可逐行步入（F7）、查看所有作用域变量、修改变量值、执行表达式——这是定位复杂嵌套逻辑最可靠的方式。
【Xdebug 必须与当前 PHP 版本严格匹配，版本错位会导致 PHP-FPM 进程崩溃】
