优先使用封装库（如 mmap-go）而非 syscall.Mmap：它自动处理跨平台、页对齐、错误转换、切片长度校验，并支持安全并发、Flush 同步和分段映射，避免 SIGBUS 和 panic。
直接用 syscall.Mmap 处理大文件内存映射，在 Go 里基本等于主动踩坑——它不校验参数、不跨平台、不处理页对齐、不管理生命周期，出错就是 SIGBUS 或 panic: invalid argument，而且修起来毫无头绪。真要高效读取大文件，优先走封装库，别自己拼系统调用。
为什么 mmap.Open() 比 syscall.Mmap() 更安全
第三方库如 github.com/edsrzf/mmap-go 封装了底层差异：Linux 调 mmap(2)，Windows 调 CreateFileMapping + MapViewOfFile，自动处理页对齐（4096 字节）、错误码转换、MAP_POPULATE 优化，还把返回的 []byte 的 len 和 cap 设对了——你自己用 unsafe.Slice 手动构造切片时，漏掉长度校验或越界计算，运行时就崩。
-
mmap.Open("data.bin")默认只读映射整个文件，返回的mmap.Map可直接当[]byte用，无需unsafe操作 - 写入场景必须显式传
mmap.RDWR，否则m.IsWritable()返回false，后续写操作会触发SIGBUS - 它内部已加锁，支持多 goroutine 并发调
Unmap()，而裸syscall.Munmap多次调用直接 crash
映射前必须校验文件大小和权限
常见 panic: invalid argument 不是代码写错，而是映射长度超过文件当前大小，或文件打开模式与 prot 不匹配。比如只用 os.Open 打开文件却想写入，或用 f.Stat().Size() 得到 1.2GB 却硬写 1024 * 1024 * 1024 * 2 当长度。
- 务必先调
f.Stat()拿真实大小，别信文件名、配置项或常量 - 只读映射用
os.Open+mmap.RDONLY；写入必须用os.OpenFile(name, os.O_RDWR, 0)+mmap.RDWR - 想写入并扩大文件？得先
syscall.Ftruncate(int(f.Fd()), newSize)，mmap不会自动扩容
写入后不 Flush() = 数据可能永远不落盘
mmap-go 默认用 MAP_SHARED，修改会反映到文件，但仅驻留在 page cache —— 程序退出、崩溃或断电，没刷过的数据就丢了。这不是 bug，是 mmap 的语义设计。
立即学习“go语言免费学习笔记（深入）”；
- 每次关键写入后，必须显式调
mm.Flush()（等价于msync(MS_SYNC)） - 别依赖
defer mm.Close()：它只做munmap，不触发同步 - 高频小写建议批量改完再
Flush()，避免阻塞；低延迟要求场景才每改必刷 - 如果只是临时缓存（如解压中间态），可用
mmap.RDWR | mmap.PRIVATE，但该库不暴露 flag 控制，得退回裸系统调用
大文件别一股脑全映射，按需分段更稳
映射几十 GB 文件在技术上可行，但风险高：虚拟地址空间碎片化、缺页中断密集、TLB 压力大，随机跳读反而比 bufio.NewReader(f).Read() 更慢。尤其在物理内存不足时，内核频繁换页，磁盘抖动明显。
- 用
f.Stat().Size()获取总大小，按固定块（如 64MB）切分逻辑区间 - 每次只映射当前需要访问的块：
mm, _ := mmap.Map(file, mmap.RDONLY, offset, length) - 确保
offset是页对齐的（offset & 4095 == 0），否则 Linux 下直接失败 - 读完立刻
mm.Unmap()，别缓存整个[]byte，改用copy(dst, mm[off:off+n])局部读取
最易被忽略的一点：mmap 区域没有 Go 运行时感知，append 到映射底层数组、用 len(m) 判断边界、或文件被其他进程 truncate 后继续访问，都会触发 SIGBUS——它不是 panic，是信号终止，连 defer 都来不及跑。始终用 m.Len() 和 m.IsWritable()，别信直觉。
