本文介绍一种非标准但实用的 php 方法，用于将解码后再修改的 json 数组以“换行分隔、括号独占行”的类原始风格重新编码为字符串，避免默认 `json_encode()` 生成的单行紧凑格式。
在处理 JSON 文件时，开发者常希望保留可读性良好的多行格式（如每条 JSON 对象独占一行、方括号独立成行），尤其在人工编辑或版本控制场景中。然而，PHP 原生 json_encode() 默认输出紧凑单行格式（如 [{"id":"1","name":"john"},...]），即使传入 JSON_PRETTY_PRINT 也仅提供缩进式美化，无法实现「每对象一行 + 外层括号独立」的特定排版。
要达成目标格式：
[
{"id": "1", "name": "john", "bd": []},
{"id": "2", "name": "gary", "bd": [1, 2]}
]关键在于：不依赖 json_encode() 的整体格式化能力，而是手动拼接外层结构，对每个数组元素单独调用 json_encode() 并换行连接。
以下是一个健壮的实现方案（兼容 PHP <8.1）：
立即学习“PHP免费学习笔记（深入）”；
// PHP <8.1 兼容 array_is_list() polyfill
if (!function_exists('array_is_list')) {
function array_is_list(array $a): bool {
return $a === [] || (array_keys($a) === range(0, count($a) - 1));
}
}
function json_encode_oneline_per_item(array $data): string {
if (!array_is_list($data)) {
throw new InvalidArgumentException('Input must be a JSON array (sequential list), not an associative object.');
}
// 对每个元素单独编码（无额外空格，保证内部紧凑）
$encodedItems = array_map(fn($item) => json_encode($item, JSON_UNESCAPED_UNICODE), $data);
// 拼接：换行分隔，前后包裹换行后的方括号
return "[\n" . implode(",\n", $encodedItems) . "\n]";
}
// 示例使用
$json_text = '
[
{"id": "1", "name": "john", "bd": []},
{"id": "2", "name": "gary", "bd": [1, 2]}
]';
$data = json_decode($json_text, true);
$data[1]['name'] = 'bill'; // 修改数据
$result = json_encode_oneline_per_item($data);
echo $result;输出结果严格匹配预期：
[
{"id":"1","name":"john","bd":[]},
{"id":"2","name":"bill","bd":[1,2]}
]⚠️ 重要注意事项：
- 此方法生成的 JSON 语法完全合法，但属于「人为定制格式」，不应替代标准 JSON 工具链；
- json_encode() 默认已处理 Unicode、引号转义、特殊字符等安全问题，本方案复用它保障内容安全性；
- 若需支持嵌套数组/对象的深度美化（如 bd 内部也换行），需递归实现 —— 但会显著增加复杂度，强烈建议此时改用 jq 或 VS Code 插件等专业工具进行后处理；
- 生产环境应始终以标准 json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT) 作为默认输出；仅在明确需要 Git 友好 diff 或人工可读日志时，才按需启用此类定制格式。
总之，格式是表象，语义与安全才是核心。让 PHP 负责正确性，让专业工具负责可读性——这是更可持续的实践路径。
