Microsoft mimalloc 内存分配库使用指南

Microsoft mimalloc 内存分配库使用指南

mimalloc mimalloc is a compact general purpose allocator with excellent performance. 项目地址: https://gitcode.com/gh_mirrors/mi/mimalloc

什么是 mimalloc

mimalloc 是微软开发的一款高性能内存分配器，具有以下显著特点：

• 专为现代多核处理器优化
• 内存分配速度快于传统 malloc 实现
• 内存碎片率低
• 线程安全且扩展性好
• 可与其他分配器共存

基础使用方法

编译链接

推荐的使用方式是包含 <mimalloc.h> 头文件，并链接 mimalloc 的动态或静态库：

gcc -o myprogram -lmimalloc myfile.c

mimalloc 仅使用安全的操作系统调用（如 mmap 和 VirtualAlloc），可以与程序中的其他分配器共存。

CMake 集成

如果使用 CMake 构建系统，可以简单地在 CMakeLists.txt 中添加：

find_package(mimalloc 2.1 REQUIRED)

然后选择链接方式：

# 链接动态库
target_link_libraries(myapp PUBLIC mimalloc)

# 或链接静态库
target_link_libraries(myapp PUBLIC mimalloc-static)

C++ 集成方案

重载全局操作符

为了在 C++ 程序中获得最佳性能，建议重载全局的 new 和 delete 操作符。mimalloc 提供了便捷的头文件 mimalloc-new-delete.h，只需在项目中任意一个源文件中包含它即可。

STL 分配器

mimalloc 还提供了符合 STL 标准的分配器 mi_stl_allocator，可以用于 STL 容器：

#include <mimalloc.h>
#include <vector>

std::vector<some_struct, mi_stl_allocator<some_struct>> vec;
vec.push_back(some_struct());

统计信息与调试

mimalloc 提供了丰富的统计信息输出功能，通过环境变量控制：

• MIMALLOC_VERBOSE=1：输出详细日志
• MIMALLOC_SHOW_STATS=1：显示内存统计信息（调试版本）

示例输出展示了各种内存类型的分配情况，包括：

• 常规内存块的峰值使用量、总量和释放量
• 大内存块(huge)的使用情况
• 系统提交的内存总量
• 线程统计信息
• 进程运行时间等

高级使用：替换标准 malloc

在某些情况下，可能需要完全替换标准 malloc 接口，将所有内存分配调用重定向到 mimalloc。这可以通过特定的编译选项或链接方式实现，适用于需要全局替换内存分配器的场景。

性能考量

mimalloc 经过精心设计，在以下方面表现优异：

1. 多线程性能：采用线程本地缓存减少锁竞争
2. 内存利用率：减少内存碎片，提高缓存命中率
3. 扩展性：随着线程数增加保持良好性能
4. 安全性：内置防护机制防止常见内存错误

适用场景

mimalloc 特别适合以下应用场景：

• 高性能服务器应用
• 内存密集型计算程序
• 需要长时间运行的守护进程
• 多线程并发量大的应用
• 对内存碎片敏感的系统

通过合理配置和使用 mimalloc，开发者可以显著提升应用程序的内存管理效率，降低系统资源消耗。

mimalloc mimalloc is a compact general purpose allocator with excellent performance. 项目地址: https://gitcode.com/gh_mirrors/mi/mimalloc