Facebook/jemalloc 内存分配器编译与安装完全指南

jemalloc 是由 Facebook 开发的高性能内存分配器，广泛应用于各种大型系统中。本文将全面介绍 jemalloc 的编译安装过程，包括基础安装、高级配置选项以及针对不同平台的特殊编译方法。

基础安装方法

对于大多数用户来说，jemalloc 的安装过程非常简单：

标准版本安装

./configure
make
make install

开发版本安装

如果是从开发源码构建，需要先运行 autogen.sh：

./autogen.sh
make
make install

卸载方法

make uninstall

注意事项：

• 开发版本构建需要 autoconf 工具
• 文档生成需要 xsltproc 工具，如果缺失会警告但不会中断构建

高级配置选项

jemalloc 提供了丰富的配置选项，可以精确控制其功能和安装位置。

常用配置选项

1. 安装路径设置：

   ./configure --prefix=/usr/local
   

   这将把文件安装到 /usr/local/include、/usr/local/lib 和 /usr/local/man 目录下。

2. 版本控制：

   ./configure --with-version=5.2.1-0-g123456
   

   用于指定自定义版本号，对于嵌入式项目特别有用。

3. 符号前缀：

   ./configure --with-jemalloc-prefix=myapp_
   

   这会将所有公共 API 加上前缀，例如 malloc() 会变成 myapp_malloc()。

功能配置选项

1. 调试支持：

   ./configure --enable-debug
   

   启用断言和验证代码，对开发很有帮助但会影响性能。

2. 性能分析：

   ./configure --enable-prof
   

   启用堆分析功能，支持多种回溯方法：

   • libunwind (需要 --enable-prof-libunwind)
   • 帧指针 (需要 --enable-prof-frameptr)
   • libgcc (默认启用)
   • gcc 内置函数 (默认启用)

3. 内存填充：

   ./configure --disable-fill
   

   禁用内存填充功能，可以提高性能但降低安全性。

平台特定选项

1. Darwin 系统：

   ./configure --disable-zone-allocator
   

   禁用 Darwin 的 zone 分配器，避免成为默认分配器。

2. 页面大小设置：

   ./configure --with-lg-page=12
   

   设置分配器页面大小的对数（以2为底），12 表示 4KB 页面。

3. 对齐设置：

   ./configure --with-lg-quantum=4
   

   设置最小分配对齐为 16 字节（2^4）。

环境变量控制

构建过程可以通过多种环境变量进行控制：

• CFLAGS/CXXFLAGS：传递给编译器的标志
• EXTRA_CFLAGS/EXTRA_CXXFLAGS：追加到 CFLAGS 但不影响配置测试
• CPPFLAGS：传递给 C 预处理器的标志
• LD_LIBRARY_PATH：库搜索路径
• LDFLAGS：链接器标志
• PATH：程序搜索路径

高级编译技巧

部分构建

可以只构建 jemalloc 的特定部分：

make build_lib_shared  # 只构建共享库
make build_doc_html   # 只构建HTML文档

部分安装

同样可以只安装特定部分：

make install_include  # 只安装头文件
make install_lib      # 只安装库文件

清理选项

不同程度的清理：

make clean      # 基本清理
make distclean  # 深度清理
make relclean   # 发布清理

Windows 平台构建

在 Windows 上构建 jemalloc 有两种主要方法：

使用 MSVC 解决方案（简单方法）

1. 安装 Cygwin 和必要工具（autoconf、autogen 等）
2. 安装 Visual Studio 2015/2017
3. 生成头文件：

   sh -c "CC=cl ./autogen.sh"
   

4. 在 Visual Studio 中打开解决方案文件：

   msvc\jemalloc_vc2017.sln
   

使用 MSYS（灵活方法）

这种方法提供与 Linux 构建相同的配置灵活性：

1. 安装 MSYS2 和 Chocolatey
2. 根据需要设置环境变量：

   CROSS_COMPILE_32BIT="no"  # 64位构建
   CC="gcc"                 # 使用 GCC
   USE_MSVC=""              # 不使用 MSVC
   

3. 使用构建环境执行命令：

   $build_env ./configure
   $build_env mingw32-make
   

使用 vcpkg

vcpkg 提供了便捷的 jemalloc 安装方式：

./vcpkg install jemalloc

总结

jemalloc 作为一个高性能内存分配器，其构建系统提供了极大的灵活性。无论是简单的默认安装，还是针对特定平台的定制构建，都能通过合理的配置选项实现。对于开发者来说，理解这些构建选项可以帮助更好地将 jemalloc 集成到自己的项目中，并根据具体需求进行优化。

对于 Windows 平台用户，建议根据具体需求选择 MSVC 解决方案或 MSYS 方法，前者更简单，后者则提供了与 Linux 一致的配置体验。无论选择哪种方式，jemalloc 都能为应用程序提供高效的内存管理能力。