Windows 平台 Ollama AMD GPU 一键编译指南：基于 ROCm 7.1 的自动化实战

Windows 平台 Ollama AMD GPU 一键编译指南：基于 ROCm 7.1 的自动化实战

引言：从手动编译到一条命令

去年我们在 Windows 上编译 Ollama 的 AMD GPU 版本时，需要在 PowerShell 里小心翼翼地把环境变量逐个敲进去，手动搞定 CMake 和 Ninja，稍有不慎就可能因为一个架构参数而前功尽弃。如今，随着 ROCm 7.1 正式支持 RDNA 3.5 架构，社区也打磨出了一套高度自动化的构建脚本——只需一行命令，就能把 Ollama 源码编译成原生调用 AMD GPU 的 Windows 可执行文件。

本文将承接《Windows 平台 Ollama AMD GPU 编译全攻略：基于 ROCm 6.2》的核心内容，聚焦于ROCm 7.1 + 自动化脚本的新方案。我们会从环境准备、硬件兼容、脚本使用到底层编译原理一路讲透，让你不但能跑通流程，还能理解每一步在干什么，出了问题也能快速定位。

适用版本：Ollama v0.20.6 + ROCm 7.1 + Windows 10/11
一键脚本仓库：tengfei527/ollama-for-amd-auto-build

一、 为什么选择 ROCm 7.1？

如果你用的是RX 7600（非 XT）、RX 7700S等 RDNA 3.5 显卡，ROCm 6.2 会直接报“invalid target ID”错误，必须升级到 7.1。即便是老一代的 RX 7900 XTX 等 RDNA 3 卡，新版在编译速度和运行稳定性上也有肉眼可见的改善。

二、 环境准备与硬件兼容性

2.1 你的 AMD 显卡能被支持吗？

编译前务必先确认 GPU 架构。下表整理了 ROCm 7.1 官方支持的主流架构及对应显卡：

图1：GPU 架构判断流程

快速定位架构：打开设备管理器 → 显示适配器 → 右键属性 → 详细信息 → 硬件 ID，根据VEN_1002&DEV_xxxx到 TechPowerUp GPU Database 查询对应的 GFX 代号。

2.2 软件依赖一览

自动化脚本会帮你处理大部分环境问题，但这些基础软件仍需提前安装：

安装后快速验证：

cmake--version# 应显示 4.xgo version# 应显示 go1.24+# 检查 ROCm&"C:\Program Files\AMD\ROCm\7.1\bin\hipconfig.bin.exe"--version# 安装 MinGW GCC（在 MSYS2 终端执行一次）C:\msys64\usr\bin\bash.exe-lc"pacman -S --noconfirm mingw-w64-x86_64-gcc"gcc--version

三、 一键脚本：auto_build.ps1完全指南

所有繁琐的步骤都被整合进了auto_build.ps1，你只需要告诉它目标版本号。

3.1 快速开始

# 克隆一键脚本仓库git clone https://github.com/tengfei527/ollama-for-amd-auto-build.git cd ollama-for-amd-auto-build# 执行构建（以 v0.20.6 为例）.\auto_build.ps1-Version 0.20.6

参数详解：

常用场景举例：

# 仅重新编译 CLI（ROCm 后端 DLL 已编译好）.\auto_build.ps1-Version 0.20.6-SkipMerge-SkipROCm# 仅编译 ROCm 后端，不编译 CLI.\auto_build.ps1-Version 0.20.6-SkipMerge# 之后再单独编译 CLI

3.2 自动化流程全景图

脚本内部的执行管线可概括为五个阶段，每个阶段都内置了错误检测与重试机制。

3.3 关键设计解读

（1）动态构建目录，告别文件锁定

脚本每次生成带时间戳的构建目录（如build/rocm-20250614143022），新旧构建互相独立，哪怕上一次的 DLL 仍被进程占用也不影响本次编译。

（2）只编译你需要的 GPU 架构

脚本中的$GPUTargets变量默认仅开启gfx1031（RX 6700 XT 等）。请根据你的显卡修改该变量，例如：

• RX 7900 XTX →"gfx1100"
• RX 7800 XT →"gfx1102"
• RX 6600 XT →"gfx1032"
• 同时支持多种 →"gfx1100;gfx1032"

只编译匹配的架构可将编译时间从 25+ 分钟缩短到 5~8 分钟。

（3）利用 CMake 预设

仓库内置了rocm_v7_1_windows预设，内部已配置好 HIP 编译器路径、链接标志等，无需手动指定-DCMAKE_HIP_COMPILER，大幅降低出错概率。

（4）MinGW 依赖自动补全

Go 编译的ollama.exe依赖libwinpthread-1.dll等 MinGW 运行时库，脚本会在构建结束后自动将这些 DLL 复制到输出目录，省去手动查找的烦恼。

四、 手动分步构建（供调试参考）

如果你希望深入理解每一步，或者在自动化脚本出现意外时需要手动介入，可参考下面的分步命令。

4.1 源码准备与上游合并

