Go SIMD 要转正了：一份 API 规范背后的设计野心
内容提要
Go技术负责人提交Proposal #83009，拟将simd和simd/archsimd中经规范覆盖的API从实验开关转为正式发布，覆盖AMD64 AVX系列、ARM64 NEON和WebAssembly SIMD，SVE暂不毕业。API分两层：simd提供向量长度无关的可移植接口，archsimd暴露架构相关能力。核心原则是“一名一义”，同名API跨平台语义一致。配套可执行规范统一API定义、文档生成与跨架构测试，标志Go SIMD走向工程化。
延伸解读
两层API设计：可移植与硬件控制的分工
文章指出，Go SIMD将API分为simd和simd/archsimd两层。simd提供向量长度无关的可移植接口，适合大多数数据处理代码；archsimd则暴露架构相关能力，贴近底层指令。这种分工类似os与syscall的关系，让开发者不必在可移植性和硬件控制之间二选一。理解这一分层，有助于判断何时使用通用接口、何时需要针对特定CPU优化。
“一名一义”原则：跨架构语义一致性的取舍
Proposal强调“One name means one thing”，即同名API在不同平台必须表达相同的操作、签名和语义。但Go团队并不要求所有架构拥有完全相同的API：某个架构可以不提供某项操作，却不能提供同名但语义不同的接口。这种取舍比强行抹平硬件差异更现实，也降低了跨平台代码的认知负担。读者应关注这一原则如何影响API的可用范围。
可执行规范：从文档到跨架构验证工具
文章重点介绍了用Go编写的可执行API规范，它同时承担API描述、文档生成和跨架构一致性测试三项职责。规范中的纯Go实现可作为参考行为，用于验证不同架构的SIMD实现是否符合语义。文中提到，这套规范甚至帮助发现了QEMU中的几个Bug。这说明Go SIMD的工程化不仅在于API转正，更在于建立可长期维护的验证机制。
转正范围有限：SVE与开放问题仍需关注
本次Proposal并非所有SIMD能力一次性GA，只毕业已被可执行规范覆盖的API，ARM64 SVE暂不在此范围内。此外，Equal的返回语义和Vector Reshape的设计仍有开放讨论。文章提醒，Proposal尚处提案阶段，后续评审和落地情况值得持续关注。对开发者而言，这意味着实验性API与正式API之间仍有边界，迁移时需留意覆盖范围。
Q&A
Go SIMD 的 Proposal #83009 主要提出了什么？
该 Proposal 由 Go 技术负责人 Austin Clements 于 2026 年 11 月 11 日提交，核心目标是将 simd 和 simd/archsimd 中已被可执行规范覆盖的 API 从 GOEXPERIMENT=simd 实验开关中毕业，转为正式可用。覆盖 AMD64 AVX 系列、ARM64 NEON 和 WebAssembly SIMD，但 ARM64 SVE 暂不毕业。
Go 的 simd 和 simd/archsimd 两个包有什么区别？
simd 包提供向量长度无关的可移植接口，适合大多数数据处理代码，开发者无需关心具体向量宽度；simd/archsimd 包暴露架构相关的固定宽度 SIMD 能力，贴近底层机器指令，适合需要充分挖掘特定 CPU 性能的场景。两者关系类似标准库中 os 与 syscall 的分层。
Go SIMD 的“One name means one thing”原则具体指什么？
该原则要求：同一个 API 名称无论出现在哪个平台或向量类型上，都必须表达相同的操作、签名和语义。API 不必在所有架构上都存在，但一旦存在，就不能在不同架构上表达不同含义。例如 Add 在所有架构上都表示相同的逐元素加法。
可执行 API 规范（Executable API Specification）有什么作用？
它是一份用 Go 编写的规范，每个操作定义包含名称、参数与返回值类型、文档注释和纯 Go 实现。其作用有三：统一所有生成器的 API 定义，避免架构间语义分歧；统一生成文档；利用纯 Go 实现作为参考行为，自动化验证不同架构 SIMD 实现是否符合规范。团队甚至借此发现了 QEMU 中的几个 Bug。
这次 Proposal 中还有哪些未解决的开放问题？
主要有两个：一是 Equal 方法的语义争议——当前 x.Equal(y) 返回逐元素比较的 Mask，但 Go 惯例中 Equal 常返回 bool，团队讨论了保留现有语义、允许向量用 == 整体比较、或将逐元素比较改名为 Equals 等方案；二是 Vector Reshape 的设计是否过于繁琐，可能引入 Bits128、Bits256 等专用类型来简化重塑操作。
Go SIMD 的 API 大致包含哪些操作类别？
根据《Go SIMD API summary》，API 覆盖加载与存储、算术、比较、掩码、归约、转换、移位、Shuffle 等类别，具体包括 Basics、Bit math、Comparison、Conditional logic、Load/Store、Logical、Masks、Math、Numeric conversion、Reductions、Reinterpretation、Rounding、Shifts、Shuffles 等，形成从数据加载、计算、选择、转换、归约到重排的完整操作体系。
