Go 中 mmap 必须用 syscall.Mmap 或第三方封装,因标准库无跨平台抽象;syscall.Mmap 仅 Unix 可用,Windows 需 x/sys/windows;直接使用风险高,需严格校验 prot、flags、文件大小及显式 msync 刷盘。

Go 里用 mmap 必须依赖 syscall.Mmap 或第三方封装
Go 标准库不提供跨平台的 mmap 抽象,syscall.Mmap 是唯一原生入口,但它只在 Unix-like 系统(Linux/macOS)可用,Windows 上得换用 golang.org/x/sys/windows 的 VirtualAlloc + CreateFileMapping。直接调 syscall.Mmap 风险高:参数顺序易错、错误码需手动判别、映射后没配好 prot 和 flags 会导致段错误或写失败。
实操建议:
-
prot至少设为syscall.PROT_READ,若要写入必须加syscall.PROT_WRITE;flags写文件时推荐syscall.MAP_SHARED(同步回磁盘),仅读可选MAP_PRIVATE(避免脏页回写开销) - 映射长度不能超过文件实际大小(
os.Stat先查),否则Mmap返回EINVAL - 映射成功后得到的是
[]byte切片,但底层是虚拟内存地址,禁止对它做append或重切(会 panic)
mmap 写文件时,msync 不是可选项而是强依赖
用 MAP_SHARED 映射后修改内存,内核只保证“最终”刷盘,不保证立刻落盘——断电或崩溃可能丢数据。Go 没有标准 msync 封装,得调 syscall.Msync 手动刷。
常见错误现象:WriteFile 看似成功,但程序退出后文件内容没变,或只更新了前 N 字节。
使用场景与建议:
- 关键数据写入后立即调
syscall.Msync(addr, syscall.MS_SYNC),MS_SYNC比MS_ASYNC更安全(阻塞直到刷完) - 频繁小写入别每写一次都
msync,攒批后统一刷,否则 I/O 开销反超普通Write - 映射区被
munmap前务必msync,否则未刷数据直接丢失
零拷贝 ≠ 零成本:mmap 在 Go 中的性能陷阱
很多人以为 mmap 就是“绕过内核缓冲区”,其实不然:Linux 下 mmap 仍走 page cache,只是省掉了用户态 memcpy。真正收益在大文件随机读、多进程共享访问、或配合 madvice 做预读/释放提示。
容易踩的坑:
- 小文件( 复制成本
- 并发读多个 mmap 区域时,若没控制总映射大小,容易触发
ENOMEM(进程虚拟内存耗尽) - Go runtime GC 不管理 mmap 内存,必须显式
syscall.Munmap,否则泄漏(runtime.ReadMemStats里的HeapSys不含它,但VmSize会涨)
替代方案比硬啃 syscall.Mmap 更实用
除非你明确需要多进程共享内存或精细控制 page fault 行为,否则优先考虑更稳的路径:
- 纯读大文件:用
bufio.NewReader(os.NewFile(...))+ReadAt,结合os.File.Seek随机读,现代 Linux 的 read-ahead 已很高效 - 需要零拷贝网络发送:直接
file.ReadAt到 socket buffer(net.Conn.Write底层可能触发sendfile),比 mmap 更轻量 - 真要 mmap 封装:用
github.com/edsrzf/mmap-go(它自动处理平台差异、panic 安全、msync封装),但注意它默认用MAP_PRIVATE,写文件必须显式传mmap.RDWR
最常被忽略的一点:mmap 后的内存访问是 page fault 驱动的,第一次读某页会卡住——如果业务对延迟敏感,得提前 madvise(MADV_WILLNEED) 预热,而 Go 标准库连这个都没暴露。


















