trae启动PHP脚本无输出，主因是output buffering未关闭且未刷新；需在脚本开头加ob_implicit_flush(true)和ini_set('output_buffering','off')，每条输出后调用flush()和ob_flush()。
trae 启动 PHP 脚本后终端没任何输出，连 echo 都不显示？
大概率是 trae 默认启用了缓冲（output buffering），且未显式刷新。PHP CLI 模式下 echo 或 print 的内容会先写入内存缓冲区，等脚本结束或缓冲满才真正输出——而 trae 有时在进程退出前就切断了 stdout 连接，导致你完全看不到输出。
实操建议：
- 在 PHP 脚本开头立即加
ob_implicit_flush(true);和ini_set('output_buffering', 'off'); - 每条调试输出后紧跟
flush();和ob_flush();（顺序不能反） - 避免用
var_dump()直接输出大数组——它可能触发隐式缓冲，改用print_r($data, true)+echo+flush() - 确认
trae启动命令里没加--quiet或重定向了stdout到文件/空设备
用 trae run 执行 PHP 时看到 PHP Warning: Cannot modify header information 却没其他输出？
这个警告本身是 PHP 在 CLI 模式下不该出现的——说明你的脚本或引入的库（比如某些旧版 Laravel Helper、WordPress 兼容层）偷偷调用了 header() 或开启了 session。CLI 下无 HTTP 上下文，header() 失败会触发 warning 并可能中断后续输出逻辑。
排查路径：
立即学习“PHP免费学习笔记（深入）”；
构建并排查Microsoft Word邮件合并及DOCX模板工作流，使用合并域、内容控件、文档属性、重复区块、数据等
- 运行
trae run --php-args="-d display_errors=1 -d error_reporting=-1" your-script.php强制显示所有错误 - 在脚本最顶部加
error_reporting(E_ALL); ini_set('display_errors', '1');，确保错误不被静默吞掉 - 搜索代码中所有
header(、session_start(、setcookie(，CLI 场景下应跳过或 mock - 如果依赖框架，检查是否误加载了 Web 入口逻辑（如
public/index.php被当 CLI 脚本执行）
为什么 trae logs 里看不到 PHP 的 var_dump() 或 error_log()？
trae logs 默认只捕获标准输出（stdout）和标准错误（stderr）的原始流。但 PHP 的 error_log($msg) 默认写入 Web 服务器错误日志（CLI 下可能写到 /tmp/php-errors.log 或丢弃），而 var_dump() 在 CLI 下虽输出到 stdout，但若缓冲未刷、或被 trae 的日志采集时机错过，就无法出现在 trae logs 流中。
可靠做法：
- 把调试信息统一导向
stderr：用error_log("debug: " . print_r($x, true), 4);（4表示STDERR） - 禁用所有 output buffering：启动时加
-d output_buffering=0 -d implicit_flush=1 - 确认
trae版本 ≥ v0.8.3——老版本对stderr捕获不稳定，升级可解决部分丢失问题 - 临时绕过
trae logs，直接用trae run --no-tty your-script.php 2>&1 | cat -查看实时流
PHP 脚本在 trae 里能跑，但加了 xdebug 就彻底没输出？
Xdebug 3+ 默认开启 xdebug.output_buffering = 0，看似应该不缓冲，但它同时默认启用 xdebug.mode=debug 时会劫持所有输出流做格式化，而 trae 的进程封装层可能无法正确传递 Xdebug 的特殊输出协议帧，导致终端“黑屏”。
解法很直接：
- 关闭 Xdebug 的输出干预：
trae run --php-args="-d xdebug.mode=off" script.php - 若必须用调试，改用
xdebug.mode=develop（仅影响开发辅助函数，不干扰输出） - 不要在 CLI 脚本里调
xdebug_break()——它会阻塞等待 IDE 连接，trae通常不提供调试通道，结果就是卡死无输出 - 验证 Xdebug 是否真被加载：
trae run --php-args="--ri xdebug"，避免配置错位白忙
最易被忽略的一点：trae 对子进程的 stdout/stderr 是按块读取的，不是行缓冲。哪怕你 flush 了，如果输出内容不足一个内核 pipe buffer（通常 64KB），也可能卡在中间不动——所以调试时别吝啬换行符，每条 echo 结尾加 \n，这是比调参数更稳的保底手段。
