必须先安装gfortran编译器,再配置fortls语言服务器和C/C++调试扩展;需手动设置includePaths、launch.json及环境PATH,否则VSCode仅剩基础编辑功能。

VSCode 本身不带 Fortran 编译器,必须单独安装 gfortran(推荐)或 ifort/ifx,否则连基础编译都跑不起来——这是气象科研用户最容易卡住的第一步。
必须先装 gfortran,不是“可选”
气象模型代码(如 WRF、MPAS、CESM 的 Fortran 模块)普遍依赖 GNU 工具链。gfortran 兼容性好、社区支持强、且免费开源。Mac 用户用 brew install gcc(会自动带 gfortran),Ubuntu/Debian 用 sudo apt install gfortran,Windows 推荐通过 MSYS2 安装 mingw-w64-gcc-fortran。
别指望 Modern Fortran 扩展能帮你装编译器——它只负责调用,不负责提供。
- 装完后终端运行
gfortran --version确认输出正常 - 如果 VSCode 报错 “command not found: gfortran”,说明 PATH 没生效,重启 VSCode 或重开终端
- 气象项目常含
.F90预处理文件,gfortran默认支持,无需额外开关
Modern Fortran 扩展 + fortls 是智能功能的唯一来源
语法高亮是开箱即来,但跳转定义、补全、错误实时提示这些科研写代码刚需,全靠 fortls 语言服务器驱动。
pip install fortls 是最稳方式;conda 用户可用 conda install -c conda-forge fortls。注意:Python 环境要和 VSCode 终端一致,否则 fortls 找不到。
- VSCode 设置里确认
fortran.fortls.path指向正确位置,比如"fortran.fortls.path": "fortls"(PATH 中可查到时)或绝对路径 - 若打开 .f90 文件后无大纲(OUTLINE)、无悬停提示,大概率是
fortls没启动成功,看 VSCode 右下角状态栏有没有 “Fortran LS” 正在运行 - 气象代码常用模块(如
netcdf、mpi)的接口提示,依赖fortran.linter.includePaths正确指向对应mod文件目录
调试必须配 C/C++ 扩展 + launch.json
Modern Fortran 扩展自己不提供调试界面,它复用 VSCode 的通用调试协议,所以必须装 Microsoft 官方的 C/C++ 扩展(ID:ms-vscode.cpptools)。
然后在项目根目录建 .vscode/launch.json,关键字段不能少:
{
"version": "0.2.0",
"configurations": [
{
"name": "gfortran debug",
"type": "cppdbg",
"request": "launch",
"program": "${workspaceFolder}/a.out",
"args": [],
"stopAtEntry": false,
"cwd": "${workspaceFolder}",
"environment": [],
"externalConsole": true,
"MIMode": "gdb",
"miDebuggerPath": "gdb",
"setupCommands": [
{ "description": "Enable pretty-printing", "text": "-enable-pretty-printing", "ignoreFailures": true }
]
}
]
}
-
program必须指向已编译好的可执行文件,不是源码 - 气象程序常需命令行参数(如
./wrf.exe namelist.input),填进args数组里 - 用
externalConsole是为了保留write(*,*)输出可见,不然输出可能被吞掉
includePaths 和预处理头文件容易漏配
WRF、CESM 这类项目大量使用 #include "module.inc" 或 INCLUDE 'types.h',一旦路径不对,fortls 就报 “can't find include file”,补全和跳转全挂。
在工作区设置(.vscode/settings.json)里显式加:
{
"fortran.linter.includePaths": [
"${workspaceFolder}/inc",
"${workspaceFolder}/include",
"/usr/include/netcdf",
"/opt/intel/oneapi/mpi/latest/include"
]
}
- 路径用
/**通配没用,fortls不识别 glob,必须写死到具体目录 - NetCDF、MPI 的
.mod和.h路径,得和你编译时用的-I参数完全一致 - 如果项目用 CMake,
fortls不读CMakeLists.txt,所有路径仍得手动同步
Fortran 在气象科研里不是“写完就跑”的脚本语言,而是要长期维护、多人协作、对接 MPI/NetCDF/HDF5 的工程级代码。VSCode 配得再顺,includePaths 错一位、fortls 启动失败、launch.json 指错可执行路径——任意一个点卡住,整个智能支持就退化成纯文本编辑器。动手前先跑通 gfortran hello.f90 && ./a.out,这是底线。











