MemoryLayout.structLayout不能直接映射C struct，必须显式处理字段对齐与padding：ValueLayout.JAVA_INT占4字节，后续JAVA_DOUBLE须从offset=8开始，中间用paddingLayout(4)补位；字段顺序不决定内存布局，offset才是关键；嵌套struct和数组需用SequenceLayout/GroupLayout组合；对齐错误仅在运行时访问时触发校验，易导致C端读取异常。
MemoryLayout.structLayout 不能直接套用 C struct 声明
直接把 struct { int a; double b; } 翻译成 MemoryLayout.structLayout(ValueLayout.JAVA_INT, ValueLayout.JAVA_DOUBLE) 是错的——JVM 不会自动插入 padding，字段会紧挨着排布，导致 b 落在非 8 字节对齐地址，C 函数读取时可能崩溃或返回垃圾值。
必须显式声明 padding 或使用 offset 控制布局。C 的自然对齐规则（int 对齐到 4 字节、double 到 8 字节）需手动建模。
-
ValueLayout.JAVA_INT占 4 字节，但后续ValueLayout.JAVA_DOUBLE必须从 offset=8 开始，中间空出 4 字节 padding - 用
MemoryLayout.paddingLayout(4)显式占位，比靠 offset 更清晰、更易维护 - 字段名（
.withName("a")）不是装饰，是后续通过VarHandle安全访问的必要标识
structLayout 中的字段顺序 ≠ 内存顺序，offset 才是真相
即使你按 C struct 顺序写字段，JVM 仍按 layout 描述的 offset 顺序写入内存。如果某个字段的 offset 设置错误，比如把 Flags 放在 offset=12 而不是 16，整个结构体就和 C 端不兼容。
常见错误现象：IllegalStateException: Segment is not accessible 或函数调用后返回异常数值，往往是因为字段错位导致 C 读到了未初始化/越界的内存区域。
- 所有字段必须显式指定
offset，或用paddingLayout推动下一个字段到正确位置 - 不要依赖“先写哪个字段就排在哪”，
structLayout是声明式描述，不是执行式语句 - 推荐用
MemoryLayout.structLayout(...).withName("MyStruct")+varHandle(PathElement.groupElement("a"))组合，避免硬编码偏移
嵌套 struct 和数组要用 SequenceLayout / GroupLayout 组合
C 中的 struct Header { uint32_t magic; struct Point points[10]; } 在 FFM 中不能靠一层 structLayout 解决。Point 数组必须用 SequenceLayout 封装，再作为 group 成员嵌入外层 struct。
否则你会拿到一个“扁平”的字节序列，无法安全地逐个访问 points[i].x —— JVM 不知道哪 16 字节是一个 Point，更不知道它有 10 个。
- 先定义
Point：MemoryLayout.structLayout(ValueLayout.JAVA_DOUBLE.withName("x"), ValueLayout.JAVA_DOUBLE.withName("y")) - 再定义数组：
MemoryLayout.sequenceLayout(10, pointLayout) - 最后组合进 header：
MemoryLayout.structLayout(ValueLayout.JAVA_INT.withName("magic"), pointsArrayLayout.withName("points")) - 访问第 3 个点的 x：
handle = layout.varHandle(groupElement("points"), sequenceElement(2), groupElement("x"))
对齐检查只能靠运行时访问触发，没有编译期校验
MemoryLayout 本身不校验是否符合 ABI 对齐要求。只有当你用 segment.get(...) 或 set(...) 访问某个字段时，JVM 才会检查该偏移是否满足该 ValueLayout 的对齐约束（例如 JAVA_DOUBLE 要求 offset % 8 == 0）。
这意味着：写错 offset 可能一直不报错，直到传给某个严格检查对齐的 C 函数（如 SIMD 指令或某些 libc 函数），然后静默失败或 SIGBUS。
- 务必在分配后立即做一次
get测试，比如segment.get(ValueLayout.JAVA_DOUBLE, 8)验证double字段是否可读 - 不要跳过
Arena作用域管理，否则segment关闭后访问会抛IllegalStateException，掩盖真正的对齐问题 - Windows x64 和 Linux aarch64 的 ABI 对齐策略略有差异，跨平台部署前要在目标系统上实测
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
