编译Quantum ESPRESSO代码遇预处理指令及符号错误求助

咱先逐个拆解你遇到的两个编译错误，一步步来排查：

1. 「Illegal preprocessor directive」错误分析与修复 #

这个错误大概率是Fortran预处理器没正确启用，或者指令本身有问题：

• 核心问题：Fortran默认不处理C风格预处理器指令
  Quantum ESPRESSO的代码大量用了#ifdef、#define这类预处理器指令，但GCC的mpif90默认不会解析这些。你现在的编译命令里缺了关键的-cpp选项，必须加上它才能让编译器处理这些指令。
• 次要排查点：
  • 检查你自己写的头文件/代码里有没有拼写错误的预处理器指令，比如把#ifdef写成#ifd，或者#endif不配对的情况。
  • 如果你用到了QE的特定宏（比如__MPI、__OPENMP），记得在编译命令里用-D__MPI这种方式显式定义，不然头文件里的条件编译会出错。

快速修复步骤：
在你的编译命令里加上-cpp选项，比如：

$ mpif90 -cpp -fdollar-ok -ffree-line-length-none -O3 -fopenmp -fPIC -I ../../../qe/6.0-mpi/Modules -I ../src 你的代码文件.f90 [QE库文件...]

2. 「Symbol referenced at (1) not found in module」错误分析与修复 #

这个是链接阶段的符号缺失问题，常见原因和解决方法如下：

• 库的链接顺序搞反了
  Fortran链接器对库的顺序要求很严格：调用库函数的代码要放在库文件的前面。你现在的命令里把QE的库放在了最前面，这会导致链接器找不到代码里引用的符号。得把你的源文件/目标文件移到所有库的前面。
• 漏掉了QE的依赖库
  你只列了libpw.a和libqemod.a，但PW模块还依赖libfft.a、BLAS/LAPACK这些数学库，甚至可能libmpi.a。去QE的PW/src/Makefile里看看，它编译时用到的所有库都要加进你的命令里。
• 代码里没正确引用QE模块
  有些符号是定义在QE的模块里的，比如pwcom、constants这些，你必须在代码开头用use pwcom这类语句引用对应的模块，不然编译器识别不到这些符号。
• 编译选项和QE不匹配
  QE的库是用特定选项编译的（比如是否开MPI、OMP，优化级别），你的代码编译选项必须和它完全一致。比如QE编译时用了-O3 -fopenmp -D__MPI，你也得用同样的选项，不然会因为ABI不兼容导致符号找不到。

快速修复步骤：

1. 调整命令顺序，把你的代码文件放在最前面：

   $ mpif90 -cpp -fdollar-ok -ffree-line-length-none -O3 -fopenmp -fPIC -I ../../../qe/6.0-mpi/Modules -I ../src 你的代码.f90 ../../../qe/6.0-mpi/PW/src/libpw.a ../../../qe/6.0-mpi/Modules/libqemod.a ../../../qe/6.0-mpi/FFTX/src/libfft.a -lblas -llapack
   

2. 对照QE的Makefile，补全所有依赖的库文件；
3. 检查代码里的use语句，确保引用了所有需要的QE模块。

总结 #

先搞定预处理器的问题（加-cpp），再调整链接顺序、补全库文件，同时确保代码正确引用模块、编译选项和QE一致。如果还是卡壳，把完整的错误信息（比如具体哪个指令错了、哪个符号找不到）贴出来，能更快定位问题。

内容的提问来源于stack exchange，提问作者kensaii