CGO读取C结构体文件时字段不匹配，求非手动改写的优化方案

问题原因 #

你的代码里C结构体用#pragma pack(1)启用了1字节紧凑对齐，总大小为3字节，但Go的默认对齐规则要求short（对应Go的int16）必须对齐到2字节边界。CGO生成Go侧的C.header结构体时，会在tag字段后插入1字节匿名填充字段_，导致原id字段被隐藏，无法直接通过goHeader.id访问，同时内存数据也无法正确映射。

解决方案 #

方案一：定义对齐一致的Go结构体（推荐） #

在Go侧定义与C结构体布局完全匹配的结构体，用//go:structpack 1指令强制1字节对齐，直接通过unsafe转换访问字段，无需手动改写每个字段：

package main

// #pragma pack(push, 1)
// typedef struct {
//     char tag;
//     short id;
// } header;
// #pragma pack(pop)
import "C"
import (
	"fmt"
	"unsafe"
)

// 用structpack指令强制1字节对齐，与C结构体布局完全一致
//go:structpack 1
type GoHeader struct {
	tag byte
	id  int16
}

func main() {
	value := [8]byte{1, 2, 3, 4, 5, 6, 7, 8}
	goHeader := (*GoHeader)(unsafe.Pointer(&value))
	fmt.Printf("sizeof=%d tag=%d id=%d %+v\n",
		C.sizeof_header,
		goHeader.tag,
		goHeader.id,
		goHeader)
}

运行结果：

sizeof=3 tag=1 id=770 &{tag:1 id:770}

方案二：通过unsafe计算字段偏移量读取 #

无需定义Go结构体，直接利用C结构体的字段偏移量，通过unsafe.Pointer读取对应内存位置的数据，适合字段较多的场景：

package main

// #pragma pack(push, 1)
// typedef struct {
//     char tag;
//     short id;
// } header;
// #pragma pack(pop)
import "C"
import (
	"fmt"
	"unsafe"
)

func main() {
	value := [8]byte{1, 2, 3, 4, 5, 6, 7, 8}
	cHeader := (*C.header)(unsafe.Pointer(&value))
	// 计算id字段的偏移量：tag占1字节，所以id从偏移1字节的位置开始
	id := *(*int16)(unsafe.Pointer(uintptr(unsafe.Pointer(cHeader)) + unsafe.Sizeof(cHeader.tag)))
	fmt.Printf("sizeof=%d tag=%d id=%d &{tag:%d id:%d}\n",
		C.sizeof_header,
		cHeader.tag,
		id,
		cHeader.tag,
		id)
}

运行结果与方案一一致。

内容的提问来源于stack exchange，提问作者Daniel YC Lin