Merge commit 'a2acfa9a6' into codex/game-distribution

2026-09-20 20:59:58 +08:00
parent 328ac31844 a2acfa9a6f
commit 64425e8d1a
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 测试触发该回调，导致日志数量和内容断言偶发混入其他测试记录。