WRF4.2安装避坑指南：从环境配置到编译成功的完整流程

1. 环境准备：从零搭建WRF4.2的基石

第一次安装WRF4.2时，我在环境配置环节卡了整整三天。后来才发现，90%的编译失败都源于基础环境没打好。咱们先搞定这个地基，后面才能稳如磐石。

1.1 编译器全家桶安装

gcc、gfortran这些编译器就像盖房子的工具，缺一锤子都砌不好墙。实测在Ubuntu 20.04上最稳的组合是：

sudo apt update sudo apt install gfortran-9 gcc-9 g++-9 cpp-9 make m4

这里有个坑：别直接用默认的gcc版本，我遇到过gcc-11不兼容的情况。强制指定版本更保险：

sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 60 sudo update-alternatives --install /usr/bin/gfortran gfortran /usr/bin/gfortran-9 60

验证是否装对：

gcc --version # 应该显示9.x版本 gfortran --version

1.2 目录结构规划

见过太多人把WRF装得乱七八糟，最后自己都找不到文件。推荐这样建目录：

mkdir -p ~/WRF_WorkStation/{Libraries,WRFV4.2,WPSV4.2,test}

这个结构优势在于：

• Libraries集中存放所有依赖库
• WRFV4.2和WPSV4.2并列放置（必须同级目录！）
• test文件夹专门放测试用例

2. 依赖库安装：最容易翻车的重灾区

去年帮学弟调试时发现，netCDF库装错版本会导致后续连环报错。这些库就像房子的钢筋骨架，必须精确到位。

2.1 netCDF编译实战

先下载netcdf-4.1.3.tar.gz到Libraries目录，然后：

tar xzf netcdf-4.1.3.tar.gz cd netcdf-4.1.3 ./configure --prefix=$DIR/netcdf --disable-dap --disable-netcdf-4 --disable-shared make -j$(nproc) # 启用多核编译 make install

关键点：

• --disable-shared必须加，否则WRF编译时会报符号冲突
• 遇到权限问题别急着sudo，先检查$DIR路径权限
• 最后一定要看到"Congratulations!"提示才算成功

2.2 MPI环境配置技巧

推荐用mpich-3.0.4而不是openmpi，兼容性更好：

./configure --prefix=$DIR/mpich --with-device=ch3 FFLAGS=-fallow-argument-mismatch make && make install

注意这个-fallow-argument-mismatch参数是关键！新版本gfortran对参数检查更严格，不加这个会报类型不匹配错误。

3. 环境变量配置：那些手册没告诉你的细节

.bashrc文件就像控制中心的开关面板，我见过有人因为漏配变量导致编译通过但运行时崩溃。

3.1 完整环境变量模板

把这组配置加到~/.bashrc末尾：

export DIR=~/WRF_WorkStation/Libraries export NETCDF=$DIR/netcdf export PATH=$NETCDF/bin:$PATH export WRFIO_NCD_LARGE_FILE_SUPPORT=1 export LD_LIBRARY_PATH=$DIR/netcdf/lib:$DIR/mpich/lib:$LD_LIBRARY_PATH

重点检查：

• 所有路径必须使用绝对路径
• 变量名严格区分大小写
• 改完后执行source ~/.bashrc立即生效

3.2 验证环境是否健全

运行这套测试命令（缺一不可）：

# 基础编译器测试 gfortran TEST_1_fortran_only_fixed.f && ./a.out # MPI+netCDF联合测试 mpif90 -c 02_fortran+c+netcdf+mpi_f.f mpirun -np 4 ./a.out # 应该看到4个进程的输出

如果这里报libmpi.so找不到，基本是LD_LIBRARY_PATH没配好。

4. WRF本体编译：从configure到成功的全流程

终于来到重头戏，这里我总结出三个关键checkpoint。

4.1 configure选项的玄机

进入WRFV4.2目录后：

./configure # 选34(dmpar) + 1(basic)

常见报错解决方案：

• 如果提示missing netcdf.h：检查NETCDF变量是否导出
• 报libimf.so错误：执行export LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libgfortran.so.5

4.2 compile的监控技巧

别傻等编译完成，用这个命令实时监控：

./compile em_real > log.compile 2>&1 & tail -f log.compile | grep Error -A10 -B10

正常情况应该看到：

• 没有fatal error
• 进度从depend -> convert_em -> 各模块编译
• 最终生成wrf.exe等可执行文件

4.3 验证编译成果

检查三个关键文件：

ls -lh main/wrf.exe # 应该>50MB ls -lh main/real.exe # 应该>20MB ls -lh main/ndown.exe # 应该>10MB

如果文件大小明显偏小，肯定是编译过程有错误被忽略了。

5. WPS编译：最后一道关卡

WPS就像给WRF配的钥匙，没它就跑不了实际案例。

5.1 必须的清理操作

先进入WPS目录执行：

./clean -a # 比单纯./clean更彻底

我曾经因为没清理干净，导致新旧对象文件混用，结果geo_em文件死活生成不了。

5.2 编译选项的坑

关键配置步骤：

export WRF_DIR=../WRFV4.2 ./configure # 选3(gfortran+dmpar)

这里有个隐藏技巧：如果configure列表里没有出现gfortran选项，说明前面的环境变量没生效，回去检查.bashrc。

5.3 成功标志验证

编译完成后应该看到：

ls -l *.exe # 要有geogrid.exe、ungrib.exe、metgrid.exe

文件大小参考：

• geogrid.exe约15MB
• ungrib.exe约8MB
• metgrid.exe约12MB

如果遇到链接错误，试试重新编译WPS前先执行：

export LDFLAGS="-L$NETCDF/lib -lnetcdff -lnetcdf"

从第一次安装WRF到现在，我至少重装了二十次。最深刻的体会是：严格按步骤来，别自作聪明跳步。曾经为了省事跳过测试环节，结果debug花的时间反而更多。现在每次装新环境，都会把这篇指南当checklist用，目前为止还没失手过。