最大的坑是将POSIX与Windows内存映射语义误认为“差不多”:mmap返回指针,Windows需CreateFileMapping+MapViewOfFile配对;Windows无MAP_SHARED/MAP_PRIVATE等价机制,匿名映射不兼容;文件句柄/生命周期绑定不同,对齐要求迥异(64KB vs 页对齐),混写必然导致数据一致性错误、资源泄漏或运行时崩溃。

为什么不能直接用 mmap 或 CreateFileMapping 写业务逻辑
跨平台内存映射封装最大的坑,是把 POSIX 和 Windows 的语义差异硬凑成一个接口。比如 mmap 返回的是指针,CreateFileMapping+MapViewOfFile 是两步操作;又比如 Windows 要求先创建句柄再映射,而 Linux 可以直接从 fd 映射;还有大小端、页面对齐、写时复制(COW)行为、错误码含义(errno vs GetLastError())全都不一致。直接套一层“统一函数”只会让调用方更难 debug。
MemoryMappedFile 基类该暴露哪些核心能力
轻量级不等于功能少,而是聚焦真正共用的语义:打开/关闭、读/写视图、同步刷盘、获取长度。其他如保护模式(PROT_READ/PAGE_READONLY)、映射偏移、是否允许扩展文件等,应作为构造参数或方法选项显式传入,而不是隐藏在默认行为里。
-
open(const std::string& path, size_t size_hint = 0, bool writable = true, bool create_if_missing = false)——size_hint在 Windows 上用于初始映射大小,在 Linux 上可忽略(ftruncate后再mmap) -
view(size_t offset, size_t length) -> std::span<uint8_t></uint8_t>—— 返回只读/可写视图,内部按平台做地址转换,不暴露原始指针 -
flush()—— 对应msync或FlushViewOfFile,仅对 dirty 视图生效 -
size() const—— 必须每次调用都查真实文件长度(stat/GetFileSizeEx),不能缓存,因为外部可能并发修改文件
Windows 下绕不开的句柄泄漏和映射生命周期问题
Windows 要求:文件句柄、映射对象句柄、视图地址三者必须成对关闭,顺序错一点就泄漏。常见错误是 CloseHandle 调太早,或者 UnmapViewOfFile 失败后没重试导致后续 CloseHandle 无效。
- 构造时用 RAII 管理
HANDLE:文件句柄和映射句柄分别用std::unique_ptr+ 自定义 deleter(CloseHandle) -
view()返回的std::span不持有所有权,但基类内部需记录所有活跃视图地址,析构前逐个调UnmapViewOfFile - 如果
CreateFileMapping失败且GetLastError() == ERROR_INVALID_HANDLE,大概率是文件没开成功,别急着报“映射失败”,先检查上一步的CreateFile
Linux 下 mmap 失败时最该查的三件事
mmap 返回 MAP_FAILED 很常见,但错误原因往往藏在别处:
立即学习“C++免费学习笔记(深入)”;
- 文件描述符
fd是否有效?open()是否漏了O_RDWR(即使只读也要O_RDONLY,否则mmap拒绝) - 映射长度是否为 0?
mmap不允许length == 0,哪怕只是占位也要设成 1 - 是否越界访问?
mmap成功不代表能读写整个范围——若文件实际长度小于映射长度,访问末尾会触发SEGV_MAPERR,不是mmap的错,是read()或write()没提前扩展文件
跨平台封装没法消除这些底层约束,只能把检查点固化进 open() 流程里:Linux 下强制 fstat 验证文件存在且非目录,Windows 下用 GetFileType 排除管道/设备。


















