摘要： 你是否遇到过这种灵异现象：同一个全局结构体变量，在 main.c 里赋值明明是对的，传指针给 driver.c 后读出来全是乱码，但地址竟然是一样的？本文将揭示这个由 #pragma pack 误用导致的“ABI 不匹配”隐形杀手。

---

现象：指针没指错，数据全乱了

假设你定义了一个通信协议结构体 MyPacket。

在 main.c 中，你填入数据 0x12345678，一切正常。

然后你把指针传给 uart_driver.c 发送，结果发出去的数据是错位的，或者读到了毫无相关的垃圾值。

调试器显示指针地址一致，但两个 .c 文件看到的结构体成员偏移量（Offset）竟然不同。这就是结构体的“精神分裂”。

案发现场：致命的 #include

问题的根源通常在于：你在 #pragma pack 的生效范围内，包含了一个本该默认对齐的头文件。

1. 公共头文件 (protocol.h)

这是一个无辜的定义，本意是按照编译器默认（通常 4 字节）对齐。

typedef struct {
    uint8_t  cmd;
    // 默认会有 3 字节 Padding
    uint32_t payload; 
} Packet_t;

2. 肇事者 (driver.c)

为了解析某个紧凑的串口协议，开发者开启了 1 字节对齐，但不小心把公共头文件也包了进去。

// 开启强制对齐
#pragma pack(push, 1)

#include "protocol.h" // <--- 致命错误！Packet_t 在这里变成了紧凑布局！

void send_packet(Packet_t *pkt) {
    // 这里认为 payload 的 offset 是 1
    HAL_UART_Transmit(..., &pkt->payload, ...);
}
#pragma pack(pop)

3. 受害者 (main.c)

这里是正常的默认环境。

#include "protocol.h" // 这里 Packet_t 还是默认对齐

void main() {
    Packet_t pkt;
    pkt.payload = 0x12345678; // 写入 Offset 4
    send_packet(&pkt);        // 传给 driver
}

深度解析：链接器的盲区

为什么编译不报错？

因为 C 语言的 链接器（Linker）是“类型盲”。它只管符号（Symbol）地址的连接，不检查符号的类型定义是否一致。

• 在 main.c 眼中： Packet_t 大小为 8，payload 在 Offset 4。
• 在 driver.c 眼中： Packet_t 大小为 5，payload 在 Offset 1。

当你把指针从 main 传给 driver 时，driver 拿着地址去访问 Offset 1，读到的却是 main 里的 Padding 字节（通常是垃圾值或 0），从而导致数据错位。

这就是 ABI（二进制接口）不匹配。这种 Bug 极其隐蔽，因为代码逻辑完全正确，只有在运行时才崩溃。

最佳实践：抛弃 pragma，拥抱 attribute

#pragma pack 是一个全局状态开关，一旦忘记关闭或者包含位置不当，会“污染”后续所有代码。

在 GCC / Clang / Keil AC6 环境下，强烈建议使用 __attribute__((packed))。

推荐写法：

它是“贴纸”，只作用于特定的结构体，绝对不会误伤无辜。

typedef struct {
    uint8_t  cmd;
    uint32_t payload;
} __attribute__((packed)) Packet_t;

如果你必须使用 #pragma pack（例如为了兼容旧的 MSVC 代码），请务必遵守 “紧贴定义，严禁包含” 的原则：

// 正确做法：中间不要夹杂 #include
#pragma pack(push, 1)
typedef struct {
    ...
} Packet_t;
#pragma pack(pop)

最后的防线：静态断言

为了彻底杜绝此类问题，建议在头文件中加入静态断言。如果不同模块对结构体大小理解不一致，编译时直接报错。

_Static_assert(sizeof(Packet_t) == 5, "Packet_t size mismatch! Check alignment.");

---

总结：

嵌入式开发中，对齐问题不仅关乎效率，更关乎正确性。少用全局开关 #pragma pack，多用精准修饰 attribute((packed))，别让你的结构体在不同文件里“精神分裂”。