必须带前导点（·）且与go声明完全匹配，如·add(sb)；参数和返回值通过fp偏移访问，如a+0(fp)、ret+16(fp)；需加nosplit标志禁用栈分裂，避免崩溃。
Go语言中嵌入汇编不是“学一门新语言”，而是用Plan 9汇编语法精准控制函数调用栈和寄存器，关键在于让汇编函数能被Go代码像普通函数一样调用——参数传得对、返回值接得住、栈帧不越界。
如何声明一个可被Go调用的汇编函数
Go汇编函数名必须带前导点（·），且需与Go声明完全匹配，包括大小写、包名（若非main包）和参数类型顺序。函数符号格式为 ·FuncName(SB)，其中 SB 表示symbol base，是固定写法。
- Go侧声明必须用
extern注释标记（实际不生效，但约定俗成）或直接省略实现体，仅保留签名 - 汇编文件必须以
.s结尾，且与Go文件同包（同一目录）、同构建标签（如//go:build amd64） - 若函数在非main包中，汇编符号应为
包名·FuncName(SB)，例如math·Sqrt(SB) - Go 1.17+ 默认启用
-gcflags="-l"禁用内联，调试时建议加该参数避免汇编函数被优化掉
参数和返回值在栈上怎么找
Go使用“帧指针相对寻址”：所有参数和返回值都按声明顺序压栈，偏移量从 0(FP) 开始计算。每个字段的偏移取决于其大小和对齐要求，不能靠猜。
-
a+0(FP)是第一个参数，b+8(FP)是第二个int64（占8字节），ret+16(FP)是第一个返回值（紧接参数之后） - 切片、字符串、接口等复合类型传递的是其 header 结构（如
SliceHeader），不是底层数据；访问元素需先解引用data字段 - bool 和小整数（如
int8）仍占满整个寄存器宽度（如8字节），不能只读低1字节——否则会读到相邻参数的高位垃圾 - 返回值区域在参数之后，若函数有多个返回值，按声明顺序依次排布，偏移累加
为什么汇编函数常加 NOSPLIT 标志
NOSPLIT 告诉Go运行时不为该函数分配额外栈空间，也不插入栈分裂检查。它不是可选优化，而是安全前提——因为手写汇编无法自动适配Go的栈增长机制。
- 任何可能触发栈分裂的操作（如调用其他Go函数、访问大数组、递归）都必须避免，否则会崩溃或静默错误
- 若确实需要调用Go函数（如
runtime·memclrNoHeapPointers），必须确认目标函数本身也标记NOSPLIT，且不依赖栈分裂 - 局部变量若超过几个寄存器容量，应显式在栈上分配空间（通过
$N指定帧大小），并用SP相对寻址，而非依赖FP - 忘记加
NOSPLIT在高并发场景下极易触发 SIGSEGV，错误信息通常是unexpected fault address或stack overflow
调试汇编函数最有效的三件事
别依赖 print，汇编里没 fmt.Println；也不要只看反汇编，那只是编译器生成的中间态，不是你写的源码逻辑。
- 用
go tool objdump -s 函数名 ./binary确认最终机器码是否与预期一致，特别检查跳转目标和内存操作地址 - 在汇编函数入口/出口处插入
CALL runtime·breakpoint(SB)（需 import "runtime"），配合 delve 单步执行观察寄存器变化 - 写最小化测试用例，用
unsafe.Sizeof和unsafe.Offsetof验证结构体字段偏移，避免手动计算出错 - 跨平台时（如 arm64），寄存器名、调用约定、栈对齐规则全不同，
GOARCH=arm64 go build后必须重新验证偏移和指令
真正难的不是写几行 MOVQ，而是让汇编代码在GC、goroutine调度、栈分裂这些Go运行时机制下依然可靠——它要求你同时理解汇编指令语义和Go内存模型，漏掉任意一层，函数就只在特定负载下偶然工作。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
