WSL2下WRF环境搭建保姆级教程：从零搞定gcc/gfortran编译器与系统依赖

张

张建站

2026/5/29 21:42:56

10分钟阅读

WSL2下WRF环境搭建保姆级教程：从零搞定gcc/gfortran编译器与系统依赖

WSL2环境下WRF模型编译环境全栈配置指南在气象建模与数值预报领域WRFWeather Research and Forecasting作为行业标准工具链其环境配置一直是科研人员的技术门槛。传统物理机或虚拟机方案面临资源占用高、系统隔离复杂等问题而Windows Subsystem for Linux 2WSL2通过轻量级虚拟化技术实现了近乎原生的Linux性能与Windows系统的无缝集成。本文将系统性地解构WSL2环境下WRF编译环境的构建过程特别针对gcc/gfortran工具链配置、系统依赖管理以及WSL特有优化进行深度剖析。1. WSL2环境准备与基础配置1.1 WSL2安装与初始化确保Windows 10版本2004或更高以管理员身份运行PowerShell执行环境启用命令wsl --install -d Ubuntu-22.04 wsl --set-version Ubuntu-22.04 2安装完成后需进行基础系统更新sudo apt update sudo apt upgrade -yWSL2特有优化项内存限制调整在%UserProfile%\.wslconfig中添加[wsl2] memory8GB processors4磁盘性能优化避免在Windows目录下直接操作Linux文件应使用/mnt之外的纯Linux路径1.2 开发工具链安装WRF编译依赖的核心工具包及其作用包名称功能描述是否必需gccGNU C编译器用于编译C语言编写的模块是gfortranGNU Fortran编译器处理Fortran语言组件是m4宏处理器处理WRF构建过程中的宏定义是cshC Shell解释器执行配置脚本是make构建自动化工具管理复杂的编译流程是libcurl4网络传输库支持数据下载功能推荐一次性安装命令sudo apt install -y gcc gfortran m4 csh make libcurl4 \ build-essential flex bison libtool automake注意WSL2默认不包含32位库支持若需兼容旧版代码需额外安装gcc-multilib2. 编译器环境验证与调优2.1 工具链版本兼容性检查执行以下命令验证关键组件版本gcc --version | head -n1 gfortran --version | head -n1 make --version | head -n1推荐版本组合GCC ≥ 9.4.0GFortran ≥ 9.4.0Make ≥ 4.3版本冲突解决方案当系统仓库版本过低时可通过第三方PPA升级sudo add-apt-repository ppa:ubuntu-toolchain-r/test sudo apt install gcc-12 g-12 gfortran-12 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-12 1002.2 编译测试套件验证下载WRF官方测试套件并执行全面验证mkdir -p ~/WRF_TESTS cd ~/WRF_TESTS wget https://www2.mmm.ucar.edu/wrf/OnLineTutorial/compile_tutorial/tar_files/Fortran_C_tests.tar tar -xvf Fortran_C_tests.tar关键测试项执行与预期结果固定格式Fortran测试gfortran TEST_1_fortran_only_fixed.f -o test_fixed ./test_fixed成功输出SUCCESS fixed Fortran testC与Fortran混合编译测试gcc -c -m64 TEST_4_fortranc_c.c gfortran -c -m64 TEST_4_fortranc_f.f90 gfortran -m64 TEST_4_fortranc_f.o TEST_4_fortranc_c.o -o test_mix ./test_mix成功输出SUCCESS mixed FortranC test3. 系统级环境配置优化3.1 文件系统性能调优WSL2的跨系统文件操作存在显著性能差异操作类型Windows路径(/mnt/)Linux原生路径性能差异小文件读写15-20MB/s450-500MB/s30倍大规模目录扫描1200文件/秒8500文件/秒7倍建议工作目录设置export WRF_ROOT~/Build_WRF mkdir -p $WRF_ROOT/{SRC,LIBRARIES,WRF,TESTS}3.2 环境变量全局配置编辑~/.bashrc添加编译环境变量# 编译器基础配置 export CCgcc export CXXg export FCgfortran export F77gfortran export F90gfortran # 架构优化参数 export CFLAGS-m64 -O3 export FFLAGS-m64 -O3 export FCFLAGS-m64 -O3 # 路径配置 export NETCDF$WRF_ROOT/LIBRARIES/netcdf export PATH$NETCDF/bin:$PATH export LD_LIBRARY_PATH$NETCDF/lib:$LD_LIBRARY_PATH应用配置并验证source ~/.bashrc which gcc gfortran4. 依赖库的源码编译实践4.1 NetCDF库完整安装流程下载源码包cd $WRF_ROOT/SRC wget https://downloads.unidata.ucar.edu/netcdf-c/4.9.2/netcdf-c-4.9.2.tar.gz wget https://downloads.unidata.ucar.edu/netcdf-fortran/4.6.1/netcdf-fortran-4.6.1.tar.gz编译C库tar xzf netcdf-c-4.9.2.tar.gz cd netcdf-c-4.9.2 ./configure --prefix$WRF_ROOT/LIBRARIES/netcdf --disable-dap make -j$(nproc) make install编译Fortran接口cd $WRF_ROOT/SRC tar xzf netcdf-fortran-4.6.1.tar.gz cd netcdf-fortran-4.6.1 export CPPFLAGS-I$WRF_ROOT/LIBRARIES/netcdf/include export LDFLAGS-L$WRF_ROOT/LIBRARIES/netcdf/lib ./configure --prefix$WRF_ROOT/LIBRARIES/netcdf make -j$(nproc) make install验证安装nc-config --all nf-config --all4.2 MPI环境配置方案对于需要并行计算的场景推荐使用MPICHcd $WRF_ROOT/SRC wget https://www.mpich.org/static/downloads/4.1.2/mpich-4.1.2.tar.gz tar xzf mpich-4.1.2.tar.gz cd mpich-4.1.2 ./configure --prefix$WRF_ROOT/LIBRARIES/mpich make -j$(nproc) make install环境变量追加export PATH$WRF_ROOT/LIBRARIES/mpich/bin:$PATH export MPI_LIB$WRF_ROOT/LIBRARIES/mpich/lib5. WRF编译实战与排错指南5.1 源码获取与预处理下载最新稳定版WRF源码cd $WRF_ROOT/SRC wget https://github.com/wrf-model/WRF/archive/refs/tags/v4.5.tar.gz tar xzf v4.5.tar.gz cd WRF-4.5配置环境检测./configure选择选项34GNU/gfortran并确认编译器路径正确5.2 编译过程优化技巧并行编译加速./compile -j$(nproc) em_real 21 | tee compile.log常见错误处理Missing netcdf.inc确认NETCDF环境变量指向包含include目录的路径Unsupported Fortran standard在configure.wrf中添加-fallow-argument-mismatchMemory exhaustion调整WSL2内存配置或使用ulimit -s unlimited编译成功验证ls -l main/*.exe ndiff.exe real.exe tc.exe wrf.exe5.3 WPS配套工具编译cd $WRF_ROOT/SRC wget https://github.com/wrf-model/WPS/archive/refs/tags/v4.5.tar.gz tar xzf v4.5.tar.gz cd WPS-4.5 ./configure选择选项1Linux x86_64并编辑configure.wpsCOMPRESSION_LIBS -L$WRF_ROOT/LIBRARIES/grib2/lib -ljasper -lpng -lz COMPRESSION_INC -I$WRF_ROOT/LIBRARIES/grib2/include编译命令./compile 21 | tee wps_compile.log