最常用且可靠的方式是使用文件锁（flock）。它基于操作系统内核的advisory lock机制，轻量高效，适合多进程场景；通过syscall.Flock或unix.Flock获取独占锁，确保所有写入方统一加锁即可避免冲突。
在 Go 中防止多个进程同时写入同一文件，最常用且可靠的方式是使用文件锁（flock）。它基于操作系统内核的 advisory lock 机制，轻量、高效，适合多进程场景（比如定时任务、微服务多实例写日志或配置）。
什么是 flock？它为什么适合避免写入冲突
flock 是 Unix/Linux 系统提供的 advisory 文件锁，由内核维护，作用于整个文件（不是文件某段），进程退出或关闭文件描述符时自动释放。它不阻塞磁盘 I/O，只协调进程行为——也就是说，它依赖所有参与者主动加锁，不强制拦截未加锁的写操作（所以叫“建议性锁”）。只要所有写入方都遵循约定，就能彻底避免覆盖或损坏。
用 syscall.Flock 实现跨进程文件锁（推荐）
Go 标准库没有直接封装 flock，但可通过 syscall.Flock 调用系统调用，简洁可靠，无需第三方包：
- 打开文件用
os.O_CREATE | os.O_RDWR，确保可读写 - 调用
syscall.Flock(fd, syscall.LOCK_EX)获取独占锁（阻塞等待） - 写入完成后，用
syscall.Flock(fd, syscall.LOCK_UN)释放，或让文件句柄自动关闭（更安全） - 注意：锁绑定到文件描述符，不是文件路径；同一进程多次 open 同一文件会得到不同 fd，需分别加锁
示例关键片段：
立即学习“go语言免费学习笔记（深入）”；
f, err := os.OpenFile("data.json", os.O_CREATE|os.O_RDWR, 0644)
if err != nil {
log.Fatal(err)
}
defer f.Close() // 自动解锁
if err := syscall.Flock(int(f.Fd()), syscall.LOCK_EX); err != nil {
log.Fatal("无法获取文件锁:", err)
}
// ✅ 此时可安全写入
json.NewEncoder(f).Encode(data)
用 golang.org/x/sys/unix（更跨平台兼容）
如果你需要更好的可移植性（比如支持 macOS 或未来适配其他 Unix 变种），推荐用 golang.org/x/sys/unix 替代 syscall（后者已弃用）：
- 导入
"golang.org/x/sys/unix" - 用
unix.Flock(int(f.Fd()), unix.LOCK_EX)加锁 - 错误处理同上，支持
unix.LOCK_NB实现非阻塞尝试
非阻塞写法（适合超时控制或快速失败）：
if err := unix.Flock(int(f.Fd()), unix.LOCK_EX|unix.LOCK_NB); err != nil {
if err == unix.EWOULDBLOCK {
log.Println("文件正被占用，跳过写入")
return
}
log.Fatal(err)
}
常见误区与注意事项
- 不要用 os.Chmod 或 os.Rename 模拟锁——竞态明显，不可靠
- flock 不适用于 NFS 文件系统（部分版本不支持），如部署在 NFS 上，改用基于数据库或分布式锁（如 Redis SETNX）
-
Windows 不支持 flock，若需跨平台，可用
github.com/jacobsa/fuse或改用命名互斥量（sync.Mutex仅限单进程） - 锁粒度是“整个文件”，不适合高频小写入场景；此时建议用追加模式（
os.O_APPEND）+ 单独日志轮转，或引入消息队列削峰
基本上就这些。flock 不复杂但容易忽略细节，只要统一加锁、及时释放、避开 NFS 和 Windows 场景，就能稳稳守住文件写入安全线。
