php json_encode() 默认输出紧凑单行json，需显式传入json_pretty_print选项才能换行缩进；若还需中文不转义，应追加json_unescaped_unicode；生产环境接口不应启用格式化，且必须设置header('content-type: application/json; charset=utf-8')。
PHP json_encode() 默认不换行，必须显式启用格式化
PHP 原生 json_encode() 输出是紧凑的单行字符串（如 {"name":"a","age":25}），不带缩进和换行。想让 JSON 可读，得传入 JSON_PRETTY_PRINT 选项——这是唯一可靠且标准的方式。
- 错误做法：手动拼接
\n或空格，会破坏 JSON 合法性 - 正确写法：
json_encode($data, JSON_PRETTY_PRINT) - 若还需中文不转义（如显示“张三”而非
"\u5f20\u4e09"），追加JSON_UNESCAPED_UNICODE：json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) - 注意：开启格式化后体积明显增大，生产环境接口返回时一般**不应使用**，仅用于调试或前端展示
输出到浏览器时，Content-Type 必须设为 application/json
即使 JSON 格式正确，如果 HTTP 响应头没声明类型，浏览器可能当纯文本渲染，导致换行/缩进被忽略或显示异常。
- 务必在
json_encode()前加：header('Content-Type: application/json; charset=utf-8'); - 避免用
text/plain或漏掉charset=utf-8，否则中文可能乱码，缩进也可能被 HTML 解析器吃掉 - 若用框架（如 Laravel、ThinkPHP），通常封装了响应方法，直接 return JSON 即可，但底层仍依赖这个 header
命令行调试时，json_encode() 换行在终端里可能“看不见”
CLI 环境下执行 php script.php，即使用了 JSON_PRETTY_PRINT，换行符 \n 是存在的，但某些终端或 IDE 控制台默认不自动折行或高亮，看起来像挤在一起。
- 验证是否真有换行：用
var_dump(json_encode($data, JSON_PRETTY_PRINT));，看输出中是否含\n字符 - 更直观方式：重定向到文件再查看：
php script.php > output.json && cat -A output.json（cat -A显示隐藏字符） - 别依赖 IDE 内置控制台“视觉换行”，它常做自动排版，干扰判断
第三方库（如 Symfony Serializer）默认不格式化，需单独配置
如果你没直接用 json_encode()，而是通过组件序列化对象（比如 Doctrine 实体 + Symfony Serializer），它的默认行为是紧凑 JSON，不自动换行。
立即学习“PHP免费学习笔记（深入）”；
- Symfony Serializer 示例：
$serializer->serialize($obj, 'json', ['json_encode_options' => JSON_PRETTY_PRINT]) - Laravel 的
response()->json()默认不格式化；如需美化，得手动传参：response()->json($data, 200, [], JSON_PRETTY_PRINT) - 所有封装都绕不开 PHP 底层的
json_encode()选项，记住这个源头，排查就快得多
