Golang实现文件锁定以防止并发写冲突-Golang-PHP中文网

go中flock仅适用于linux/macos，windows需用lockfileex；flock是建议性锁，绑定fd，进程退出自动释放，写操作必须用lock_ex，阻塞需加lock_nb避免卡死。

golang实现文件锁定以防止并发写冲突

Go 中用 `flock` 实现文件级互斥写入

Go 标准库不提供跨进程的文件锁，flock 是最直接、最轻量的方案，适用于 Linux/macOS。Windows 需换用 syscall.LockFileEx（下文另说）。flock 锁是 advisory lock（建议性锁），依赖所有参与者主动调用，但只要统一用它，就能可靠防止并发写冲突。

常见错误：直接用 os.OpenFile(..., os.O_CREATE|os.O_WRONLY) 反复打开写入，没加锁——多个进程同时写同一文件，必然内容错乱或覆盖。

flock 锁绑定在文件描述符上，进程退出或 fd 关闭时自动释放，不用手动 unlock（除非显式调用）
锁类型分 LOCK_EX（排他锁）和 LOCK_SH（共享锁），写操作必须用 LOCK_EX
阻塞 vs 非阻塞：用 LOCK_EX 会阻塞，加 LOCK_NB 可立即返回错误（如 resource temporarily unavailable）

示例片段：

fd, _ := os.OpenFile("data.txt", os.O_RDWR|os.O_CREATE, 0644)
defer fd.Close()
syscall.Flock(int(fd.Fd()), syscall.LOCK_EX)
// 此处安全写入
fd.Write([]byte("new content"))

Windows 下如何替代 `flock`

Windows 没有 flock 系统调用，得用 syscall.LockFileEx，且需注意句柄权限和锁范围。标准库 golang.org/x/sys/windows 提供了封装，但底层仍需手动管理。

容易踩的坑：LockFileEx 要求文件句柄以 GENERIC_READ | GENERIC_WRITE 打开，并且锁区域不能为 0；若只传 0 作偏移/长度，会失败并报 ERROR_INVALID_PARAMETER。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

必须用 windows.CreateFile 打开文件（不能用 os.OpenFile），否则句柄无足够权限
锁范围推荐设为整个文件：numberOfBytesToLockLow = 1，numberOfBytesToLockHigh = 0（即锁 1 字节，但配合 LOCKFILE_EXCLUSIVE_LOCK 实际效果等价于全文件排他）
释放锁需调用 windows.UnlockFileEx，不能依赖句柄关闭自动释放
跨平台代码建议封装一个 FileLock 接口，Linux 用 syscall.Flock，Windows 用 windows.LockFileEx

`os.Chmod` 和 `os.Chown` 会影响 `flock` 吗？

不影响。flock 锁与文件元数据无关，只关联打开的文件描述符。改权限、属主、甚至重命名文件，只要 fd 未关闭，锁依然有效。但要注意：如果进程先 flock，再 os.Rename 原文件，其他进程按原路径 open 得到的是新文件（无锁），旧 fd 还锁着已重命名的文件——这会造成逻辑错位。