应使用 errors.Is() 判断 syscall 错误，因 Go 1.19+ 对 errno 做了平台别名映射，直接 == 失效；跨平台文件锁需按系统分支实现，Flock 仅适用于 Unix 系统，Windows 需用 LockFileEx；CGO 使用需显式构建约束并管理头文件；路径、换行符、shell 调用等细节必须跨平台适配。
用 errors.Is() 判断 syscall 错误，别用 ==
直接写 err == syscall.ECONNREFUSED 在 macOS 或 Windows 上大概率失效。因为 Go 1.19+ 对 errno 做了平台别名映射，syscall.ECONNREFUSED 是一个常量，而实际返回的 err 是 syscall.Errno 类型实例，底层值可能被重映射过。
正确做法是统一用 errors.Is()：
-
errors.Is(err, syscall.ECONNREFUSED)—— 跨平台安全 -
errors.Is(err, syscall.EAGAIN)或errors.Is(err, syscall.EINTR)—— 可重试错误识别可靠 - 避免手动判断
err == syscall.EWOULDBLOCK，errors.Is()内部已做等价处理
跨平台文件锁必须按系统分支实现
Go 标准库不提供跨平台文件锁抽象。syscall.Flock() 在 Linux/macOS 可用，但 Windows 完全不支持；Windows 需调用 LockFileEx（通过 golang.org/x/sys/windows）。
不能靠条件编译文件（如 lock_windows.go / lock_unix.go）就完事——还要确保调用路径一致、错误处理逻辑对齐：
- Linux/macOS：用
syscall.Flock(fd, syscall.LOCK_EX|syscall.LOCK_NB) - Windows：用
windows.LockFileEx()，注意fd需转为windows.Handle - 释放锁必须用对应系统 API，且建议加
defer+ 显式错误忽略（_ = syscall.Flock(...)） - 非阻塞尝试失败时，不要直接 panic，应包装为自定义错误（如
ErrLockBusy）便于上层重试或降级
CGO 头文件和系统调用混用时，构建约束必须显式声明
一旦代码里出现 // #include <sys></sys> 或 import "C"，Go 就不再“透明跨平台”。GOOS=linux go build 不会自动给你装 Linux 头文件，宿主机没有 epoll.h 就直接报错。
关键动作是双保险约束：
- 在文件顶部加构建标签：
//go:build linux（Go 1.17+ 推荐）或// +build linux - 同时禁用 CGO 的跨平台构建场景：
CGO_ENABLED=0 go build—— 此时所有import "C"会失败，反而能快速暴露问题 - 若必须用 CGO，各平台头文件需自行管理：
#cgo CFLAGS: -I/path/to/linux-headers，不能依赖默认路径 - 优先迁移到
golang.org/x/sys/unix（Linux/macOS）或golang.org/x/sys/windows（Windows），它们已封装好平台差异
临时目录、路径拼接、换行符这些“小地方”最容易漏掉
很多人盯着信号、锁、CGO 看，却在 os.TempDir() 和 filepath.Join() 上栽跟头：
- 硬写
"./tmp/data"或"C:\temp\data"—— 路径分隔符和盘符逻辑在其他平台崩 - 用
strings.Split(string(b), " ")解析日志 —— Windows 文件含" "，结果多出空行 - 直接调
exec.Command("sh", "-c", script)—— Windows 没sh，得用cmd /c或PowerShell -Command -
os.TempDir()返回值在 Windows 是%TEMP%，Linux 是/tmp，macOS 是/var/folders/xxx，别假设结构
这些不是“可选优化”，是运行时行为差异的起点。没在目标平台跑过集成测试，光编译通过没用。
