Go 通过首字母大小写严格区分导出（public）与未导出（private）标识符，Sqrt（导出）供外部调用，sqrt（未导出）作为底层 Go 实现供汇编桩或无优化平台回退使用，兼顾性能、可移植性与封装性。
go 通过首字母大小写严格区分导出（public）与未导出（private）标识符，`sqrt`（导出）供外部调用，`sqrt`（未导出）作为底层 go 实现供汇编桩或无优化平台回退使用，兼顾性能、可移植性与封装性。
在 Go 标准库的 math 包中，Sqrt 与 sqrt 的并存并非命名冗余，而是 Go 语言“导出机制 + 多平台优化”协同设计的经典范例。其核心逻辑如下：
- 导出函数 Sqrt（首字母大写）：是包的公共 API，定义在 sqrt.go 中，但无函数体——它仅作声明（declaration），实际实现由平台特定的汇编代码提供（如 sqrt_amd64.s）。例如在 x86-64 平台上，Sqrt 直接映射为 CPU 的 SQRTSD 指令，零开销、极致高效：
// math/sqrt_amd64.s
TEXT ·Sqrt(SB), NOSPLIT, $0
SQRTSD x+0(FP), X0
MOVSD X0, ret+8(FP)
RET
- 未导出函数 sqrt（首字母小写）：是纯 Go 编写的通用实现，定义在 sqrt.go 中，有完整函数体。它不对外暴露，仅作为兜底方案，供缺乏专用汇编支持的架构（如 mips64）通过跳转复用：
// math/stubs_mips64x.s
TEXT ·Sqrt(SB), NOSPLIT, $0
JMP ·sqrt(SB) // 跳转至 Go 实现
这种设计带来三大关键优势：
✅ 性能最优：主流架构直接调用硬件指令，避免 Go 运行时开销；
✅ 可移植性强：新架构只需提供轻量汇编桩（JMP），无需重写算法逻辑；
✅ 封装安全：sqrt 不在导出符号表中，用户无法绕过 Sqrt 的契约（如错误处理、NaN 规范等），保障 API 一致性。
值得注意的是，该模式广泛应用于 math 包（如 Sin/sin、Exp/exp）及运行时底层（如 runtime.memmove/memmove）。开发者在自定义包中亦可借鉴：将高性能实现（汇编/Cgo）绑定到导出函数，同时提供未导出的 Go 版本用于测试、调试或弱平台兼容，既保持接口简洁，又确保工程健壮性。
