$ sudo apt update
$ sudo apt install build-essential cmake \
                   libhdf5-dev \
                   libopenblas-dev \
                   libopenmpi-dev openmpi-bin # 或: libmpich-dev mpich

# 安装 Python 库:
$ pip install numpy scipy
# 或
$ python3 -m pip install numpy scipy

请勿通过 apt 安装 Boost。 ALPS 必须从源码编译 Boost，原因有二：

1. 自定义编译器标志 — ALPS 需要 -DBOOST_NO_AUTO_PTR 和 -DBOOST_FILESYSTEM_NO_CXX20_ATOMIC_REF 以兼容 C++17/20；libboost-dev 软件包不设置这些标志，会导致链接错误。
2. Python ABI 匹配 — Boost.Python 组件必须针对 ALPS 使用的同一 Python 解释器进行编译。预构建软件包针对系统 Python，若使用其他解释器则会出现不匹配。

CMake 会自动处理：若未设置 Boost_SRC_DIR，则在配置时下载并编译 Boost 1.87（需要网络连接）。如需离线构建，请参阅下方编译步骤中的替代方案。

$ brew update
$ brew install cmake hdf5 \
               openblas open-mpi # 或: mpich

# 安装 Python 库:
$ pip3 install numpy scipy

请勿通过 Homebrew 安装 Boost。 ALPS 必须从源码编译 Boost，原因有二：

1. 自定义编译器标志 — ALPS 需要 -DBOOST_NO_AUTO_PTR 和 -DBOOST_FILESYSTEM_NO_CXX20_ATOMIC_REF 以兼容 C++17/20；Homebrew 的 boost formula 不设置这些标志，会导致链接错误。
2. Python ABI 匹配 — Boost.Python 组件必须针对 ALPS 使用的同一 Python 解释器进行编译。Homebrew Boost 针对 Homebrew 自带的 Python，与其他解释器会出现不匹配。

CMake 会自动处理：若未设置 Boost_SRC_DIR，则在配置时下载并编译 Boost 1.87（需要网络连接）。如需离线构建或复用已解压的存档，请先手动下载：

$ curl -LO https://archives.boost.io/release/1.87.0/source/boost_1_87_0.tar.gz
$ tar -xzf boost_1_87_0.tar.gz

$ sudo port selfupdate
$ sudo port install cmake \
                   hdf5 \
                   OpenBLAS \
                   openmpi-clang20   # 请参阅下方关于选择变体的说明
$ sudo port select --set mpi openmpi-clang20-fortran

# 安装 Python 库:
$ pip3 install numpy scipy

选择 OpenMPI 变体： MacPorts 为每个编译器版本提供独立的端口，命名为 openmpi-<compiler><version>（例如 openmpi-clang20、openmpi-gcc15）。上示的 clang20 变体对应 LLVM Clang 20 端口，可与 Xcode 的 Apple Clang 共存。若使用不同编译器，请安装对应变体并相应调整 port select 命令。

port select 步骤是必须的：若不执行此步骤，CMake 搜索的裸 mpirun、mpicc、mpicxx 包装器将不存在。

请勿通过 MacPorts 安装 Boost。 ALPS 必须从源码编译 Boost，原因有二：

1. 自定义编译器标志 — ALPS 需要 -DBOOST_NO_AUTO_PTR 和 -DBOOST_FILESYSTEM_NO_CXX20_ATOMIC_REF 以兼容 C++17/20；MacPorts 的 boost 端口不设置这些标志，会导致链接错误。
2. Python ABI 匹配 — Boost.Python 组件必须针对 ALPS 使用的同一 Python 解释器进行编译。MacPorts Boost 针对 MacPorts 自带的 Python，与其他解释器会出现不匹配。

CMake 会自动处理：若未设置 Boost_SRC_DIR，则在配置时下载并编译 Boost 1.87（需要网络连接）。如需离线构建或复用已解压的存档，请先手动下载：

$ curl -LO https://archives.boost.io/release/1.87.0/source/boost_1_87_0.tar.gz
$ tar -xzf boost_1_87_0.tar.gz

• 需使用其他 MPI/BLAS？
  将上述包名替换为您集群的模块（如 Intel MKL/OneAPI, AMD AOCL 等）。CMake 会自动定位这些包并生成编译指令。
• Python 错误
  请确保 Python ≥ 3.9 已安装，且 numpy 和 scipy 安装在 CMake 所选的同一 Python 下。在 macOS 上，CMake 可能选择 Xcode 自带的 Python 而非 Homebrew/MacPorts 的 Python——请检查 CMake 输出中的 Found Python: 行，必要时使用 -DPython3_EXECUTABLE=/path/to/python3 指定解释器（参见验证依赖项步骤）。
• MPI 版本不匹配？
  确保 CMake 使用的 MPI 版本与 mpirun --version 一致。
• Boost 错误
  针对 NumPy ≥ 2.0 构建 ALPS Python 绑定需要 Boost ≥ 1.87（NumPy 2.0 引入的 API 变更仅 Boost 1.87+ 支持）。Boost 1.76–1.86 仅支持 NumPy < 2.0。已测试的编译器/Boost/Python 组合请参阅编译说明。