git clone https://github.com/tengfei527/ollama-for-amd-auto-build.git cd ollama-for-amd-auto-build git remote add upstream https://github.com/ollama/ollama.git git fetch upstream--tags git merge v0.20.6--no-edit# 如有冲突，手动解决后 git commit

4.2 编译 ROCm 后端（ggml-hip.dll）

第一步：激活 VS 2022 编译环境

$vsPath= &"${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe"-latest-property installationPath cmd/c"`"$vsPath\VC\Auxiliary\Build\vcvars64.bat`" >nul 2>&1 && set"|ForEach-Object{if($_-match"^(.*?)=(.*)$"){[Environment]::SetEnvironmentVariable($matches[1],$matches[2],"Process")}}

第二步：配置 ROCm 7.1 环境变量

$HipPath="C:\Program Files\AMD\ROCm\7.1"$env:HIP_PATH =$HipPath$env:HIPCXX ="$HipPath\bin\clang++.exe"$env:HIP_PLATFORM ="amd"$env:CMAKE_PREFIX_PATH =$HipPath$env:CC ="$HipPath\bin\clang.exe"$env:CXX ="$HipPath\bin\clang++.exe"$env:LIB+=";$HipPath\lib"$env:INCLUDE+=";$HipPath\include"

第三步：CMake 配置、编译与安装

$GPUTargets="gfx1100"# 替换为你的 GPU 架构cmake-S llama/server-B build/rocm `--preset rocm_v7_1_windows `-G Ninja `-DAMDGPU_TARGETS="$GPUTargets"`-DCMAKE_HIP_FLAGS="-parallel-jobs=6"cmake--build build/rocm--target ggml-hip--config Release--parallel6 cmake--install build/rocm--component llama-server--prefix"dist/windows-amd64"--strip

4.3 编译 Ollama 主程序（ollama.exe）

$env:PATH ="C:\msys64\mingw64\bin;$env:PATH"$env:CGO_ENABLED ="1"$env:CC ="gcc"$env:CXX ="g++"go build-trimpath-ldflags"-s -w -X=github.com/ollama/ollama/version.Version=0.20.6-amd -X=github.com/ollama/ollama/server.mode=release".Copy-Itemollama.exe dist/windows-amd64/# 补全 MinGW 依赖$mingwPath="C:\msys64\mingw64\bin"@("libwinpthread-1.dll","libgcc_s_seh-1.dll","libstdc++-6.dll")|ForEach-Object{Copy-Item"$mingwPath\$_""dist/windows-amd64\"-Force}

五、 验证与运行

5.1 构建产物目录结构

成功编译后，dist/windows-amd64应包含：

dist/windows-amd64/ ├── ollama.exe ├── libwinpthread-1.dll ├── libgcc_s_seh-1.dll ├── libstdc++-6.dll ├── BUILD_INFO.txt # 构建报告 └── lib/ollama/ └── rocm_v7_1/ ├── ggml-hip.dll # HIP 计算后端 (~600MB) ├── amdhip64_7.dll ├── hipblas.dll └── rocblas.dll

5.2 启动与 GPU 加速验证

cd dist\windows-amd64.\ollama.exe serve

观察启动日志，出现"HIP backend"或"GPU: AMD Radeon RX..."表示 GPU 已被正确识别。

在另一个终端测试：

.\ollama.exe pull llama3.2:1b.\ollama.exe run llama3.2:1b

同时打开任务管理器 → 性能 → GPU 观察 3D 占用是否明显上升。

六、 深度排错与 FAQ

6.1 编译阶段常见错误

6.2 运行时常见错误

6.3 环境变量速查表

七、 总结与最佳实践

1. 版本对齐：构建前确认 Ollama 版本与仓库兼容，-Version参数能帮你精准控制，避免混用不同版本的 tag。
2. 架构最小集：修改脚本中的$GPUTargets，只编译你显卡对应的架构，可节省 60% 以上的编译时间。
3. 纯净环境：每次构建建议新开 PowerShell 窗口，防止残留环境变量干扰 CMake 检测。
4. 失败重试：脚本会自动生成带时间戳的独立构建目录，即使中途失败，直接重跑即可，无需手动清理。
5. 保留构建报告：BUILD_INFO.txt记录了版本、架构和编译时间，建议与二进制一起归档，方便回溯。

随着 ROCm 对 Windows 的支持日趋成熟，AMD 显卡在本地大模型推理上的表现越来越值得信赖。配合tengfei527/ollama-for-amd-auto-build这一自动化仓库，你可以像使用 NVIDIA 平台一样，享受流畅的ollama run体验。

如果在升级或编译过程中遇到任何问题，欢迎在评论区交流，我会尽力帮你分析解决。也许下一次，我们可以聊聊如何在 Windows 上通过 WSL2 调用 Linux 版 ROCm 做开发，以及那些交叉编译的坑。

参考资料

• 一键编译脚本仓库
• AMD ROCm 7.1 安装指南
• GPU 架构查询工具 TechPowerUp