Windows与POSIX内存映射存在设计契约冲突：大小指定方式、文件增长支持、单次映射上限（Windows 4GB限制）、分片机制等根本不同，硬套宏封装必在边界场景崩溃；std::span<std::byte>是唯一安全视图抽象，配合按需分片映射与LRU缓存可跨平台可靠使用。
为什么不能直接用 mmap 或 CreateFileMapping 写跨平台封装
因为 Windows 和 POSIX 的内存映射 API 行为差异远超表面：Windows 的 CreateFileMapping + MapViewOfFile 要求显式指定最大大小（必须提前知道或预留），而 mmap 的 MAP_SHARED 可随文件增长自动生效；Windows 不支持“映射超过当前文件大小的区域”（会失败），POSIX 却允许（配合 ftruncate 即可）；另外，Windows 映射视图有 4GB 单次上限（32 位视图），大文件必须分段映射——这些不是语法差异，是设计契约冲突，硬套一层宏封装必然在边界场景崩溃。
std::span<std::byte> 是唯一安全的视图抽象方式
别用 char* 或 void* 当返回值。大文件映射必须支持按需分片访问，且调用方不能假设指针长期有效（比如 Windows 解映射后指针立刻失效，而 mmap 在 munmap 前仍可读）。正确做法是每次访问都返回一个轻量 std::span<std::byte>，它只保有起始地址和长度，不持有映射资源本身：
// 示例：获取从 offset 开始、length 字节的可读视图
auto view = mapping.view(1024ULL * 1024ULL * 1024ULL, 8192); // 1GB 处读 8KB
if (!view.has_value()) {
// 映射失败（如超出文件尾、权限不足、Windows 分片越界等）
}
// view.value() 是 std::span<std::byte>关键点：
-
view()方法内部按需触发分片映射（Windows 每次调MapViewOfFile，POSIX 复用同一mmap地址但检查 offset 是否越界） - 返回的
std::span不管理生命周期，调用方用完即弃，避免悬挂指针 - 必须用
std::byte，禁止隐式转char*——防止误当 C 字符串处理（二进制文件含 \0）
Windows 下必须手动管理 HANDLE 和 MapViewOfFile 生命周期
POSIX 的 mmap 地址可长期复用，Windows 的每个 MapViewOfFile 返回独立视图，且 UnmapViewOfFile 必须配对调用，否则泄漏句柄（进程级资源，非内存）。所以包装类内部要维护一个 LRU 视图缓存：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
- 缓存键为
{base_offset, length}（对齐到系统页大小，如 4KB） - 每次
view(offset, len)先查缓存，命中则复用LPVOID；未命中则新映射，并在缓存满时淘汰最久未用项 - 析构时遍历缓存，对每个有效视图调
UnmapViewOfFile，再关闭hMapping - 注意：
hFile必须以FILE_FLAG_RANDOM_ACCESS打开，否则大文件映射性能暴跌
大文件（>2GB）在 32 位程序中根本不可行，64 位是硬门槛
别试图兼容 32 位进程。Windows 上 MapViewOfFile 的 dwNumberOfBytesToMap 是 DWORD（最大 4GB），但实际单次映射建议不超过 512MB（避免地址空间碎片）；POSIX 的 off_t 和 size_t 在 32 位系统上通常只有 4GB 寻址能力，mmap 会静默截断 offset。实操结论：
- 所有接口参数必须用
uint64_t接收 offset/length（而非size_t或off_t） - CMake 中强制
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -m64")（Linux/macOS）或启用/D "_WIN64"（MSVC） - 运行时检测：构造时用
GetFileSizeEx（Windows）或stat.st_size（POSIX）确认文件大小是否 >UINT32_MAX，若是则直接报错并提示“仅支持 64 位构建”
真正棘手的是 mmap 在 ext4 上对 >512GB 文件的延迟分配问题——首次写入可能卡住数百毫秒，这无法被包装类屏蔽，只能由业务层预热（用 madvise(MADV_WILLNEED) 或 Windows 的 PrefetchVirtualMemory）。
