修复 Godot 原生插件的 MSVC 编译兼容性

将 ABI 存储改为 C11 显式 16 字节对齐并保留 128 字节容量补充 Windows 编译环境要求与 MSVC 对齐问题排障说明
2026-09-20 19:39:12 +08:00
parent cde34428f9
commit a2acfa9a6f
3 changed files with 10 additions and 2 deletions
@@ -1,5 +1,10 @@
 # 踩坑与排障记录

+## Godot 原生插件在 MSVC C 模式下的对齐声明
+
+- `native.c` 若首先报 `max_align_t` 语法错误，后面的 `Storage`、`retained_script` 等未声明通常是连带错误。MSVC C 模式不提供该类型；ABI 存储使用 C11 `_Alignas(16)` 显式对齐并保持 128 字节容量，通过实际 MSVC DLL 构建验证，不逐条修补连带错误。
+- `No C compiler found` 则属于开发环境问题：先初始化 Visual Studio x64 开发环境，同时设置 PATH、INCLUDE 与 LIB，再运行构建。只把 `cl.exe` 所在目录加到 PATH 不足以提供头文件和链接库。
+
 ## Rust 同步回调的测试记录按线程隔离

 - `shared-contracts` 的资源 kind reporter 是进程级回调。仅给注册和断言加锁，无法阻止其他并行 manifest 测试触发该回调，导致日志数量和内容断言偶发混入其他测试记录。