1. 为什么在 Linux 上编译 SLEPc 总卡在 PETSc 和 IntelMPI 这一步SLEPc 是 PETSc 的可扩展特征值求解器扩展库做大规模稀疏矩阵特征值、奇异值分解、非线性特征问题时基本绕不开它。它本身不复杂复杂的是依赖链SLEPc 必须挂在一个已经编译好的 PETSc 上而 PETSc 又必须挂在一个 MPI 实现上。三者版本、编译器、ABI 只要有一处对不上configure阶段就会报一堆看不懂的错。我这次的目标环境是 Linux 工作站 / HPC 节点用 Intel oneAPI 里的 IntelMPI 作为并行后端PETSc 和 SLEPc 都装到/data/3rdparty下方便多用户共享。整个流程走下来真正花时间的不是敲命令而是搞清楚PETSC_DIR、PETSC_ARCH、SLEPC_DIR这三个变量到底谁指向谁。这篇就把从 PETSc 到 IntelMPI 再到 SLEPc 的完整配置、可复制命令和验证脚本一次讲清楚适合已经装过 PETSc、准备上 SLEPc 的人直接跟做。先说结论性的依赖关系后面所有命令都围绕它展开组件作用本篇使用的路径IntelMPI并行通信后端oneAPI 自带PETSc底层并行数值库/data/3rdparty/intel-dbg-zmoSLEPc特征值求解扩展/home/nene/dev/slepc关键点在于SLEPc 编译时不重新编译 PETSc它只是读取 PETSc 的配置信息然后把自己链接上去。所以 PETSc 必须先编译安装完成且PETSC_DIR指向的目录里要有完整的lib/petsc/conf配置。2. 前置准备IntelMPI 环境与 PETSc 就位2.1 安装 Intel oneAPI 的 MPI 组件IntelMPI 随 oneAPI 的 HPC Toolkit 提供。在 Ubuntu / Debian 系上可以直接用 apt 装sudo apt update sudo apt install intel-oneapi-base-toolkit sudo apt install intel-oneapi-hpc-toolkit装完后 IntelMPI 的编译器包装器mpicc、mpicxx、mpif90在/opt/intel/oneapi/mpi/latest/bin下。每次新开 shell 都要 source 环境source /opt/intel/oneapi/setvars.sh验证 MPI 是否可用which mpicc mpicc --version如果which mpicc输出为空说明setvars.sh没生效或者 oneAPI 装到了非默认路径。这一步必须先过否则后面 PETSc 的configure会直接判定没有可用 MPI。2.2 确认 PETSc 已编译完成SLEPc 依赖的 PETSc 必须是已经 make 完成的状态不能只是 configure 过。检查目标目录ls /data/3rdparty/intel-dbg-zmo/lib/petsc/conf正常应该能看到petscvariables、petscconf、reconfigure.py等文件。如果这个目录不存在说明 PETSc 还没装好需要先回去编译 PETSc。PETSc 的编译核心是export PETSC_ARCHintel-dbg-zmo python3 ./configure --with-ccmpicc --with-cxxmpicxx --with-fcmpif90 \ --prefix/data/3rdparty/intel-dbg-zmo --with-debugging1 make PETSC_DIR/path/to/petsc PETSC_ARCHintel-dbg-zmo all make PETSC_DIR/path/to/petsc PETSC_ARCHintel-dbg-zmo install注意PETSC_ARCH这个变量。它既是 PETSc 编译时的架构标签也是 SLEPc 定位 PETSc 配置的钥匙。你 PETSc 编译时用了什么PETSC_ARCHSLEPc 这边就得用同一个值否则找不到。提示如果你的 PETSc 是用--prefix安装到独立目录的那么PETSC_DIR指向这个 prefix 目录即可PETSC_ARCH保持和编译时一致。不要把它设成空字符串除非你 PETSc 编译时确实没设 arch。3. 可复制的 SLEPc 配置与编译命令3.1 获取 SLEPc 源码git clone https://github.com/slepc/slepc.git cd ./slepc克隆下来默认是主分支。生产环境建议切到与 PETSc 版本匹配的 tag比如 PETSc 3.21 对应 SLEPc 3.21git tag --list | grep 3.21 git checkout v3.21.0版本不匹配是后面configure报错最常见的原因之一PETSc 和 SLEPc 的主次版本号最好一致。3.2 设置环境变量这是整个流程里最容易出错的地方。三个变量各司其职export PETSC_DIR/data/3rdparty/intel-dbg-zmo export PETSC_ARCHintel-dbg-zmo export SLEPC_DIR/home/nene/dev/slepcPETSC_DIRPETSc 的安装前缀目录里面要有lib/petsc/conf。PETSC_ARCHPETSc 编译时的架构标签必须和 PETSc 编译时一致。SLEPC_DIRSLEPc 源码根目录也就是你git clone出来的那个目录。如果你 PETSc 是直接装在源码目录里没加--prefix那PETSC_DIR就指向 PETSc 源码目录PETSC_ARCH用你编译时的标签。3.3 执行 configurepython3 ./configure --prefix/data/3rdparty/intel-dbg-zmo这里--prefix指向的是 SLEPc 的安装位置。我习惯把 SLEPc 和 PETSc 装到同一个前缀下这样头文件和库都在一起后续编译应用时-I和-L只写一个路径就行。configure成功时结尾会打印一段总结重点看这几行 SLEPc Configuration SLEPc directory: /home/nene/dev/slepc PETSc directory: /data/3rdparty/intel-dbg-zmo ... MPI: yes只要MPI: yes且 PETSc 路径正确就说明依赖识别成功。如果MPI: no回去检查setvars.sh是否 source 过。3.4 编译与安装make SLEPC_DIR/home/nene/dev/slepc PETSC_DIR/data/3rdparty/intel-dbg-zmo make SLEPC_DIR/home/nene/dev/slepc PETSC_DIR/data/3rdparty/intel-dbg-zmo install这里显式把SLEPC_DIR和PETSC_DIR传给 make是为了避免环境变量在某些 shell 会话里丢失导致编译中断。make阶段会编译 SLEPc 的所有源文件install阶段把库和头文件复制到--prefix指定的目录。编译时间取决于机器核数可以用-j加速make SLEPC_DIR/home/nene/dev/slepc PETSC_DIR/data/3rdparty/intel-dbg-zmo -j8注意make和make install都要带上这两个变量。只带一个或者都不带make 会去默认路径找 PETSc找不到就报PETSC_DIR is not set或Cannot find PETSc。4. 验证确认 SLEPc 并行功能真的正常编译装完不代表能用必须跑一个真实例子确认 MPI 并行链路是通的。SLEPc 自带示例在src/eps/examples/tutorials下用ex1.c做验证最直接。4.1 编译示例程序cd $SLEPC_DIR/src/eps/examples/tutorials make ex1 PETSC_DIR$PETSC_DIR PETSC_ARCH$PETSC_ARCH SLEPC_DIR$SLEPC_DIR编译成功会生成ex1可执行文件。如果报链接错误多半是PETSC_ARCH没对上。4.2 单进程运行./ex1 -eps_view正常输出会打印一个 2x2 或更大矩阵的特征值求解过程最后给出收敛的特征值。看到Number of iterations和特征值结果就说明单进程链路通了。4.3 多进程并行运行这是验证 IntelMPI 是否真正生效的关键一步mpirun -np 4 ./ex1 -eps_view-np 4表示用 4 个 MPI 进程。如果并行正常输出里会显示每个进程的 rank 信息且求解结果和单进程一致。如果mpirun报unable to find mpirun或进程启动失败说明 IntelMPI 的运行时环境没配好重新 sourcesetvars.sh。4.4 用脚本一键验证把上面的步骤写成一个验证脚本方便每次环境变动后快速自检#!/bin/bash set -e source /opt/intel/oneapi/setvars.sh export PETSC_DIR/data/3rdparty/intel-dbg-zmo export PETSC_ARCHintel-dbg-zmo export SLEPC_DIR/home/nene/dev/slepc cd $SLEPC_DIR/src/eps/examples/tutorials make ex1 PETSC_DIR$PETSC_DIR PETSC_ARCH$PETSC_ARCH SLEPC_DIR$SLEPC_DIR echo single process ./ex1 -eps_view | tail -5 echo 4 processes mpirun -np 4 ./ex1 -eps_view | tail -5 echo SLEPc verification passed脚本跑完打印SLEPc verification passed就说明从 PETSc 到 IntelMPI 再到 SLEPc 的整条链路都正常。5. 本篇常见错误排查编译 SLEPc 时遇到的报错八成集中在下面几类。我把它们和对应解法列出来方便对照。报错一PETSC_DIR is not set或Cannot find PETSc原因是 make 时没传PETSC_DIR或者传的路径里没有lib/petsc/conf。检查ls $PETSC_DIR/lib/petsc/conf/petscvariables文件不存在就说明PETSC_DIR指错了或者 PETSc 根本没 install。报错二PETSC_ARCH不匹配导致链接失败典型表现是编译示例时undefined reference to PetscXXX。这是因为 SLEPc 编译时用的 PETSc 配置和示例链接时用的不是同一套。确保PETSC_ARCH在 configure、make、示例编译三个阶段完全一致。报错三MPI: noconfigure总结里 MPI 显示 no说明没找到mpicc。执行source /opt/intel/oneapi/setvars.sh后重新 configure。如果还是 no检查which mpicc是否有输出。报错四mpirun启动进程失败多进程验证时mpirun -np 4报错通常是 IntelMPI 的 fabric 或运行时库问题。先确认setvars.sh已 source再试mpirun -np 2 ./ex1。如果 2 进程能跑 4 进程不行可能是节点资源限制不是编译问题。报错五版本不匹配PETSc 3.21 配 SLEPc 3.20 这类跨版本组合configure可能直接拒绝。用git checkout切到与 PETSc 主次版本一致的 SLEPc tag。提示每次改完环境变量先echo $PETSC_DIR $PETSC_ARCH $SLEPC_DIR确认三个值都对再执行 make。很多玄学报错其实就是变量在某个 shell 里丢了。6. 后续接入与工具链建议SLEPc 装好之后真正写应用代码时还需要把编译参数配好。最省事的方式是用 PETSc 提供的pkg-config或者直接复用petscvariables里的编译标志。一个典型的应用编译命令长这样mpicc -o myapp myapp.c \ -I$PETSC_DIR/include -I$SLEPC_DIR/include \ -L$PETSC_DIR/lib -L$SLEPC_DIR/lib \ -lslepc -lpetsc -lm如果你在 HPC 集群上多节点部署建议把PETSC_DIR、PETSC_ARCH、SLEPC_DIR写进 modulefile 或环境脚本避免每次登录手动 export。验证脚本也建议放进 CI每次升级 PETSc 或 IntelMPI 后自动跑一遍确认并行链路没断。对于需要长期跑大规模特征值计算的场景把 SLEPc 的编译配置和验证流程固化下来比每次重新踩坑划算得多。如果你还想在编译之外快速验证模型或做参数调试可以走 TaoToken 模型对话 做辅助需要把 SLEPc 接入到自动化编码或 Agent 工作流时Coding Plan 更适合长期使用。API Key 在 控制台 里管理接入细节看 API 文档接口地址是https://taotoken.net/api。