NodeJS中如何实现JS浮点数组与Float32 Buffer的双向转换？

问题 #

我有一个包含浮点数的JS数组，示例为[0.0028808217, -0.027968751, -0.029748825]，使用以下函数将其转换为Float32 Buffer：

function toFloat32Buffer(array) {
  return Buffer.from(new Float32Array(array).buffer)
}

但将Float32 Buffer转换回JS数组时，无法得到与原数组相同的数值。尝试的转换代码如下：

function toJSArray(buffer) {
 const newBuffer = Buffer.from(buffer) 
 const floatArray = new Float32Array(newBuffer)

 return Array.from(floatArray)
}

function toFloat32Buffer(arr) {
   return Buffer.from(new Float32Array(arr).buffer)
}

const array = [0.0028808217, -0.027968751, -0.029748825]
const bufferFromFloat32 = toFloat32Buffer(array);
const array2 = toJSArray(bufferFromFloat32);

console.log('array', array)
console.log('array2', array2)

运行后array与array2的数值不一致，请问在Node.js中应如何正确转换回原数组？

原因与解决方法 #

核心原因 #

JavaScript中的Number类型是64位双精度浮点数，而Float32Array是32位单精度浮点数，两者精度范围存在差异。将64位浮点数转成32位时会丢失部分精度，再转回64位时自然无法完全还原原始数值——这是单精度浮点数的固有特性，并非转换代码的错误。

正确的转换代码 #

你的转换逻辑本身是正确的，可简化toJSArray函数（无需重复创建Buffer）：

function toFloat32Buffer(arr) {
  return Buffer.from(new Float32Array(arr).buffer);
}

function toJSArray(buffer) {
  // 直接利用传入的Buffer创建Float32Array，避免不必要的复制
  const float32Arr = new Float32Array(buffer.buffer, buffer.byteOffset, buffer.length / 4);
  return Array.from(float32Arr);
}

const array = [0.0028808217, -0.027968751, -0.029748825];
const buffer = toFloat32Buffer(array);
const array2 = toJSArray(buffer);

console.log('原数组:', array);
console.log('转换后数组:', array2);

处理精度差异 #

若需要让输出数值和原数组视觉表现一致，可对转换后的数值进行小数位格式化：

// 保留8位小数，匹配原数组的精度展示
const formattedArray = array2.map(num => Number(num.toFixed(8)));
console.log('格式化后数组:', formattedArray);

格式化后结果会和原数组的视觉输出一致，本质是通过截断小数位隐藏了单精度转双精度的精度差异。

内容的提问来源于stack exchange，提问作者Sergio Prada