结构体与联合体的偏移量计算：offsetof 宏与手动计算

偏移量计算，说白了就是搞清楚结构体里每个成员离起始地址有多远。这个问题我在刚入行时吃过不少亏，有一次调试一个通信协议栈，结构体成员死活对不上数据，最后发现是偏移量算错了。嗯，从那以后我对这块就特别上心。

什么是成员偏移量？

结构体成员的偏移量，就是该成员相对于结构体首地址的字节距离。比如：

struct Example {
    char a;      // 偏移 0
    int b;       // 偏移 4（因为有对齐）
    short c;     // 偏移 8
};

这里 a 的偏移是 0，b 的偏移是 4，c 的偏移是 8。为什么不是 1 和 5？因为编译器做了内存对齐。我个人的习惯是，写结构体时先把对齐规则想清楚，否则后面调试起来很痛苦。

offsetof 宏：标准库的利器

C 标准库提供了 offsetof 宏，定义在 <stddef.h> 中。它的用法很简单：

#include <stddef.h>
#include <stdio.h>

struct Packet {
    char type;
    int length;
    short checksum;
};

int main() {
    printf("type offset: %zu\n", offsetof(struct Packet, type));
    printf("length offset: %zu\n", offsetof(struct Packet, length));
    printf("checksum offset: %zu\n", offsetof(struct Packet, checksum));
    return 0;
}

输出结果：

type offset: 0
length offset: 4
checksum offset: 8

offsetof 的实现原理

offsetof 宏的经典实现长这样：

#define offsetof(type, member) ((size_t)&((type *)0)->member)

这个技巧很巧妙——它把地址 0 强制转换成一个结构体指针，然后取成员的地址。因为基地址是 0，所以成员的地址就是它的偏移量。我第一次看到这个写法时愣了半天，后来才明白其中的精妙。

手动计算偏移量

有时候你没法用 offsetof（比如在嵌入式裸机环境中），那就得手动算。手动计算需要掌握对齐规则：

1. 每个成员的起始地址必须是其自身大小的整数倍
2. 结构体的总大小必须是最大成员大小的整数倍
3. 编译器可能会在成员之间插入填充字节

举个例子：

struct SensorData {
    uint8_t id;       // 1 字节，偏移 0
    uint32_t value;   // 4 字节，需要对齐到 4 的倍数
    uint16_t status;  // 2 字节，需要对齐到 2 的倍数
};

手动计算过程：

• id 偏移 0，占 1 字节
• value 需要从 4 的倍数开始，所以偏移 4（中间填充 3 字节）
• status 在 value 之后，偏移 8，占 2 字节
• 结构体总大小：10 字节，但需要对齐到 4 的倍数，所以是 12 字节

联合体的偏移量计算

联合体就简单多了——所有成员共享同一块内存，偏移量都是 0。但要注意，联合体的大小等于最大成员的大小。

union Data {
    uint8_t bytes[4];
    uint32_t word;
    float f;
};

这里 bytes、word、f 的偏移量都是 0。联合体的大小是 4 字节（三个成员中最大的那个）。

我在做传感器驱动时经常用联合体来解析数据包：

union SensorPacket {
    uint8_t raw[8];
    struct {
        uint16_t temperature;
        uint32_t pressure;
        uint16_t humidity;
    } fields;
};

这样既能按字节访问原始数据，又能按字段解析，非常方便。

offsetof 在实战中的应用

我个人最常用的场景有两个：

1. 序列化与反序列化：用 offsetof 计算每个字段的位置，直接操作内存缓冲区
2. 反射式调试：在调试器中根据偏移量打印结构体成员的值

比如写一个通用的结构体打印函数：

void print_field(void *base, size_t offset, const char *name) {
    uint8_t *ptr = (uint8_t *)base + offset;
    printf("%s: %d\n", name, *(int *)ptr);
}

// 使用
struct Packet pkt = {.type = 1, .length = 100};
print_field(&pkt, offsetof(struct Packet, length), "length");

结构图：偏移量计算的核心逻辑

总结一下

偏移量计算是 C 语言结构体操作的基础功。我的建议是：

• 能用 offsetof 就用 offsetof，别自己算
• 如果必须手动算，先把对齐规则写清楚
• 联合体的偏移量永远是 0，不用纠结
• 跨平台项目一定要用 offsetof，别写死数字

嗯，掌握了这些，结构体偏移量这块你就基本拿下了。下次遇到数据对不上的问题，先检查偏移量算没算对。