编译folly

在这里选择要安装的版本：https://github.com/facebook/folly/releases

git clone https://github.com/facebook/folly
cd folly
git checkout v2025.10.20.00

（可选）虚拟环境

如果需要特定版本的编译器或者python包，建议安装在虚拟环境里。

mkdir ~/.venvs/folly
python3 -m venv ~/.venvs/folly
. ~/.venvs/folly/bin/activate

GCC 13

不兼容GCC 14，会报错：

.../folly/folly/container/test/ForeachTest.cpp:318:39: error: use of built-in trait ‘__type_pack_element<I, T ...>’ in function signature; use library traits instead
  318 |   static type_pack_element_t<I, T...> elem;
      |                                       ^~~~

看起来是因为folly用了编译器private的东西，gcc14会报错：https://github.com/facebook/folly/issues/2493

这个PR旨在修复这个问题，但还没合进去：https://github.com/facebook/folly/pull/2499

所以如果系统的g++是g++-14，要换成g++-13：

sudo apt install -y g++-13
export CC=gcc-13
export CXX=g++-13

但是不知道为什么boost编译的时候还是会用默认的g++，导致后面会报这个错误：

extracted/boost-boost_1_83_0.tar.gz/boost_1_83_0/libs/filesystem/src/directory.cpp:1348:(.text.unlikely+0x3da): undefined reference to `__cxa_call_terminate'

根据https://forums.gentoo.org/viewtopic-t-1172390-start-0.html，应该是因为之前boost用的GCC 14，但其他的用的GCC 13。所以还需要在虚拟环境里创建到gcc-13和g++-13的符号链接，让boost编译的时候也用GCC 13：

ln -s /usr/bin/g++-13 ~/.venvs/folly/bin/g++
ln -s /usr/bin/gcc-13 ~/.venvs/folly/bin/gcc

liburing >= 2.10

根据 https://github.com/microsoft/vcpkg/pull/44232，从v2025.02.24.00开始，folly要求liburing >= 2.10，不然会报这个错：

error: ‘io_uring_zcrx_cqe’ does not name a type

Debian 13的liburing是2.9，不满足要求。可以卸载liburing-dev：

sudo apt remove liburing-dev

也可以手动编译安装新版本liburing。在这里选择要安装的版本：https://github.com/axboe/liburing/releases

version=2.12
wget https://github.com/axboe/liburing/archive/refs/tags/liburing-$version.tar.gz
tar xzf liburing-$version.tar.gz
cd liburing-liburing-$version
./configure --prefix=$workspace/deps
make -j$(nproc) install

numpy 1.0

不兼容numpy 2.0，会报错：

libs/python/src/numpy/dtype.cpp: In member function ‘int boost::python::numpy::dtype::get_itemsize() const’:
libs/python/src/numpy/dtype.cpp:101:83: error: ‘PyArray_Descr’ has no member named ‘elsize’
  101 | int dtype::get_itemsize() const { return reinterpret_cast<PyArray_Descr*>(ptr())->elsize;}
      |                                                                                   ^~~~~~

可以把numpy卸载再编译。或者安装numpy 1.0：

# 可以在虚拟环境里安装
pip3 install numpy~=1.0
# 要编译一段时间

numpy 1.x 在2025年9月就EOL了：https://www.herodevs.com/blog-posts/numpy-version-1-x-end-of-life-what-you-need-to-know。2023年8月11日发布的boost 1.83依赖numpy 1.x无可厚非。但现在folly应该考虑处理这个问题了。

安装其他依赖

sudo apt install -y libssl-dev

编译

默认会把编译过程中生成的文件放在/tmp下面，但是有些服务器/tmp是tmpfs，容量有限，编译生成的文件很容易占满/tmp。所以这里把编译过程中生成的文件放在$workspace/build。

# 根据自己的系统选择。Debian 12是python3.11。Debian 13是python3.13
python=python3.13
CPLUS_INCLUDE_PATH=/usr/include/x86_64-linux-gnu/$python/:/usr/include/$python/:$CPLUS_INCLUDE_PATH python3 ./build/fbcode_builder/getdeps.py --scratch-path=$workspace/build --install-prefix=$workspace/deps build
# 官方文档里加了--allow-system-packages，但是系统里安装的库不一定跟folly兼容，所以这里不加--allow-system-packages，让folly自己下载编译跟自己兼容的库。

然后就安装到了$workspace/deps。

以后用之前把这个目录加到cmake搜索目录即可：

export CMAKE_PREFIX_PATH=$workspace/deps:$CMAKE_PREFIX_PATH

Debian 12和13在后续使用的时候会报这个错：

/usr/bin/ld: cannot find -lgflags_shared: No such file or directory

根据这个issue: https://github.com/facebook/folly/issues/1932，应该在$workspace/deps/folly/lib/cmake/folly/folly-targets.cmake里把gflags_shared改成gflags::gflags_shared