尧图网站建设 
分子模拟异构算力适配开发教程2GROMACS GPU 构建实战——一个 cmake 枚举值背后的四条技术路线版本声明块工具/软件GROMACS 2026.x差异处对照 2025.4CMake ≥3.28CUDA 12.1 / oneAPI DPC 2024.0 / AdaptiveCpp 24.02 / ROCm 5.2语言/环境C17gcc 11 / clang 14 / MSVC 2019、Linux本文目标读完你能独立完成一次 GPU 加速 GROMACS 的源码构建并知道每个 CMake 变量在 2025 与 2026 之间的版本差异一句话结论GROMACS 2026 的 GPU 构建核心是一个枚举值——cmake -DGMX_GPUCUDA或 SYCL/HIPNVIDIA 架构用 CMake 标准CMAKE_CUDA_ARCHITECTURES2026 起取代 2025.x 的GMX_CUDA_TARGET_SMGPU FFT 用-DGMX_GPU_FFT_LIBRARYcuFFT/VkFFT/MKL/rocFFT按后端选择双精度GMX_DOUBLE官方定性slower, and not normally useful默认不开。〇、本篇要解决的认知问题一次完整的 GPU 加速 GROMACS 源码构建有哪些步骤每步怎么验证成功了2025.x 与 2026.x 的 CMake 变量有哪些不兼容改名为什么教程里的架构变量命令冲突了SYCL 构建为什么要区分 DPC 与 AdaptiveCpp 两种实现AMD GPU 上该选哪个GMX_DOUBLE双精度什么时候才值得开GPU FFT 库的默认值是怎么定的一、机制解析1.1 为什么编译是国产适配绕不开的一关为什么这一节对你重要上一章说过 GROMACS 是编译期单后端这意味着适配工作从 cmake 那一行就开始了——构建系统的变量体系就是你与 GPU 后端的第一个接口。理解了它后面读 gpu_utils 源码第 5 篇、做 MUSA 移植第 9 篇才有立足点。先看构建的骨架。GROMACS 官方安装指南的 GPU 章节内嵌在 install-guide 单页里锚点#gpu-support四个小节分别对应四个后端#cuda-gpu-acceleration、#sycl-gpu-acceleration-intel、#sycl-gpu-acceleration-amd、#amd-hip。骨架命令# 下载源码ftp.gromacs.org 为官方分发渠道wgethttps://ftp.gromacs.org/gromacs/gromacs-2026.tar.gztarxf gromacs-2026.tar.gzcdgromacs-2026mkdirbuildcdbuild# GPU 后端在 cmake 配置期决定四选一cmake..-DGMX_GPUCUDA-DCMAKE_INSTALL_PREFIX/opt/gromacs/2026make-j$(nproc)makecheck# 官方构建自检makeinstallGMX_GPU的取值就是第 1 篇那四个后端枚举CUDA/OpenCL/SYCL/HIP。摩尔线程在 fork 里扩展了MUSA取值第 9 篇。没有GMX_GPUON这种写法也没有独立的GMX_CUDA/GMX_HIP变量——遇到这么写的资料直接判定为 2021 年前的老教程。1.2 架构变量代际2025 与 2026 的分水岭这是本篇最重要的版本知识也是中文互联网资料混乱的重灾区。GROMACS 2026 的发行说明记录了一次 CMake CUDA 配置重构变量2025.x2026.x说明NVIDIA 架构GMX_CUDA_TARGET_SMCMAKE_CUDA_ARCHITECTURES2026 起改用 CMake 标准变量值如86、90、nativeCUDA 工具链根CUDA_TOOLKIT_ROOT_DIRCUDAToolkit_ROOT同上对齐 CMake 官方变量名CUDA host 编译器CUDA_HOST_COMPILERCMAKE_CUDA_HOST_COMPILER同上为什么改GROMACS 维护者把自家私有的 CMake 变量替换成 CMake 官方标准变量减少一套自造轮子。对你的影响抄命令前先gmx --version确认版本铁律 1。2025.4 上用CMAKE_CUDA_ARCHITECTURES可能不生效该系列仍以GMX_CUDA_TARGET_SM为准2026 上用老变量则直接被忽略。HIP 侧的架构变量是 CMake 标准的CMAKE_HIP_ARCHITECTURES值如gfx90a、gfx1100这是 AMD ROCm 官方文档确认的标准用法。GROMACS install-guide 有#amd-hip专节其中该变量的具体推荐值以该节原文为准本系列调研时该节页面过长未能完整取证标注以官方文档为准。1.3 SYCL 的两套实现DPC 与 AdaptiveCppSYCL 是 Khronos 的开放标准但标准有多个实现GROMACS 官方只支持两个实现CMake 值擅长硬件版本要求Intel oneAPI DPC-DGMX_SYCLDPCPP默认Intel GPU全系列NVIDIA/AMD 需 Codeplay 插件2024.0AdaptiveCpp原 hipSYCL-DGMX_SYCLACPPAMD配 ROCm runtime官方推荐表钦点NVIDIA24.02官方推荐表把AMD GPU SYCL指向 AdaptiveCpp ROCm 路线而 AMD GPU 还有第二条路——HIP 后端AMD 官方支持2026 版起完整 offload。也就是说 AMD 用户面临SYCL/AdaptiveCpp vs HIP的选择HIP 后端更年轻但由 AMD 官方投入实验分支gitlab.com/gromacs/gromacs/-/tree/4947-hip-feature-enablement持续更新SYCL 后端更成熟2022 年起生产可用第 7 篇的论文实测 SYCL 比 HIP fork 慢约 21%但换来的跨平台性。一个真实的 AMD SYCL 构建示例来自 GROMACS 2025-rc 官方文档注意SYCL_CXX_FLAGS_EXTRA里的 target 三元组写法cmake..-DGMX_GPUSYCL-DGMX_SYCLDPCPP\-DGMX_GPU_NB_CLUSTER_SIZE8\-DGMX_GPU_FFT_LIBRARYvkfft\-DSYCL_CXX_FLAGS_EXTRA-fsycl-targetsamd_gpu_gfx90a限制也来自官方文档Intel GPU 不支持 AdaptiveCpp 的 SSCP/generic 编译流程AMD/NVIDIA 目标分别还需要 ROCm/CUDA 工具链在场。1.4 GPU FFT 库与双精度-DGMX_GPU_FFT_LIBRARY控制 PME 的 GPU FFT 实现取值与默认值后端可选值默认CUDA仅 cuFFT其余报 FATAL_ERRORcuFFTOpenCLVkFFT / clFFTclFFTApple/MSVC 上 VkFFTSYCLVkFFT / MKL / rocFFT / noneAdaptiveCpp→VkFFTDPC→MKLHIProcFFT 等以 install-guide 为准—这份取值清单来自 2023 年合入的 GROMACS MR !3289CMake 源码定义2026.2 手册页面过长未取证完整表格——构建时以 cmake 输出为准。分布式多 GPU FFT 另有两个独立开关GMX_USE_HEFFTE、GMX_USE_CUFFTMP均限 CUDAMPIcuFFTMp 需-DcuFFTMp_ROOT。双精度官方安装指南对GMX_DOUBLEon的原话是 “slower, and not normally useful”更慢通常无用。性能清单第一条也是 “Do not use double precision unless you are absolutely sure you need it”。GROMACS 默认 mixed 精度力单精度、累积双精度对绝大多数生物体系够用确需双精度的场景自由能微扰的精细能量差、部分材料体系先做敏感性论证铁律 7。二、完整代码与逐行剖析一个工程化的构建脚本覆盖 CUDA 基线 版本守卫 验证#!/usr/bin/env bash# build-gromacs-gpu.sh —— GROMACS GPU 构建脚本CUDA 基线# 用法: ./build-gromacs-gpu.sh 2026.1 /opt/gromacs/2026.1set-euopipefailVERSION${1:?用法:$0 版本号 安装前缀}PREFIX${2:-/opt/gromacs/${VERSION}}NPROC$(nproc)# ── 第 0 步环境守卫。铁律 1版本先锚定。2025 与 2026 的架构变量不同。MAJOR_MINOR${VERSION%.*}# 2026.1 - 2026if[[$MAJOR_MINOR2026||$MAJOR_MINOR2026]];thenARCH_FLAG(-DCMAKE_CUDA_ARCHITECTURESnative)# 2026: CMake 标准变量native 自动探测本机elif[[$MAJOR_MINOR2025]];thenARCH_FLAG(-DGMX_CUDA_TARGET_SMnative)# 2025.x: 老变量elseecho未测试的版本分支:${VERSION}2;exit2fi# ── 第 1 步下载与解包官方渠道 ftp.gromacs.orgcd$(mktemp-d)wgethttps://ftp.gromacs.org/gromacs/gromacs-${VERSION}.tar.gztarxfgromacs-${VERSION}.tar.gzcdgromacs-${VERSION}mkdirbuildcdbuild# ── 第 2 步cmake 配置。# -DGMX_GPUCUDA 是核心编译期绑定 CUDA 后端铁律 2单后端编译# GMX_BUILD_OWN_FFTWON 让 GROMACS 自动编译一套优化的 FFTWCPU 侧 PME/分析用# GMX_MPIauto单机默认关thread-MPI集群再显式开cmake..\-DGMX_GPUCUDA\${ARCH_FLAG[]}\-DGMX_BUILD_OWN_FFTWON\-DGMX_MPIauto\-DREGRESSIONTEST_DOWNLOADON\-DCMAKE_INSTALL_PREFIX${PREFIX}\-DCMAKE_BUILD_TYPERelease# ── 第 3 步编译 测试 安装make-j${NPROC}makecheck# 单元测试含 GPU 相关测试无 GPU 时部分静默回退第 12 篇详述makeinstall# ── 第 4 步安装后验证判定成功标准见练习 1source${PREFIX}/bin/GMXRCgmx--version|grep-EGROMACS version|CUDA support|PrecisionechoBUILD OK -${PREFIX}逐段剖析第 0 步的版本守卫是本脚本的灵魂ARCH_FLAG数组按版本分支赋值从机制上杜绝2025 命令跑到 2026 源码的事故。字符串比较${MAJOR_MINOR} 2026在 bash 里按字典序对2026/2027这类格式有效。CMAKE_CUDA_ARCHITECTURESnative让 CMake 探测本机 GPU 的 compute capability 自动生成对应-arch交付集群时改为显式值如80;90分号分隔列表保证可移植——native 编出来的二进制拿到别的架构机器上会加载失败。-DREGRESSIONTEST_DOWNLOADON在配置期拉取回归测试数据集需要外网离线环境改用-DREGRESSIONTEST_PATH指向预先下载的数据第 12 篇详述。国产适配的验证闭环从这里开始。make check在无 GPU 的构建机上会让 GPU 测试静默回退——想强制必须有 N 块卡才许过用环境变量GMX_TEST_REQUIRED_NUMBER_OF_DEVICES第 12 篇。三个后端的对照速查把第 1 篇的矩阵落到命令后端cmake 核心行额外要点CUDA-DGMX_GPUCUDA -DCMAKE_CUDA_ARCHITECTURESnativeFFT 只能 cuFFTCUDA 12.1、计算能力 5.0SYCL/DPCIntel-DGMX_GPUSYCL -DGMX_SYCLDPCPP -DGMX_GPU_FFT_LIBRARYmklIntel MPI≥2018.8 ONEAPI_DEVICE_SELECTORlevel_zero:gpuSYCL/ACPPAMD-DGMX_GPUSYCL -DGMX_SYCLACPP -DGMX_GPU_FFT_LIBRARYvkfft需 ROCm 工具链AMD GPU 官方推荐路线HIPAMD-DGMX_GPUHIP -DCMAKE_HIP_ARCHITECTURESgfx90aROCm 5.22026 版起完整 offload变量用法以 install-guide#amd-hip节为准三、常见报错与排查问题 1现象——cmake .. -DGMX_GPUON后构建出来的gmx --version显示没有 GPU 支持或者配置阶段警告未知变量。根因ON不是GMX_GPU的合法取值当前版本该变量是后端枚举CUDA/OpenCL/SYCL/HIP。CMake 对未知值的态度可能是静默忽略——这就是编出来了但没 GPU的典型成因。解法改-DGMX_GPUCUDA或其他三个枚举值并养成配置完立刻看 cmake 输出末尾的 summary其中会列出 GPU backend 与 FFT 库的选择结果的习惯。问题 2现象——按 2025 年的教程在 2026 源码上设了GMX_CUDA_TARGET_SM80编译出的二进制在新卡如 sm_90上运行报no kernel image is available for execution on the device。根因变量改名了——2026 起GMX_CUDA_TARGET_SM已被移除架构交给CMAKE_CUDA_ARCHITECTURES发行说明Refactored CMake configuration。老变量被静默忽略二进制按 CMake 默认架构编译不含 sm_90 内核。解法改用-DCMAKE_CUDA_ARCHITECTURES90或native。同时检查另外两个改名变量CUDA_TOOLKIT_ROOT_DIR→CUDAToolkit_ROOT、CUDA_HOST_COMPILER→CMAKE_CUDA_HOST_COMPILER。问题 3现象——SYCL 构建cmake -DGMX_GPUSYCL -DGMX_SYCLACPP ..配置失败报找不到 AdaptiveCpp。根因AdaptiveCpp原 hipSYCL通常不在系统默认路径需要它自己的 CMake 配置文件24.02 版本另外 ACPP 编 AMD 目标时要求 ROCm 工具链同时在场。若你的机器上只有 Intel oneAPI那就该走 DPCPP 而不是 ACPP——两个实现对应不同硬件生态不是随便选的。解法先明确目标硬件Intel GPU 用-DGMX_SYCLDPCPP默认AMD GPU 用-DGMX_SYCLACPP并确保 AdaptiveCpp 与 ROCm 均已正确安装。构建环境混乱时优先考虑厂商容器镜像如摩尔线程 SCS 套件自带完整工具链第 9 篇。问题 4现象——同事坚持要-DGMX_DOUBLEON构建理由是双精度更准跑基准比 mixed 慢好几倍。根因把数值方法的精度需求与全链路双精度画了等号。GROMACS mixed 精度的设计已经把双精度用在了数值敏感的累积环节官方对 GMX_DOUBLE 的定性是slower, and not normally useful。消费级 GPU 的 FP64 吞吐通常是 FP32 的 1/32 到 1/64全双精度等于把 GPU 的主要算力浪费掉。解法让需求方给出mixed 精度下结果不达标的具体证据能量漂移曲线、与实验值的偏差再考虑双精度或者只对特定计算如自由能计算中的能量差评估精度敏感性。这是本系列铁律 7 的直接应用。四、动手练习练习 1基础用本文脚本或手动逐条执行完成一次 CUDA 基线构建然后运行gmx --version找到并记录三行GROMACS version、CUDA support、Precision。判定成功标准三行均存在其中 CUDA support 显示 enabled 且含 CUDA toolkit 版本号≥12.1Precision 显示 mixed默认构建。练习 2进阶把脚本的版本守卫扩展到 HIP 后端——为 2026 分支添加-DGMX_GPUHIP -DCMAKE_HIP_ARCHITECTURES你的架构路径无 AMD 卡可用gfx90a字面值做干跑只验证 cmake 配置阶段能通过到找 HIP 工具链一步。判定成功标准在有 ROCm 的机器上 cmake 配置完成且 summary 显示 GPU backend: HIP在无 ROCm 机器上报错信息明确指向找不到 HIP 工具链而不是其他莫名的变量错误。练习 3思考题无标准答案为什么 GROMACS 不做一个运行时多后端的二进制像 OpenMM 那样五个平台共存思考方向验证要点① 内核对后端专属特性warp 原语、纹理内存的依赖程度② 单后端编译对分支预测与内联的收益③ 发行版打包的复杂度④ 摩尔线程选择fork 扩展 GMX_GPU 枚举而非插件化的工程理由。五、小结与下一篇预告本篇把 GPU 构建的四条路线走了一遍GMX_GPU枚举四选一是编译期契约架构变量 2025→2026 有一次系统性改名GMX_CUDA_TARGET_SM→CMAKE_CUDA_ARCHITECTURES 等SYCL 分 DPCIntel/AdaptiveCppAMD 推荐两套实现FFT 库按后端定默认值双精度默认不开。构建脚本里的版本守卫是铁律 1 的代码化。下一篇讲构建产物怎么用mdrun的异构执行控制——-gputasks的位图语义、-nb/-pme/-bonded/-update的任务落点、GPU-resident 模式的硬前提constraintsh-bonds。第 5 篇会回到源码层看 gpu_utils 如何把这些运行时控制映射到设备抽象上。本篇认知问题回显FAQQ1GROMACS 2026 开启 GPU 加速的 cmake 命令是什么GMX_GPUON 对吗A不对。GMX_GPU 是后端枚举变量正确写法是-DGMX_GPUCUDA或 OpenCL/SYCL/HIP 四选一一次构建只支持一个 GPU 后端GMX_GPUON是 2021 年前的老写法当前版本会被忽略或报错。Q2GROMACS 2025 和 2026 的 CUDA 架构变量有什么不同A2025.x 用GMX_CUDA_TARGET_SM指定 NVIDIA 架构2026 起重构为 CMake 标准CMAKE_CUDA_ARCHITECTURES值如 86、90、native同时CUDA_TOOLKIT_ROOT_DIR改名CUDAToolkit_ROOT、CUDA_HOST_COMPILER改名CMAKE_CUDA_HOST_COMPILER老变量被移除。Q3GROMACS 的 SYCL 后端在 AMD GPU 上用 DPC 还是 AdaptiveCppA官方推荐 AMD GPU 用 AdaptiveCpp-DGMX_SYCLACPP需 24.02 且配 ROCm 工具链Intel GPU 用 oneAPI DPC默认-DGMX_SYCLDPCPP2024.0。AMD 还有 HIP 后端可选ROCm 5.22026 版起支持完整 offload。Q4GROMACS 什么时候需要开 GMX_DOUBLE 双精度构建A官方定性 GMX_DOUBLEslower, and not normally useful——默认 mixed 精度力单精度、累积双精度对绝大多数生物体系够用只有当 mixed 精度出现可证明的能量漂移或自由能计算精度不达标时才论证开启且要接受消费级 GPU FP64 吞吐仅 FP32 的 1/32 到 1/64 的性能代价。 分子模拟异构算力适配开发教程（2）：GROMACS GPU 构建实战——一个 cmake 枚举值背后的四条技术路线
分子模拟异构算力适配开发教程2GROMACS GPU 构建实战——一个 cmake 枚举值背后的四条技术路线版本声明块工具/软件GROMACS 2026.x差异处对照 2025.4CMake ≥3.28CUDA 12.1 / oneAPI DPC 2024.0 / AdaptiveCpp 24.02 / ROCm 5.2语言/环境C17gcc 11 / clang 14 / MSVC 2019、Linux本文目标读完你能独立完成一次 GPU 加速 GROMACS 的源码构建并知道每个 CMake 变量在 2025 与 2026 之间的版本差异一句话结论GROMACS 2026 的 GPU 构建核心是一个枚举值——cmake -DGMX_GPUCUDA或 SYCL/HIPNVIDIA 架构用 CMake 标准CMAKE_CUDA_ARCHITECTURES2026 起取代 2025.x 的GMX_CUDA_TARGET_SMGPU FFT 用-DGMX_GPU_FFT_LIBRARYcuFFT/VkFFT/MKL/rocFFT按后端选择双精度GMX_DOUBLE官方定性slower, and not normally useful默认不开。〇、本篇要解决的认知问题一次完整的 GPU 加速 GROMACS 源码构建有哪些步骤每步怎么验证成功了2025.x 与 2026.x 的 CMake 变量有哪些不兼容改名为什么教程里的架构变量命令冲突了SYCL 构建为什么要区分 DPC 与 AdaptiveCpp 两种实现AMD GPU 上该选哪个GMX_DOUBLE双精度什么时候才值得开GPU FFT 库的默认值是怎么定的一、机制解析1.1 为什么编译是国产适配绕不开的一关为什么这一节对你重要上一章说过 GROMACS 是编译期单后端这意味着适配工作从 cmake 那一行就开始了——构建系统的变量体系就是你与 GPU 后端的第一个接口。理解了它后面读 gpu_utils 源码第 5 篇、做 MUSA 移植第 9 篇才有立足点。先看构建的骨架。GROMACS 官方安装指南的 GPU 章节内嵌在 install-guide 单页里锚点#gpu-support四个小节分别对应四个后端#cuda-gpu-acceleration、#sycl-gpu-acceleration-intel、#sycl-gpu-acceleration-amd、#amd-hip。骨架命令# 下载源码ftp.gromacs.org 为官方分发渠道wgethttps://ftp.gromacs.org/gromacs/gromacs-2026.tar.gztarxf gromacs-2026.tar.gzcdgromacs-2026mkdirbuildcdbuild# GPU 后端在 cmake 配置期决定四选一cmake..-DGMX_GPUCUDA-DCMAKE_INSTALL_PREFIX/opt/gromacs/2026make-j$(nproc)makecheck# 官方构建自检makeinstallGMX_GPU的取值就是第 1 篇那四个后端枚举CUDA/OpenCL/SYCL/HIP。摩尔线程在 fork 里扩展了MUSA取值第 9 篇。没有GMX_GPUON这种写法也没有独立的GMX_CUDA/GMX_HIP变量——遇到这么写的资料直接判定为 2021 年前的老教程。1.2 架构变量代际2025 与 2026 的分水岭这是本篇最重要的版本知识也是中文互联网资料混乱的重灾区。GROMACS 2026 的发行说明记录了一次 CMake CUDA 配置重构变量2025.x2026.x说明NVIDIA 架构GMX_CUDA_TARGET_SMCMAKE_CUDA_ARCHITECTURES2026 起改用 CMake 标准变量值如86、90、nativeCUDA 工具链根CUDA_TOOLKIT_ROOT_DIRCUDAToolkit_ROOT同上对齐 CMake 官方变量名CUDA host 编译器CUDA_HOST_COMPILERCMAKE_CUDA_HOST_COMPILER同上为什么改GROMACS 维护者把自家私有的 CMake 变量替换成 CMake 官方标准变量减少一套自造轮子。对你的影响抄命令前先gmx --version确认版本铁律 1。2025.4 上用CMAKE_CUDA_ARCHITECTURES可能不生效该系列仍以GMX_CUDA_TARGET_SM为准2026 上用老变量则直接被忽略。HIP 侧的架构变量是 CMake 标准的CMAKE_HIP_ARCHITECTURES值如gfx90a、gfx1100这是 AMD ROCm 官方文档确认的标准用法。GROMACS install-guide 有#amd-hip专节其中该变量的具体推荐值以该节原文为准本系列调研时该节页面过长未能完整取证标注以官方文档为准。1.3 SYCL 的两套实现DPC 与 AdaptiveCppSYCL 是 Khronos 的开放标准但标准有多个实现GROMACS 官方只支持两个实现CMake 值擅长硬件版本要求Intel oneAPI DPC-DGMX_SYCLDPCPP默认Intel GPU全系列NVIDIA/AMD 需 Codeplay 插件2024.0AdaptiveCpp原 hipSYCL-DGMX_SYCLACPPAMD配 ROCm runtime官方推荐表钦点NVIDIA24.02官方推荐表把AMD GPU SYCL指向 AdaptiveCpp ROCm 路线而 AMD GPU 还有第二条路——HIP 后端AMD 官方支持2026 版起完整 offload。也就是说 AMD 用户面临SYCL/AdaptiveCpp vs HIP的选择HIP 后端更年轻但由 AMD 官方投入实验分支gitlab.com/gromacs/gromacs/-/tree/4947-hip-feature-enablement持续更新SYCL 后端更成熟2022 年起生产可用第 7 篇的论文实测 SYCL 比 HIP fork 慢约 21%但换来的跨平台性。一个真实的 AMD SYCL 构建示例来自 GROMACS 2025-rc 官方文档注意SYCL_CXX_FLAGS_EXTRA里的 target 三元组写法cmake..-DGMX_GPUSYCL-DGMX_SYCLDPCPP\-DGMX_GPU_NB_CLUSTER_SIZE8\-DGMX_GPU_FFT_LIBRARYvkfft\-DSYCL_CXX_FLAGS_EXTRA-fsycl-targetsamd_gpu_gfx90a限制也来自官方文档Intel GPU 不支持 AdaptiveCpp 的 SSCP/generic 编译流程AMD/NVIDIA 目标分别还需要 ROCm/CUDA 工具链在场。1.4 GPU FFT 库与双精度-DGMX_GPU_FFT_LIBRARY控制 PME 的 GPU FFT 实现取值与默认值后端可选值默认CUDA仅 cuFFT其余报 FATAL_ERRORcuFFTOpenCLVkFFT / clFFTclFFTApple/MSVC 上 VkFFTSYCLVkFFT / MKL / rocFFT / noneAdaptiveCpp→VkFFTDPC→MKLHIProcFFT 等以 install-guide 为准—这份取值清单来自 2023 年合入的 GROMACS MR !3289CMake 源码定义2026.2 手册页面过长未取证完整表格——构建时以 cmake 输出为准。分布式多 GPU FFT 另有两个独立开关GMX_USE_HEFFTE、GMX_USE_CUFFTMP均限 CUDAMPIcuFFTMp 需-DcuFFTMp_ROOT。双精度官方安装指南对GMX_DOUBLEon的原话是 “slower, and not normally useful”更慢通常无用。性能清单第一条也是 “Do not use double precision unless you are absolutely sure you need it”。GROMACS 默认 mixed 精度力单精度、累积双精度对绝大多数生物体系够用确需双精度的场景自由能微扰的精细能量差、部分材料体系先做敏感性论证铁律 7。二、完整代码与逐行剖析一个工程化的构建脚本覆盖 CUDA 基线 版本守卫 验证#!/usr/bin/env bash# build-gromacs-gpu.sh —— GROMACS GPU 构建脚本CUDA 基线# 用法: ./build-gromacs-gpu.sh 2026.1 /opt/gromacs/2026.1set-euopipefailVERSION${1:?用法:$0 版本号 安装前缀}PREFIX${2:-/opt/gromacs/${VERSION}}NPROC$(nproc)# ── 第 0 步环境守卫。铁律 1版本先锚定。2025 与 2026 的架构变量不同。MAJOR_MINOR${VERSION%.*}# 2026.1 - 2026if[[$MAJOR_MINOR2026||$MAJOR_MINOR2026]];thenARCH_FLAG(-DCMAKE_CUDA_ARCHITECTURESnative)# 2026: CMake 标准变量native 自动探测本机elif[[$MAJOR_MINOR2025]];thenARCH_FLAG(-DGMX_CUDA_TARGET_SMnative)# 2025.x: 老变量elseecho未测试的版本分支:${VERSION}2;exit2fi# ── 第 1 步下载与解包官方渠道 ftp.gromacs.orgcd$(mktemp-d)wgethttps://ftp.gromacs.org/gromacs/gromacs-${VERSION}.tar.gztarxfgromacs-${VERSION}.tar.gzcdgromacs-${VERSION}mkdirbuildcdbuild# ── 第 2 步cmake 配置。# -DGMX_GPUCUDA 是核心编译期绑定 CUDA 后端铁律 2单后端编译# GMX_BUILD_OWN_FFTWON 让 GROMACS 自动编译一套优化的 FFTWCPU 侧 PME/分析用# GMX_MPIauto单机默认关thread-MPI集群再显式开cmake..\-DGMX_GPUCUDA\${ARCH_FLAG[]}\-DGMX_BUILD_OWN_FFTWON\-DGMX_MPIauto\-DREGRESSIONTEST_DOWNLOADON\-DCMAKE_INSTALL_PREFIX${PREFIX}\-DCMAKE_BUILD_TYPERelease# ── 第 3 步编译 测试 安装make-j${NPROC}makecheck# 单元测试含 GPU 相关测试无 GPU 时部分静默回退第 12 篇详述makeinstall# ── 第 4 步安装后验证判定成功标准见练习 1source${PREFIX}/bin/GMXRCgmx--version|grep-EGROMACS version|CUDA support|PrecisionechoBUILD OK -${PREFIX}逐段剖析第 0 步的版本守卫是本脚本的灵魂ARCH_FLAG数组按版本分支赋值从机制上杜绝2025 命令跑到 2026 源码的事故。字符串比较${MAJOR_MINOR} 2026在 bash 里按字典序对2026/2027这类格式有效。CMAKE_CUDA_ARCHITECTURESnative让 CMake 探测本机 GPU 的 compute capability 自动生成对应-arch交付集群时改为显式值如80;90分号分隔列表保证可移植——native 编出来的二进制拿到别的架构机器上会加载失败。-DREGRESSIONTEST_DOWNLOADON在配置期拉取回归测试数据集需要外网离线环境改用-DREGRESSIONTEST_PATH指向预先下载的数据第 12 篇详述。国产适配的验证闭环从这里开始。make check在无 GPU 的构建机上会让 GPU 测试静默回退——想强制必须有 N 块卡才许过用环境变量GMX_TEST_REQUIRED_NUMBER_OF_DEVICES第 12 篇。三个后端的对照速查把第 1 篇的矩阵落到命令后端cmake 核心行额外要点CUDA-DGMX_GPUCUDA -DCMAKE_CUDA_ARCHITECTURESnativeFFT 只能 cuFFTCUDA 12.1、计算能力 5.0SYCL/DPCIntel-DGMX_GPUSYCL -DGMX_SYCLDPCPP -DGMX_GPU_FFT_LIBRARYmklIntel MPI≥2018.8 ONEAPI_DEVICE_SELECTORlevel_zero:gpuSYCL/ACPPAMD-DGMX_GPUSYCL -DGMX_SYCLACPP -DGMX_GPU_FFT_LIBRARYvkfft需 ROCm 工具链AMD GPU 官方推荐路线HIPAMD-DGMX_GPUHIP -DCMAKE_HIP_ARCHITECTURESgfx90aROCm 5.22026 版起完整 offload变量用法以 install-guide#amd-hip节为准三、常见报错与排查问题 1现象——cmake .. -DGMX_GPUON后构建出来的gmx --version显示没有 GPU 支持或者配置阶段警告未知变量。根因ON不是GMX_GPU的合法取值当前版本该变量是后端枚举CUDA/OpenCL/SYCL/HIP。CMake 对未知值的态度可能是静默忽略——这就是编出来了但没 GPU的典型成因。解法改-DGMX_GPUCUDA或其他三个枚举值并养成配置完立刻看 cmake 输出末尾的 summary其中会列出 GPU backend 与 FFT 库的选择结果的习惯。问题 2现象——按 2025 年的教程在 2026 源码上设了GMX_CUDA_TARGET_SM80编译出的二进制在新卡如 sm_90上运行报no kernel image is available for execution on the device。根因变量改名了——2026 起GMX_CUDA_TARGET_SM已被移除架构交给CMAKE_CUDA_ARCHITECTURES发行说明Refactored CMake configuration。老变量被静默忽略二进制按 CMake 默认架构编译不含 sm_90 内核。解法改用-DCMAKE_CUDA_ARCHITECTURES90或native。同时检查另外两个改名变量CUDA_TOOLKIT_ROOT_DIR→CUDAToolkit_ROOT、CUDA_HOST_COMPILER→CMAKE_CUDA_HOST_COMPILER。问题 3现象——SYCL 构建cmake -DGMX_GPUSYCL -DGMX_SYCLACPP ..配置失败报找不到 AdaptiveCpp。根因AdaptiveCpp原 hipSYCL通常不在系统默认路径需要它自己的 CMake 配置文件24.02 版本另外 ACPP 编 AMD 目标时要求 ROCm 工具链同时在场。若你的机器上只有 Intel oneAPI那就该走 DPCPP 而不是 ACPP——两个实现对应不同硬件生态不是随便选的。解法先明确目标硬件Intel GPU 用-DGMX_SYCLDPCPP默认AMD GPU 用-DGMX_SYCLACPP并确保 AdaptiveCpp 与 ROCm 均已正确安装。构建环境混乱时优先考虑厂商容器镜像如摩尔线程 SCS 套件自带完整工具链第 9 篇。问题 4现象——同事坚持要-DGMX_DOUBLEON构建理由是双精度更准跑基准比 mixed 慢好几倍。根因把数值方法的精度需求与全链路双精度画了等号。GROMACS mixed 精度的设计已经把双精度用在了数值敏感的累积环节官方对 GMX_DOUBLE 的定性是slower, and not normally useful。消费级 GPU 的 FP64 吞吐通常是 FP32 的 1/32 到 1/64全双精度等于把 GPU 的主要算力浪费掉。解法让需求方给出mixed 精度下结果不达标的具体证据能量漂移曲线、与实验值的偏差再考虑双精度或者只对特定计算如自由能计算中的能量差评估精度敏感性。这是本系列铁律 7 的直接应用。四、动手练习练习 1基础用本文脚本或手动逐条执行完成一次 CUDA 基线构建然后运行gmx --version找到并记录三行GROMACS version、CUDA support、Precision。判定成功标准三行均存在其中 CUDA support 显示 enabled 且含 CUDA toolkit 版本号≥12.1Precision 显示 mixed默认构建。练习 2进阶把脚本的版本守卫扩展到 HIP 后端——为 2026 分支添加-DGMX_GPUHIP -DCMAKE_HIP_ARCHITECTURES你的架构路径无 AMD 卡可用gfx90a字面值做干跑只验证 cmake 配置阶段能通过到找 HIP 工具链一步。判定成功标准在有 ROCm 的机器上 cmake 配置完成且 summary 显示 GPU backend: HIP在无 ROCm 机器上报错信息明确指向找不到 HIP 工具链而不是其他莫名的变量错误。练习 3思考题无标准答案为什么 GROMACS 不做一个运行时多后端的二进制像 OpenMM 那样五个平台共存思考方向验证要点① 内核对后端专属特性warp 原语、纹理内存的依赖程度② 单后端编译对分支预测与内联的收益③ 发行版打包的复杂度④ 摩尔线程选择fork 扩展 GMX_GPU 枚举而非插件化的工程理由。五、小结与下一篇预告本篇把 GPU 构建的四条路线走了一遍GMX_GPU枚举四选一是编译期契约架构变量 2025→2026 有一次系统性改名GMX_CUDA_TARGET_SM→CMAKE_CUDA_ARCHITECTURES 等SYCL 分 DPCIntel/AdaptiveCppAMD 推荐两套实现FFT 库按后端定默认值双精度默认不开。构建脚本里的版本守卫是铁律 1 的代码化。下一篇讲构建产物怎么用mdrun的异构执行控制——-gputasks的位图语义、-nb/-pme/-bonded/-update的任务落点、GPU-resident 模式的硬前提constraintsh-bonds。第 5 篇会回到源码层看 gpu_utils 如何把这些运行时控制映射到设备抽象上。本篇认知问题回显FAQQ1GROMACS 2026 开启 GPU 加速的 cmake 命令是什么GMX_GPUON 对吗A不对。GMX_GPU 是后端枚举变量正确写法是-DGMX_GPUCUDA或 OpenCL/SYCL/HIP 四选一一次构建只支持一个 GPU 后端GMX_GPUON是 2021 年前的老写法当前版本会被忽略或报错。Q2GROMACS 2025 和 2026 的 CUDA 架构变量有什么不同A2025.x 用GMX_CUDA_TARGET_SM指定 NVIDIA 架构2026 起重构为 CMake 标准CMAKE_CUDA_ARCHITECTURES值如 86、90、native同时CUDA_TOOLKIT_ROOT_DIR改名CUDAToolkit_ROOT、CUDA_HOST_COMPILER改名CMAKE_CUDA_HOST_COMPILER老变量被移除。Q3GROMACS 的 SYCL 后端在 AMD GPU 上用 DPC 还是 AdaptiveCppA官方推荐 AMD GPU 用 AdaptiveCpp-DGMX_SYCLACPP需 24.02 且配 ROCm 工具链Intel GPU 用 oneAPI DPC默认-DGMX_SYCLDPCPP2024.0。AMD 还有 HIP 后端可选ROCm 5.22026 版起支持完整 offload。Q4GROMACS 什么时候需要开 GMX_DOUBLE 双精度构建A官方定性 GMX_DOUBLEslower, and not normally useful——默认 mixed 精度力单精度、累积双精度对绝大多数生物体系够用只有当 mixed 精度出现可证明的能量漂移或自由能计算精度不达标时才论证开启且要接受消费级 GPU FP64 吞吐仅 FP32 的 1/32 到 1/64 的性能代价。