📚 课程目录第3章编译GROMACS前的准备

编译 GROMACS 前的准备：编译器、MPI、FFTW、CMake 等依赖项

要编译 GROMACS，你得先把地基打牢。说白了，这就像盖房子前要准备好水泥、钢筋和图纸。依赖项选不对，后面编译十有八九会翻车。我个人习惯在装系统后第一件事就把编译链理清楚，省得后面反复折腾。

编译器：GCC、Intel 还是 Clang？

GROMACS 主要靠 C++ 和 C 代码，对编译器比较挑剔。我建议优先用 GCC，原因很简单——社区验证最充分，坑最少。如果你用 Intel 编译器，SIMD 优化可能更激进，但调试时容易遇到奇怪的问题。Clang 在 macOS 上很常见，但某些老版本对 OpenMP 支持不完整。

你可能会问：“到底选哪个版本？” 嗯，GROMACS 官方推荐 GCC 9.x 或更高，Intel oneAPI 2023+ 也可以。我曾在项目中遇到过用 GCC 8 编译莫名报错，升级到 11 就一路畅通。

检查本机编译器：

gcc --version
g++ --version
# 如果输出类似 "gcc (GCC) 11.3.0" 就没问题

如果你没有管理员权限，也可以自己装一个 Miniconda 环境下的 GCC：

conda install -c conda-forge gxx_linux-64

注意：不要直接用系统自带的古老 GCC（比如 CentOS 7 自带的 4.8.x），它会卡在 C++17 支持上。我曾经因此浪费了两天时间。

MPI：让并行跑起来

GROMACS 的并行依赖于 MPI。你需要选择 OpenMPI 或 MPICH。我个人更倾向 OpenMPI，因为它的进程管理更灵活，调试时可以用 mpirun --oversubscribe 之类的小技巧。MPICH 在 Intel 集群上优化也不错，但很少用在个人工作站。

安装 OpenMPI 也很简单：

# Ubuntu/Debian
sudo apt install openmpi-bin openmpi-common libopenmpi-dev

# CentOS/RHEL
sudo yum install openmpi openmpi-devel

# 也可以用 conda
conda install -c conda-forge openmpi

验证 MPI：

mpirun --version
# 输出类似 "mpirun (Open MPI) 4.1.5"

小技巧：如果你在 HPC 集群上编译，尽量用和集群相同的 MPI 版本。我之前遇到过用 OpenMPI 4.0 编译出的 GROMACS，在集群上因为 MPI 版本不匹配根本跑不起来。

FFTW：傅里叶变换的引擎

GROMACS 做 PME 静电计算需要 FFTW。你可以选择 FFTW 3.x，或者用 Intel MKL 里的 FFTW 接口（速度更快）。我个人经验：如果用了 Intel 编译器，直接用 MKL 更省事；否则老老实实编译 FFTW 源码。

手动编译 FFTW 建议加上单精度和双精度支持：

wget https://www.fftw.org/fftw-3.3.10.tar.gz
tar xf fftw-3.3.10.tar.gz
cd fftw-3.3.10
./configure --enable-shared --enable-single --enable-avx2 --enable-openmp
make -j4
sudo make install

注意：如果你后续要编译 GPU 版本的 GROMACS，FFTW 也要编译 CUDA-aware 版本（需要 --enable-cuda）。嗯，这一步容易忘，我踩过坑。

CMake：构建的指挥棒

GROMACS 现在完全用 CMake 构建，版本要求 3.18 以上。我个人建议用 3.22 以上，因为新版对 CUDA_ARCHITECTURES 处理更好。你的系统自带的 CMake 往往比较旧，最好别用。

安装最新 CMake：

# 方法1：去官网下载二进制
wget https://github.com/Kitware/CMake/releases/download/v3.28.3/cmake-3.28.3-linux-x86_64.tar.gz
tar xf cmake-3.28.3-linux-x86_64.tar.gz
export PATH=$PWD/cmake-3.28.3-linux-x86_64/bin:$PATH

# 方法2：pip 安装（慢但安全）
pip install cmake --upgrade

# 验证
cmake --version

核心依赖清单（建议提前准备）：
编译器：GCC >= 9
MPI：OpenMPI >= 4.0 或 MPICH >= 3.4
FFTW：FFTW 3.3.8+ 或 Intel MKL
CMake：>= 3.18
BLAS/LAPACK：可选但推荐（OpenBLAS 或 MKL）
Python：>= 3.6（用于后处理脚本）

其他依赖：BLAS、LAPACK、Python

虽然 GROMACS 不强制要求外部 BLAS/LAPACK，但我建议装一个 OpenBLAS 或 MKL，这样可以加速某些线性代数操作。安装很简单：

# OpenBLAS
sudo apt install libopenblas-dev

# MKL（若使用Intel编译器）
conda install -c intel mkl

Python 主要是为了后处理工具（比如 gmx tool 需要的 Python 脚本）。最好用 Anaconda 环境，省心。我个人喜欢用 Miniforge，干净。

依赖关系总览图

下面这张图能帮你快速理解各依赖项之间的层级关系。注意箭头方向表示“依赖”关系。

避坑指南：常见依赖问题

我把这些年踩过的坑整理成清单，你编译前先对照一下：

依赖项	常见问题	解决办法
编译器	GCC 版本过低，不支持 C++17	用 conda 装 gcc-9+ 或 devtoolset
MPI	mpirun 报错 "unable to find mpirun"	检查 PATH 是否包含 MPI bin 目录
FFTW	CMake 找不到 FFTW	设置 `-DFFTWF_LIBRARY` 等变量
CMake	Cache 缓存冲突导致编译失败	删除 build 目录重新配置
BLAS	OpenBLAS 多线程冲突	设置 `OPENBLAS_NUM_THREADS=1`

我的个人习惯：把所有依赖装在一个路径下（比如 $HOME/opt/gromacs_deps），然后写一个环境变量脚本。这样换机器时直接复制。如果你用模块系统（如 Lmod），也可以做成模块。

好了，依赖项准备好之后，你就可以进入下一步——配置 CMake 选项了。记住一句话：基础打牢，编译顺滑。我见过太多人因为少了某个库而卡在 cmake 阶段，最后放弃。别急，一步一步来，肯定能过。