Linux/macOS上用unix.Flock加写锁必须用os.O_RDWR打开文件，因flock(2)要求fd支持读操作；Windows不支持syscall.Flock，需用LockFileEx或跨平台库如gofrs/flock。
Linux/macOS 上用 unix.Flock 加写锁必须带 os.O_RDWR
直接用 os.OpenFile(path, os.O_WRONLY, 0644) 打开再调 unix.Flock，在部分系统（尤其是 macOS）会失败，错误可能是 EBADF 或静默失效。根本原因是 flock(2) 要求文件描述符支持读操作——哪怕你只写，内核也需能读取文件元信息。
正确做法是统一用 os.O_RDWR | os.O_CREATE 打开文件：
file, err := os.OpenFile("data.json", os.O_RDWR|os.O_CREATE, 0644)
if err != nil {
return err
}
defer file.Close()
if err := unix.Flock(int(file.Fd()), unix.LOCK_EX|unix.LOCK_NB); err != nil {
if err == unix.EWOULDBLOCK {
return fmt.Errorf("file locked by another process")
}
return err
}
// ✅ 此时可安全写入
-
unix.LOCK_NB是关键：避免阻塞，失败立即返回，便于上层做重试或降级 - 锁绑定在
file.Fd()上，不是路径；同一进程反复OpenFile会拿到不同 fd，各自加锁互不影响 - 锁在
file.Close()时自动释放，defer是最稳妥的释放方式
Windows 下不能用 syscall.Flock，得换方案
在 Windows 上直接 import "syscall" 并调 syscall.Flock 会编译报错：undefined: syscall.Flock。这不是 bug，是平台限制——Windows 没有 flock(2) 系统调用。
硬要自己封装 LockFileEx 容易踩坑：
立即学习“go语言免费学习笔记（深入）”；
- 必须用
windows.CreateFile打开句柄，os.OpenFile返回的句柄权限不够 -
LockFileEx要求指定锁区域，传0偏移/长度会返回ERROR_INVALID_PARAMETER - 锁不会随句柄关闭自动释放，必须显式调
windows.UnlockFileEx
更现实的选择是引入 github.com/gofrs/flock。它内部做了平台判断：Unix 系统走 unix.Flock，Windows 走 LockFileEx，接口统一：
lock := flock.New("config.yaml")
locked, err := lock.TryLock()
if err != nil {
log.Fatal(err)
}
if !locked {
log.Fatal("failed to acquire lock")
}
defer lock.Unlock()
非阻塞锁失败后别直接 panic，要区分错误类型
unix.Flock(..., unix.LOCK_EX|unix.LOCK_NB) 失败时可能有多种原因，不能一概而论：
-
unix.EWOULDBLOCK：正常情况，表示锁被其他进程持有，可重试或跳过 -
unix.ENOENT：路径不存在，可能是目录没创建，需提前os.MkdirAll -
unix.EACCES：权限不足，比如文件属主不是当前用户，或挂载为noexec -
unix.EBADF：fd 无效，大概率是打开模式不对（如只写了os.O_WRONLY）
建议用 errors.Is(err, unix.EWOULDBLOCK) 显式判断竞争场景，其他错误应记录并中止流程，而不是盲目重试。
临时文件 + os.Rename 比 flock 更可靠
很多人以为加了 flock 就万事大吉，但其实它只是“建议性锁”：只要有一个进程不守规矩（比如直接 os.WriteFile 覆盖），锁就形同虚设。真正跨平台、强一致的方案是绕过锁，改用原子重命名：
- 每个写操作生成唯一临时名，如
config.json.12345.tmp（含 PID 或随机后缀） - 写入完成后调
os.Rename(tmpPath, targetPath)—— 同一文件系统下该操作 POSIX 保证原子 - 务必确保
tmpPath和targetPath在同一目录，否则Rename会退化为复制+删除，失去原子性 - 启动时扫描残留
*.tmp文件并清理，防止磁盘占满
这个方案不依赖任何系统锁机制，也不怕进程崩溃未释放锁，是真正落地时最值得优先考虑的路径。
