理解 Node.js JSON 序列化的挑战
在使用 Node.js 处理 JSON 文件时，一个常见场景是从 JSON 读取数据，修改后重新写入。对于标准 JSON 格式而言，数字（包括科学计数法表示的数字）在解析时会被转换为 JavaScript 的 Number 类型，而在序列化时则会以其最精确的数字形式输出。例如，2.421500000000000e+04 这样的科学计数法数字，在 JSON.parse 后会成为一个普通的 JavaScript 数字 24215。当使用 JSON.stringify 重新序列化时，它可能会被输出为 24215 而非原始的科学计数法格式，更无法保留固定的小数位数。
然而，某些特殊应用可能期望 JSON 文件中的数字严格遵循特定的格式，例如带有固定小数位的科学计数法（如 2.421500000000000e+04），并且要求它以未加引号的原始数字形式存在。这实际上是对标准 JSON 规范的一种偏离，因为在标准 JSON 中，数字的精确表示由解析器决定，通常不保留原始字符串格式。如果直接将数字转换为字符串进行序列化，JSON.stringify 会自动为其添加双引号，这同样不符合非标准应用的需求。
解决方案：利用 JSON.rawJSON 进行精确控制
为了满足这种非标准但实际存在的格式要求，我们可以利用 JavaScript 的 JSON.rawJSON 方法。JSON.rawJSON 是一个相对较新的提案（目前处于 Stage 3 阶段），它允许在 JSON.stringify 的 replacer 回调函数中插入原始的 JSON 字符串，而无需 JSON.stringify 对其进行额外的转义或引用。这意味着我们可以将数字格式化为所需的科学计数法字符串，然后通过 JSON.rawJSON 将其作为裸露的 JSON 值插入。
实现步骤
- 定义小数位数： 确定科学计数法所需的小数位数。
-
创建 replacer 函数： 这个函数将在 JSON.stringify 遍历对象时被调用。
- 对于非有限数字（如 NaN, Infinity），直接返回原始值。
- 对于有限数字，使用 Number.prototype.toExponential() 方法将其转换为科学计数法字符串。此方法接受一个参数，指定小数部分的位数。
- 处理 toExponential 可能产生的尾部零问题。例如，1.2e+1 可能会变成 1.20000000000000e+01，但如果需要精确的固定位数，可能需要额外的处理来确保尾部零的正确性（例如，如果 toExponential(14) 生成的末尾是 e+4，但原字符串是 e+04，可能需要补零）。示例代码中的 replace(/\b\d$/g, "0$&") 是一个巧妙的正则替换，用于确保指数部分的个位数前有零（如 e+4 变为 e+04），但需要注意的是，toExponential 本身会控制小数位数。
- 最关键的是，将格式化后的字符串包装在 JSON.rawJSON() 中返回。
示例代码
/**
* Node.js 中处理 JSON 科学计数法与固定小数位格式化输出的示例
* 适用于需要将数字序列化为特定科学计数法字符串格式（无引号）的场景。
*/
// 定义所需的小数位数
const DECIMALS = 14;
/**
* replacer 函数用于 JSON.stringify 的第二个参数，
* 允许我们自定义值的序列化方式。
* 当遇到数字时，将其转换为指定小数位的科学计数法字符串，
* 并通过 JSON.rawJSON 插入，避免添加引号。
*
* @param {string} key 当前正在序列化的属性名
* @param {any} val 当前正在序列化的属性值
* @returns {any} 序列化后的值
*/
const replacer = (key, val) => {
// 如果值不是有限数字（如 NaN, Infinity），则直接返回原始值
if (!Number.isFinite(val)) {
return val;
}
// 将数字转换为指定小数位的科学计数法字符串
// toExponential(DECIMALS) 会确保小数点后有 DECIMALS 位
let formattedStr = val.toExponential(DECIMALS);
// 某些情况下，toExponential 可能会生成如 "e+4" 而非 "e+04" 的指数部分。
// 以下正则替换是为了确保指数部分个位数前有零，如 "e+4" 变为 "e+04"。
// 注意：这取决于目标应用对指数格式的具体要求。
// /\b\d$/g 匹配单词边界后的单个数字（即指数的最后一位）
// "0$&" 表示在该数字前添加一个 "0"
formattedStr = formattedStr.replace(/\b(\d)$/g, "0$1"); // 更正正则，确保匹配的是指数部分，并捕获数字
// 如果原始值是整数，且 toExponential 导致了不必要的 .000...e+00 形式，
// 可能需要更复杂的逻辑来处理。但对于本例中的 2.421500000000000e+04，
// toExponential(14) 会生成类似 "2.421500000000000e+04" 的字符串。
// 使用 JSON.rawJSON 将格式化后的字符串作为原始 JSON 值插入，
// 这样在最终的 JSON 输出中就不会被引号包围。
return JSON.rawJSON(formattedStr);
};
// 示例对象
const obj = { "value": 2.421500000000000e+04, "another_value": 123.456e-7, "integer_value": 1000000 };
// 使用自定义的 replacer 函数进行序列化，并设置缩进为 2
const result = JSON.stringify(obj, replacer, 2);
// 打印结果
console.log(result);
/*
预期输出（可能会因 JavaScript 引擎和 toExponential 的具体实现略有差异，
但核心是数字以无引号的科学计数法字符串形式存在）：
{
"value": 2.421500000000000e+04,
"another_value": 1.234560000000000e-07,
"integer_value": 1.000000000000000e+06
}
*/JSON.rawJSON 的兼容性
在撰写本文时，JSON.rawJSON 处于 TC39 提案的 Stage 3 阶段，这意味着它已经相对稳定，并已在主流的 JavaScript 运行时中实现。
- Node.js: Node.js 21 及更高版本支持 JSON.rawJSON。
- 浏览器: Firefox, Chrome, Edge, Opera 等现代浏览器也已支持。
在生产环境中使用前，请务必确认目标 Node.js 版本或浏览器环境是否支持此特性。如果不支持，则需要考虑其他更复杂的字符串处理方法或放弃此非标准格式要求。
注意事项与最佳实践
- 非标准 JSON 格式： 再次强调，将数字以这种特定格式（无引号的科学计数法字符串）写入 JSON 并非标准 JSON 规范的行为。标准的 JSON 解析器会将其视为一个数字，并根据其内部表示进行处理，不保证保留原始字符串格式。如果接收方应用对 JSON 格式有如此严格且非标准的要求，建议首先确认其解析器是否合规，并探讨是否有更标准的替代方案。
- 精确度与 toExponential： toExponential(DECIMALS) 方法会四舍五入到指定的小数位数。如果原始数据需要更高的精度，或者需要根据数字大小动态调整小数位数，replacer 函数的逻辑需要进一步细化。
- 指数格式： toExponential 生成的指数部分可能形如 e+4 或 e-7。如果目标应用严格要求 e+04 或 e-07 这样的两位指数格式，示例代码中的 replace(/\b(\d)$/g, "0$1") 可以帮助实现这一点。请根据实际需求调整正则。
- 替代方案（如果 JSON.rawJSON 不可用）： 如果 JSON.rawJSON 不可用，或者不希望依赖 Stage 3 提案，唯一的“纯 JavaScript”替代方案是在序列化后对整个 JSON 字符串进行后处理（例如，使用正则表达式查找并替换匹配特定模式的带引号数字）。但这通常效率较低且容易出错。
总结
当 Node.js 应用面临将数字以特定格式（如固定小数位的科学计数法且无引号）序列化到 JSON 文件的非标准需求时，JSON.rawJSON 提供了一个强大且相对简洁的解决方案。通过结合 JSON.stringify 的 replacer 函数和 Number.prototype.toExponential()，开发者可以精确控制数字的输出格式，从而满足下游应用的特殊要求。然而，始终建议优先遵循 JSON 标准规范，并在必要时与数据接收方沟通，以确保数据互操作性和系统健壮性。
