跨平台文件锁必须分平台实现:Linux/macOS用flock,Windows用CreateFile独占打开;不可用chmod“假装”加锁,否则Windows会panic。

Go 中 os.File.Chmod 不能跨平台实现文件锁
直接用 os.Chmod 或修改文件权限来“假装”加锁,不仅无效,还会在 Windows 上 panic —— 因为 os.Chmod 在 Windows 下忽略权限位,且不提供互斥语义。文件锁的本质是原子性资源抢占,必须依赖操作系统内核提供的同步原语。
flock 在 Linux/macOS 可用,但 Windows 完全不支持
flock 是 POSIX 标准的 advisory 锁,Go 通过 syscall.Flock(Unix)或 x/sys/unix.Flock 调用。但它在 Windows 上没有对应系统调用,golang.org/x/sys/windows 里根本没有 Flock 函数。强行编译会报 undefined: syscall.Flock。
常见错误现象:
- 本地 macOS 测试通过,CI(Windows runner)构建失败
- 使用 // +build linux darwin 分离代码后,Windows 下静默跳过锁逻辑,导致竞态
- 不要用
build tags单独启用flock后就认为“跨平台”了——没实现 ≠ 无问题 - advisory 锁本身不阻塞其他进程直接读写文件,仅靠约定生效;若程序崩溃未释放,锁文件可能残留
-
flock锁绑定的是打开的文件描述符,不是路径;进程 fork 或 dup 后子进程会继承锁,需注意生命周期
真正跨平台的方案:用 golang.org/x/sys/unix + golang.org/x/sys/windows 组合 + 临时文件探测
核心思路是:不追求“同一套 API”,而是用各平台原生机制模拟等价行为 —— Linux/macOS 用 flock,Windows 用 CreateFile 的 FILE_SHARE_NONE 标志打开锁文件,再配合原子性 os.Rename 或 os.Link 做抢占校验。
实操建议:
- 锁文件路径统一用
filepath.Join(os.TempDir(), "myapp.lock"),避免路径权限问题 - Linux/macOS:用
x/sys/unix.Flock(fd, unix.LOCK_EX|unix.LOCK_NB),失败返回syscall.EWOULDBLOCK - Windows:用
windows.CreateFile打开锁文件,flags 设为windows.GENERIC_WRITE,shareMode 设为0(即FILE_SHARE_NONE),句柄保持打开状态表示持有锁 - 务必设置超时(如
time.AfterFunc定期检查锁文件 mtime 或进程是否存在),防止死锁残留
示例关键判断:
if runtime.GOOS == "windows" {
// 尝试以独占方式打开锁文件
h, err := windows.CreateFile(
syscall.StringToUTF16Ptr(lockPath),
windows.GENERIC_WRITE,
0, // no sharing
nil,
windows.CREATE_ALWAYS,
windows.FILE_ATTRIBUTE_NORMAL,
0,
)
if err != nil {
return false, err
}
lockHandle = h
} else {
fd, _ := os.OpenFile(lockPath, os.O_CREATE|os.O_RDWR, 0644)
unix.Flock(int(fd.Fd()), unix.LOCK_EX|unix.LOCK_NB)
}
更省心的选择:github.com/nightlyone/lockfile 库的取舍
这个库封装了上述平台差异,对外暴露统一的 Lock()/Unlock(),内部自动选型。但它有两个关键限制:
- 不支持阻塞等待(即没有
LockWithTimeout),调用Lock()立即返回成功或失败 - Windows 下实际使用的是命名管道(
CreateNamedPipe)而非文件句柄独占,对某些受限环境(如容器、CI worker)可能被策略拦截 - 它把锁文件内容写入 PID,但不验证该 PID 是否仍在运行 —— 若进程崩溃,锁不会自动释放,需额外清理逻辑
如果你的应用能接受“尽力而为”的锁(例如 CLI 工具单机运行防误触发),它足够用;但如果是后台服务长期运行,必须自己补上锁存活检测和清理路径。
跨平台文件锁最麻烦的从来不是“怎么加”,而是“怎么确认它真的有效、且在异常后可恢复”——这点无论手写还是用库,都绕不开。











