在 Windows 平台上，Go 标准库的 syscall.Flock 不可用，需通过 Windows 原生 API（如 LockFileEx）调用底层文件锁机制，本文详解如何使用 golang.org/x/sys/windows 安全、可靠地实现跨进程文件独占锁。
在 windows 平台上，go 标准库的 `syscall.flock` 不可用，需通过 windows 原生 api（如 `lockfileex`）调用底层文件锁机制，本文详解如何使用 `golang.org/x/sys/windows` 安全、可靠地实现跨进程文件独占锁。
Windows 系统不支持 POSIX 风格的文件锁（如 flock），因此 Go 的 syscall.Flock 在 Windows 上直接返回 ENOSYS 错误。要实现真正的进程间独占文件锁（即其他进程无法同时读写该文件），必须调用 Windows 原生的文件锁定 API：LockFileEx（推荐）或 LockFile。其中 LockFileEx 支持重叠 I/O、可中断等待、共享/独占模式及字节范围锁，功能更完备且符合现代实践。
以下是一个生产就绪的 Go 实现示例，使用 golang.org/x/sys/windows 包封装 LockFileEx：
package main
import (
"errors"
"fmt"
"os"
"syscall"
"unsafe"
"golang.org/x/sys/windows"
)
const (
LOCKFILE_EXCLUSIVE_LOCK = 2
INFINITE = 0xFFFFFFFF
)
// FileLock 封装 Windows 文件句柄与锁状态
type FileLock struct {
handle windows.Handle
}
// NewFileLock 打开文件并获取可锁定句柄（需 GENERIC_READ | GENERIC_WRITE 权限）
func NewFileLock(path string) (*FileLock, error) {
h, err := windows.CreateFile(
windows.StringToUTF16Ptr(path),
windows.GENERIC_READ|windows.GENERIC_WRITE,
0, // 不共享 —— 关键：禁止其他进程同时打开
nil,
windows.OPEN_EXISTING,
windows.FILE_ATTRIBUTE_NORMAL,
0,
)
if err != nil {
return nil, fmt.Errorf("failed to open file: %w", err)
}
return &FileLock{handle: h}, nil
}
// Lock 对整个文件加独占锁（阻塞式）
func (fl *FileLock) Lock() error {
var overlapped windows.Overlapped
// 锁定全部文件范围：0 到 0（表示从当前偏移开始，长度为 0 → 即整个文件）
err := windows.LockFileEx(
fl.handle,
LOCKFILE_EXCLUSIVE_LOCK,
0, // flags: 无额外标志
0, // lowBytes: 锁定长度低32位（0 表示无限长）
0, // highBytes: 锁定长度高32位
&overlapped,
)
if err != nil {
return fmt.Errorf("failed to acquire exclusive lock: %w", err)
}
return nil
}
// Unlock 释放锁（注意：CloseHandle 也会自动释放锁，但显式 Unlock 更清晰）
func (fl *FileLock) Unlock() error {
err := windows.UnlockFileEx(fl.handle, 0, 0, 0, nil)
if err != nil {
return fmt.Errorf("failed to release lock: %w", err)
}
return nil
}
// Close 关闭句柄（隐式解锁，必须调用）
func (fl *FileLock) Close() error {
return windows.CloseHandle(fl.handle)
}
// 使用示例
func main() {
lock, err := NewFileLock(`C:\temp\shared.dat`)
if err != nil {
panic(err)
}
defer lock.Close()
fmt.Println("Attempting to acquire exclusive lock...")
if err := lock.Lock(); err != nil {
panic(fmt.Sprintf("lock failed: %v", err))
}
defer lock.Unlock()
fmt.Println("Lock acquired successfully. File is now exclusively locked.")
// 此处可安全执行读写操作
file, _ := os.OpenFile(`C:\temp\shared.dat`, os.O_RDWR, 0)
defer file.Close()
// ... 业务逻辑
}✅ 关键注意事项：
- 打开模式决定锁有效性：必须以 GENERIC_READ | GENERIC_WRITE 打开文件，且 dwShareMode = 0（即不共享），否则其他进程仍可打开文件，导致锁失效；
- 锁作用域是句柄级别：同一进程内多个句柄对同一文件加锁不会冲突；但跨进程时，只要任一进程持有有效句柄并加锁，其他进程 LockFileEx 就会阻塞或失败；
- 锁随句柄关闭自动释放：即使未显式调用 UnlockFileEx，CloseHandle 也会释放锁——但显式 Unlock 更利于资源管理和调试；
- 避免死锁：LockFileEx 默认阻塞，如需超时控制，可传入 &overlapped 并配合 WaitForSingleObject，或设置 LOCKFILE_FAIL_IMMEDIATELY 标志（需自行处理 ERROR_IO_PENDING）；
- 权限要求：调用进程需对目标文件具有读写权限，且路径存在；若遇 "Access is denied"，请检查 UAC、防病毒软件拦截或文件是否被系统/其他应用占用（如记事本、资源管理器预览）。
总结：在 Windows 上实现 Go 文件独占锁，应放弃 POSIX 思维，转而拥抱 Win32 API。通过 golang.org/x/sys/windows 调用 LockFileEx，配合正确的文件打开方式和错误处理，即可构建健壮、可移植的跨进程文件同步机制。该方案已被 go-sqlite3、boltdb 等主流项目采用，具备充分的工程验证。
