如何在Node.js中写入二进制数据并保持文件打开状态？

由于JavaScript的运行环境分为Node.js（服务器/本地脚本）和浏览器，而浏览器无法直接对本地文件进行持续写入操作，以下方案针对Node.js环境实现你的需求：

核心思路 #

1. 使用Node.js的fs模块创建可追加的二进制写入流，保持文件打开状态以支持连续写入。
2. 处理布尔值的1位写入：文件系统的最小操作单位是字节，因此需要通过位缓冲将多个布尔值打包成单个字节后写入，避免空间浪费。
3. 处理64位浮点数：利用Buffer将双精度浮点数转换为8字节的二进制数据写入。

实现代码 #

const fs = require('fs');

class BinaryFileWriter {
  constructor(filename) {
    // 以追加二进制模式打开文件，禁用自动关闭
    this.stream = fs.createWriteStream(filename, { flags: 'ab', autoClose: false });
    this.bitBuffer = 0; // 存储待写入的位数据
    this.bitCount = 0; // 当前缓冲的位数
  }

  // 写入单个布尔值（占1位）
  async writeBoolean(value) {
    // 将布尔值转为0/1，存入位缓冲的对应位置
    this.bitBuffer |= (value ? 1 : 0) << (7 - this.bitCount);
    this.bitCount++;

    // 缓冲满8位时，写入字节并重置缓冲
    if (this.bitCount === 8) {
      await this._writeBuffer(Buffer.from([this.bitBuffer]));
      this.bitBuffer = 0;
      this.bitCount = 0;
    }
  }

  // 写入64位双精度浮点数
  async writeDouble(value) {
    // 先写入缓冲中剩余的位（避免浮点数与位数据交叉）
    if (this.bitCount > 0) {
      await this._writeBuffer(Buffer.from([this.bitBuffer]));
      this.bitBuffer = 0;
      this.bitCount = 0;
    }

    const buf = Buffer.alloc(8);
    buf.writeDoubleBE(value, 0); // 大端序写入，如需小端序改用writeDoubleLE
    await this._writeBuffer(buf);
  }

  // 内部方法：封装流的异步写入
  _writeBuffer(buf) {
    return new Promise((resolve, reject) => {
      this.stream.write(buf, (err) => {
        err ? reject(err) : resolve();
      });
    });
  }

  // 关闭文件，处理剩余未填满的位（补0后写入）
  async close() {
    if (this.bitCount > 0) {
      await this._writeBuffer(Buffer.from([this.bitBuffer]));
    }
    this.stream.end();
    return new Promise((resolve, reject) => {
      this.stream.on('finish', resolve);
      this.stream.on('error', reject);
    });
  }
}

// 使用示例
async function run() {
  const writer = new BinaryFileWriter('filename.dat');
  
  await writer.writeBoolean(true);
  await writer.writeDouble(3.14);
  await writer.writeBoolean(false);
  await writer.writeBoolean(true);
  
  await writer.close();
}

run().catch(err => console.error('写入出错:', err));

关键细节说明 #

• 位缓冲机制：如果不需要严格的1位存储（允许每个布尔值占1字节），可以简化为直接写入Buffer.from([value ? 1 : 0])，但会浪费7/8的存储空间。
• 字节序选择：writeDoubleBE是大端序（高位字节在前），writeDoubleLE是小端序，需与后续读取文件的逻辑保持一致。
• 异步控制：所有写入操作使用async/await确保顺序执行，避免异步写入导致的数据错乱。
• 流的自动关闭：设置autoClose: false防止流在空闲时自动关闭，确保可以持续写入直到手动调用close()。

内容的提问来源于stack exchange，提问作者Alexander Richter