如何在JavaScript中将原始数据文件的12位无符号整数读取为UInt16Array

我有一个存储12位无符号整数的原始数据文件，尝试直接读取为UInt8Array或UInt16Array时，数组的值和长度都不对。我知道可以按3个8位整数读取再拆分中间的数，但不知道JavaScript里具体怎么实现。

以下是我写的代码，生成的UInt16Array长度正确，但值不对：

fileReader.onload = () => {
    const arrayBuffer = fileReader.result;

    const dataView = new DataView(arrayBuffer);
    const length = Math.floor((dataView.byteLength * 8) / 12);
    const result = new Uint16Array(length);

    let byteOffset = 0;
    let bitOffset = 0;
    let currentIndex = 0;

    for (let i = 0; i < length; i++) {
        const bitsRemaining = 12 - bitOffset;
        const bitsToRead = Math.min(bitsRemaining, 16);

        let value = (dataView.getUint8(byteOffset) << 8) | dataView.getUint8(byteOffset + 1);
        value >>= (16 - bitOffset - bitsToRead);
        value &= (0b1 << bitsToRead) - 1;

        result[currentIndex] = value;

        bitOffset += bitsToRead;
        if (bitOffset === 12) {
            byteOffset += 1;
            bitOffset = 0;
        }
    
        currentIndex++;
    }
}

12位无符号整数的存储逻辑是3个字节打包2个12位值（3×8=24=2×12）：比如字节A、B、C，第一个12位值是(A << 4) | (B >> 4)，第二个是((B & 0x0F) << 8) | C。你之前的代码在跨字节取位时逻辑有误，下面是两种可靠的实现方式：

方式一：按3字节组批量处理 #

这种方式效率更高，适合数据量较大的场景：

fileReader.onload = () => {
    const arrayBuffer = fileReader.result;
    const byteLength = arrayBuffer.byteLength;
    // 计算12位值的总数：总位数/12
    const valueCount = Math.floor((byteLength * 8) / 12);
    const result = new Uint16Array(valueCount);
    
    const uint8Arr = new Uint8Array(arrayBuffer);
    let valueIndex = 0;
    let byteIndex = 0;

    // 先处理完整的3字节组
    while (byteIndex + 2 < byteLength) {
        const a = uint8Arr[byteIndex];
        const b = uint8Arr[byteIndex + 1];
        const c = uint8Arr[byteIndex + 2];

        // 第一个12位值：A的8位 + B的高4位
        result[valueIndex++] = (a << 4) | (b >> 4);
        // 第二个12位值：B的低4位 + C的8位
        result[valueIndex++] = ((b & 0x0F) << 8) | c;

        byteIndex += 3;
    }

    // 处理剩余的不足3字节的情况（最多剩2字节，对应1个12位值）
    if (byteIndex < byteLength && valueIndex < valueCount) {
        if (byteLength - byteIndex === 2) {
            const a = uint8Arr[byteIndex];
            const b = uint8Arr[byteIndex + 1];
            result[valueIndex] = (a << 4) | (b >> 4);
        }
        // 如果只剩1字节，不够组成12位值，直接忽略（符合原始数据的存储逻辑）
    }
}

方式二：逐位精确读取（通用任意位宽） #

如果需要更通用的逐位解析逻辑，修正你原代码的错误：

fileReader.onload = () => {
    const arrayBuffer = fileReader.result;
    const dataView = new DataView(arrayBuffer);
    const totalBits = dataView.byteLength * 8;
    const valueCount = Math.floor(totalBits / 12);
    const result = new Uint16Array(valueCount);

    let currentBit = 0;
    for (let i = 0; i < valueCount; i++) {
        let value = 0;
        // 读取当前12位值的每一位
        for (let bit = 0; bit < 12; bit++) {
            const bytePos = Math.floor(currentBit / 8);
            const bitInByte = 7 - (currentBit % 8); // 字节内的位从高位到低位计算
            // 取出该位的值并拼到结果中
            const bitValue = (dataView.getUint8(bytePos) >> bitInByte) & 1;
            value |= bitValue << (11 - bit); // 12位值的高位先存
            currentBit++;
        }
        result[i] = value;
    }
}

原代码错误说明 #

你之前的代码核心问题在于：

• 错误固定读取2字节拼接，未考虑跨多字节的取位场景
• 位偏移的更新逻辑混乱，导致每次读取的位范围错误
• 没有正确处理12位值的高低位拼接顺序

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