1. 为什么 Windows 上搭 Fortran 环境总卡在第一步
Fortran 在科学计算、气象建模、工程仿真这些领域依然是主力语言，很多高校课程和科研项目的第一门编程课就是它。但 Windows 平台不像 Linux 那样一条apt install gfortran就能跑起来，初学者最容易卡在三个地方：编译器从哪来、Visual Studio 到底装哪些组件、装完之后命令行敲ifort提示找不到命令。
我见过太多人在这三步里反复卸载重装。核心原因其实就一个——Intel 的 Fortran 编译器（ifort/ifx）在 Windows 上依赖 Visual Studio 的 C++ 链接器和运行库，它不是一个独立安装就能用的东西。所以正确的顺序是：先装 Visual Studio 2022 并勾选 C++ 桌面开发，再装 Intel oneAPI Base Toolkit，最后装 HPC Toolkit。顺序错了，后面编译链接阶段就会报LINK : fatal error LNK1104: 无法打开文件这类错误。
这篇文章面向零基础，把每一步的勾选项、安装路径、环境变量检查命令、编译验证动作全部写清楚，你照着做就能在 Windows 上跑出第一个 Fortran 的 Hello World。另外，如果你后续要用大模型辅助写 Fortran 代码、做代码解释或批量生成计算脚本，我会在最后说明怎么用 TaoToken 把 Key 和 API 通道统一管起来，避免到处散落凭据。
先说清楚这套工具链各自负责什么。Visual Studio 2022 提供 IDE 和 MSVC 链接器；oneAPI Base Toolkit 提供底层运行时、数学库和 DPC++；HPC Toolkit 才包含 Fortran 编译器 ifort（经典）和 ifx（新一代 LLVM 后端）。三者缺一不可，尤其是 HPC Toolkit，很多人只装了 Base 就以为完事了，结果ifort根本不存在。
2. 装 Visual Studio 2022 时 C++ 桌面开发组件怎么勾
Visual Studio 2022 社区版免费，直接去微软官网下载 Community 版本的在线安装器。下载完成后双击运行，进入安装界面。这里的关键是「工作负荷」选项卡，你必须勾选使用 C++ 的桌面开发，这是 Intel Fortran 编译器能找到链接器的前提。
勾选之后，右侧的「安装详细信息」会自动带出一批组件。默认的 MSVC v143 生成工具、Windows 11 SDK 这些保持勾选即可，不用手动加。如果你磁盘紧张，可以取消「适用于最新 v143 生成工具的 C++ ATL」和「C++ MFC」，这两个对 Fortran 没用。但不要取消 Windows SDK，链接阶段会用到。
「单个组件」选项卡里可以再确认一下有没有MSVC v143 - VS 2022 C++ x64/x86 生成工具，有就对了。「语言包」里勾上中文（简体）和英语，界面语言随你，但英语包建议留着，有些报错信息英文原文更好搜。
安装位置强烈建议改到非系统盘，比如E:\VisualStudio和E:\WindowsKits。C 盘空间被吃满之后系统会各种卡，这个坑我踩过。右下角选择「全部下载后安装」，这样网络中断也不会装到一半失败。
安装完成后重启一次电脑，让环境变量生效。重启后打开 Visual Studio，用微软账户登录或直接跳过都行，选个深色主题，然后关掉。这一步只是确认 IDE 能正常启动，真正的编译验证放到最后。
有一点要提醒：Visual Studio 2022 的版本号（比如 17.9、17.10）不影响 Fortran 编译，Intel oneAPI 对 2022 全系都兼容。但如果你电脑上已经有旧版 VS 2019，建议先卸载干净再装 2022，两个版本共存时 Intel 安装器有时会识别错路径。
3. oneAPI Base 与 HPC Toolkit 安装配置全流程
Base Toolkit 和 HPC Toolkit 都从 Intel 官网下载在线安装器，两个是独立的 exe，需要分别下载分别安装。先装 Base，再装 HPC，顺序不能反，因为 HPC 的安装器会检测 Base 是否已存在。
安装 Base Toolkit 时，安装器会问你安装路径，默认在C:\Program Files (x86)\Intel\oneAPI。如果你 C 盘够大就默认，不够就改到别的盘，但记住这个路径，后面配环境变量要用。组件选择界面保持默认全选即可，里面包含 oneAPI DPC++、oneMKL、oneTBB 等，Fortran 编译虽然主要靠 HPC，但 Base 里的运行时库是共享依赖。
装完 Base 接着装 HPC Toolkit。HPC 的组件列表里，Intel Fortran Compiler是必须勾的，它同时包含ifort（经典编译器）和ifx（基于 LLVM 的新编译器）。另外Intel MPI Library建议一起勾上，做并行计算会用到。安装路径保持和 Base 一致，方便统一管理。
两个都装完后，需要确认环境变量。oneAPI 安装器通常会自动写入一个setvars.bat脚本，路径在C:\Program Files (x86)\Intel\oneAPI\setvars.bat。打开「开始菜单」里的Intel oneAPI command prompt for Intel 64 for Visual Studio 2022，这个快捷方式会自动帮你跑 setvars 并配好 VS 环境。在这个窗口里敲：
where ifort where ifx如果输出类似C:\Program Files (x86)\Intel\oneAPI\compiler\latest\windows\bin\ifort.exe，说明编译器已就位。如果提示「找不到文件」，说明环境变量没生效，手动跑一次：
call "C:\Program Files (x86)\Intel\oneAPI\setvars.bat"再where ifort验证。这一步是整个流程的分水岭，能查到路径，后面编译就顺了。
关于凭据管理，如果你后续要用大模型 API 辅助 Fortran 开发（比如让模型解释一段数值计算代码、生成 Makefile、排查编译错误），建议把 Key 统一放在 TaoToken 管理。它的控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，在里面创建 Key 之后，所有调用走同一个 Base URLhttps://taotoken.net/api，不用在多个工具里重复填。下面给一个可复制的配置片段，假设你要在某个支持 OpenAI 兼容协议的工具里接入：
{ "base_url": "https://taotoken.net/api", "api_key": "sk-你的TaoToken密钥", "model": "claude-sonnet-4-5", "timeout": 60 }如果你用的是 Claude Code 这类编码工具，配置项名称可能是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY，值分别填https://taotoken.net/api和你的 Key，Model ID 填你实际要用的模型标识。三件套（Base URL + Key + Model ID）缺一不可，少一个就会报 401 或 model not found。
4. 编译 Hello World 验证 ifort 与 ifx 工具链
环境配好后，写一个最小 Fortran 程序验证。新建文件hello.f90，内容如下：
program hello implicit none print *, "Hello, Fortran on Windows!" end program hello在 Intel oneAPI 命令提示符窗口里，cd 到文件所在目录，先用经典编译器 ifort：
ifort hello.f90 -o hello_ifort.exe hello_ifort.exe如果输出Hello, Fortran on Windows!，说明 ifort 链路通了。再用新一代 ifx 编译一次：
ifx hello.f90 -o hello_ifx.exe hello_ifx.exe两个都输出正确结果，工具链就算完整可用。ifx 是 Intel 主推的方向，新项目建议优先用它，性能和 LLVM 生态更好；ifort 兼容老代码更稳，很多遗留科研项目还在用。
如果你想在 Visual Studio IDE 里编译，打开 VS 2022，创建新项目，搜索「Fortran」，会看到 Intel 提供的模板（安装 HPC Toolkit 后才会出现）。选 Console Application，写同样的代码，按 F5 调试运行。IDE 里能跑通，说明 VS 集成也正常。
验证过程中可以顺便看一下编译器版本：
ifort --version ifx --version输出里会带 oneAPI 版本号和构建日期。记下这个版本，以后遇到兼容性问题好排查。实测下来，2024 之后的 oneAPI 版本对 Windows 11 支持都很稳，老版本在 Win11 上偶发 setvars 脚本报错。
5. 常见报错排查：401、local proxy failed 与 reading choices
装完环境跑代码，报错基本集中在几类。第一类是编译期找不到命令，'ifort' 不是内部或外部命令，这是环境变量没加载，回到第 3 节用 setvars.bat 解决，注意必须用 Intel 专用的命令提示符，普通 cmd 不会自动加载。
第二类是链接错误LNK1104: 无法打开文件 'kernel32.lib'，这通常是 Visual Studio 的 C++ 组件没装全，或者安装路径和 Intel 安装器记录的不一致。解决办法是打开 VS Installer，确认「使用 C++ 的桌面开发」处于已安装状态，然后重跑一次 setvars。
第三类出现在调用大模型 API 辅助开发时。如果你在工具里配了 TaoToken 但请求失败，常见报错有：
401 Unauthorized—— Key 填错或过期，去控制台重新生成一个，注意别把前后空格复制进去。
local proxy failed或连接超时 —— 检查 Base URL 是否写成了https://taotoken.net/api，末尾不要多加斜杠，也不要填成网页地址。
reading choices或返回体解析失败 —— 多半是 Model ID 写错，比如把claude-sonnet-4-5写成了不存在的名字，换成控制台里列出的可用模型标识即可。
OAuth相关报错 —— 如果你用的是 Claude Code 这类走 OAuth 的工具，确认配置项名称和值对应正确，Base URL 和 Key 要成对出现，只改一个会认证失败。
排查思路统一：先确认三件套（Base URL、Key、Model ID）齐全且无拼写错误，再用最小请求测试。TaoToken 的接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，里面有各工具的配置示例，对着改比盲猜快。
第四类是 Fortran 运行期错误，比如数组越界、除零，这类和工具链无关，属于代码逻辑问题。编译时加-check all参数可以让 ifort/ifx 在运行时做边界检查，调试阶段很有用：
ifort -check all -traceback hello.f90 -o hello_debug.exe-traceback会在崩溃时打印调用栈，定位问题比看天书强得多。
6. 把 Key 与 API 通道统一管起来
Fortran 开发本身不需要联网，但现代工作流里，用大模型做代码审查、生成测试用例、解释数值算法、把老式 F77 代码翻译成 F90 风格，这些场景越来越常见。问题在于，如果你同时用多个工具（命令行助手、IDE 插件、脚本），每个都单独配 Key，管理起来很乱，换 Key 要改一堆地方。
TaoToken 的做法是提供一个统一的 API 入口，所有工具都指向同一个 Base URL，Key 在控制台集中管理。这样你换 Key、看用量、加模型，都只在一个地方操作。对于长期做 Fortran 科学计算的人，我建议把常用模型和 Key 在控制台里建好，然后：
- 需要快速问代码问题、验证模型输出，用模型对话入口 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
- 需要长期跑编码任务、Agent 自动化，用 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
- 需要生成或管理多个 Key，去 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
配置的时候记住三件套原则：Base URL 填https://taotoken.net/api，Key 填控制台生成的，Model ID 填你要用的模型标识。三个都对上，请求才能通。如果你用 Claude Code 做 Fortran 代码辅助，配置项按它的规范来，但值还是这三样。
最后给一个实用建议：把 setvars.bat 的调用写进一个自己的启动脚本，比如fortran_env.bat，内容就一行call "C:\Program Files (x86)\Intel\oneAPI\setvars.bat"，以后开新窗口先跑它，省得每次找开始菜单。环境搭一次，后面几年都能用，值得花十分钟把它弄利索。
