syscall.syscall 在 linux 上常返回 einval 是因参数顺序或寄存器值错误，go 不校验直接传入内核导致越界、无效指针或不支持 flag；需严格按 abi 传参并确保内存有效。
syscall.Syscall 在 Linux 上为什么常返回 EINVAL？
直接调用 syscall.Syscall 传错参数顺序或寄存器值，是 EINVAL 的最常见原因。Go 的 syscall 包不校验参数合法性，它只是把数字原样塞进寄存器然后触发 int 0x80 或 syscall 指令——内核一看参数越界、指针无效、flag 不支持，立刻回 EINVAL。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
syscall.Syscall的三个参数顺序是sysno、a1、a2（不是 man 手册里函数声明的顺序），比如open系统调用在 amd64 上 sysno 是2，但你要传的是path地址、flags、mode，不是flags、mode、path - 字符串路径必须转成 C 字符串：用
syscall.BytePtrFromString，别用C.CString（它会 malloc，且不保证零终止） - 传入的指针必须指向可读内存，且不能是 Go 的栈变量（逃逸分析没让它逃到堆上的话，GC 可能移动/回收）
用 syscall.Syscall6 调 epoll_wait 时 timeout 总是立即返回？
因为 epoll_wait 第四个参数是超时毫秒数，但 syscall.Syscall6 的第 5、6 参数对应的是寄存器 r10 和 r8（amd64），而 epoll_wait 的参数顺序是 epfd、events、maxevents、timeout——你如果按直觉把 timeout 放在第 4 个位置，它其实被塞进了错误寄存器，内核当成了 0。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 查清楚目标系统调用在目标架构上的 ABI 参数映射表，比如 Linux amd64 上：
rdi→a1、rsi→a2、rdx→a3、r10→a4、r8→a5、r9→a6 -
epoll_wait的timeout必须传给a4，也就是syscall.Syscall6的第 5 个参数（索引从 0 开始算第 4 个数值参数） - 确保
events指向的syscall.EpollEvent数组是unsafe.Pointer，且长度不超过maxevents，否则内核可能拒绝调用
为什么 syscall.Read 和 syscall.Write 在 macOS 上行为异常？
macOS 的 read/write 系统调用在 arm64 上不接受负数返回值做错误判断，且部分版本对缓冲区地址对齐有隐式要求；更关键的是，Go 运行时在 darwin 上默认启用 libSystem 的 syscall wrapper，它会拦截并重写某些调用逻辑，导致原始 syscall 行为和 Linux 不一致。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 避免直接用
syscall.Read处理标准输入输出或管道——优先用os.File.Read，它内部已适配各平台 - 若必须直调，检查
GOOS=darwin GOARCH=arm64下syscall.Read返回值：成功时返回非负整数，失败时不一定是-1，要结合errno判断 - 缓冲区地址尽量用
make([]byte, n)分配，别用new([n]byte)，后者在某些 darwin 版本下可能因未对齐触发EFAULT
syscall.Mmap 映射文件后读写 panic：unexpected fault address
这不是权限问题，而是 Go 的内存模型与 mmap 的交互冲突：mmap 返回的地址空间不受 Go GC 管理，但如果你把返回的指针转成 *[]byte 或用 unsafe.Slice 构造切片后，又让该切片逃逸到堆上，GC 可能在下次扫描时尝试访问已 unmapped 的地址，触发 segfault。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
syscall.Mmap后，务必用syscall.Munmap配对释放，不要依赖 GC - 构造切片时用
unsafe.Slice((*byte)(unsafe.Pointer(ptr)), length)，别用reflect.SliceHeader手动拼——后者容易漏设Cap导致越界 - 映射区域若需长期持有，把它包进一个 struct 并实现
runtime.SetFinalizer自动 unmmap，但注意 finalizer 不保证及时执行
真正麻烦的是跨平台 mmap 标志兼容性：MAP_ANONYMOUS 在 BSD 上叫 MAP_ANON，PROT_READ | PROT_WRITE 在 Windows 上根本不存在——这些细节不手动 #ifdef 就很容易在 CI 里静默失败。
