在 Windows 上使用 Go 实现文件独占锁需绕过不支持 syscall.Flock 的限制，可通过调用 Win32 API 的 LockFileEx 函数完成跨进程、可重入、支持共享/独占语义的底层文件锁定。
在 windows 上使用 go 实现文件独占锁需绕过不支持 `syscall.flock` 的限制，可通过调用 win32 api 的 `lockfileex` 函数完成跨进程、可重入、支持共享/独占语义的底层文件锁定。
Go 标准库的 syscall.Flock 在 Windows 平台上不可用（仅限 Unix-like 系统），因此无法直接复用类 Unix 的文件锁逻辑。但 Windows 提供了成熟的 Win32 文件锁定机制：LockFileEx 是推荐的现代接口，支持重叠 I/O、超时控制、共享/独占模式切换及字节范围锁，相比已废弃的 LockFile 更加灵活与健壮。
要从 Go 调用 LockFileEx，需借助 golang.org/x/sys/windows 包（官方维护的 Windows 系统调用封装），避免手动使用 syscall.Syscall6（易因参数顺序、调用约定或权限问题导致 “Access is denied” 错误，如原提问中所述）。
以下是一个生产就绪的独占锁封装示例：
package main
import (
"errors"
"os"
"syscall"
"unsafe"
"golang.org/x/sys/windows"
)
type FileLock struct {
handle windows.Handle
}
// NewExclusiveLock 尝试以独占模式锁定整个文件（阻塞式）
func NewExclusiveLock(path string) (*FileLock, error) {
f, err := os.OpenFile(path, os.O_RDWR, 0)
if err != nil {
return nil, err
}
// 必须使用 FILE_SHARE_NONE 实现真正独占（禁止其他进程读/写/删除）
// 注意：若文件已被其他进程以非 NONE 方式打开，此处会失败
h, err := windows.CreateFile(
windows.StringToUTF16Ptr(path),
windows.GENERIC_READ|windows.GENERIC_WRITE,
0, // 不共享：关键！等价于 FILE_SHARE_NONE
nil,
windows.OPEN_EXISTING,
windows.FILE_ATTRIBUTE_NORMAL,
0,
)
if err != nil {
f.Close()
return nil, err
}
// 调用 LockFileEx：LOCKFILE_EXCLUSIVE_LOCK | LOCKFILE_FAIL_IMMEDIATELY（可选）
// 此处使用阻塞式锁定（移除 FLAG 即可）
err = windows.LockFileEx(h, windows.LOCKFILE_EXCLUSIVE_LOCK, 0,
0xffffffff, // 高32位长度（0表示锁整个文件）
0xffffffff, // 低32位长度
&windows.Overlapped{}) // 同步调用，Overlapped 可为零值
if err != nil {
windows.CloseHandle(h)
f.Close()
return nil, errors.New("failed to acquire exclusive lock: " + err.Error())
}
return &FileLock{handle: h}, nil
}
// Unlock 释放锁并关闭句柄
func (fl *FileLock) Unlock() error {
defer windows.CloseHandle(fl.handle)
return windows.UnlockFileEx(fl.handle, 0, 0xffffffff, 0xffffffff, &windows.Overlapped{})
}
// 使用示例
func main() {
lock, err := NewExclusiveLock("config.json")
if err != nil {
panic(err)
}
defer lock.Unlock()
// 此时其他进程调用 NewExclusiveLock("config.json") 将阻塞或返回错误
// 可安全执行读写操作...
}⚠️ 关键注意事项：
- 句柄共享模式决定锁有效性：必须以 dwShareMode = 0（即 FILE_SHARE_NONE）打开文件，否则即使调用 LockFileEx 成功，其他进程仍可通过不同句柄访问该文件，破坏“独占”语义；
- 锁作用于句柄，非文件路径：同一进程内重复调用 NewExclusiveLock 会创建新句柄并尝试再次加锁——若未释放前锁，将失败（Windows 不允许同一线程对同一区域重复加独占锁）；
- 进程退出时自动释放：Windows 会在句柄关闭或进程终止时自动释放所有关联锁，无需显式 Unlock（但强烈建议显式调用以提升可预测性）；
- 避免 syscall.Syscall6 手动调用：它绕过了 x/sys/windows 的安全封装，易因 ABI 差异（如 uintptr vs uint32）、错误码映射或权限上下文引发 Access is denied；始终优先使用高阶封装函数。
综上，通过 golang.org/x/sys/windows 调用 LockFileEx 是 Windows 下 Go 实现可靠文件独占锁的标准实践。它兼顾安全性、兼容性与可控性，适用于配置文件保护、单实例程序协调、日志轮转同步等典型场景。
