小端系统下NodeJS解析32位无符号整数为何与预期不符？

你的核心问题是把字节序（内存中字节的存储顺序）和整数内部的位排列规则搞混了，这是解析二进制数据时很常见的误区。

先理清两个关键概念 #

• 字节序（Little Endian/Big Endian）：仅描述多个字节在内存中的存储顺序。比如32位整数，Little Endian要求低字节（对应整数的0-7位）存在内存低地址，高字节（对应整数的24-31位）存在内存高地址；Big Endian则相反。
• 文档中的位布局描述：“最高有效位（MSB）在左侧，32位无符号整数按12位年份|4位月份...编码”，这是在定义组装完成后的32位整数内部的位权重规则——也就是说，当你把内存中的字节正确拼成一个32位整数后，这个整数的第20-31位（最高12位）对应年份，接下来4位对应月份，以此类推。这里的“MSB在左”和字节怎么存在内存里完全无关。

为什么readUint32LE才是正确的？ #

因为你的C规范已经明确字节是按Little Endian存储的，所以必须用readUint32LE来告诉解析器：把内存中低地址的字节当作整数的低字节，高地址的字节当作整数的高字节，这样才能组装出文档定义的那个32位整数。

组装完成后，这个整数的位结构就和文档描述的完全一致了，此时number >> 20就能把最高12位移到低位，得到正确的年份值。

你之前用readUint32BE的错误在哪？ #

你误以为文档里的“MSB在左”对应大端字节序，但实际上这是两个独立的概念。用readUint32BE读取Little Endian存储的字节，会强行把低地址的字节当作整数的高字节，组装出一个完全错误的32位整数，后续的移位操作自然得不到正确结果。

举个简单例子：假设年份是2024（二进制011111101000，12位），月份是10（二进制1010，4位），剩下的位为0。这个32位整数的十六进制是0x7E8A0000，按Little Endian存储的话，内存中的字节顺序是0x00 0x00 0x0A 0x7E：

• 用readUint32LE读取，会得到正确的0x7E8A0000，右移20位后是0x7E8，也就是2024；
• 用readUint32BE读取，会得到错误的0x00000A7E，右移20位后是0，完全不符合预期。

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