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

文章目录

[Windows 平台 Ollama AMD GPU 一键编译指南：基于 ROCm 7.1 的自动化实战](#Windows 平台 Ollama AMD GPU 一键编译指南：基于 ROCm 7.1 的自动化实战)
- 引言：从手动编译到一条命令
- [一、为什么选择 ROCm 7.1？](#一、为什么选择 ROCm 7.1？)
- [二、环境准备与硬件兼容性](#二、环境准备与硬件兼容性)
- - [2.1 你的 AMD 显卡能被支持吗？](#2.1 你的 AMD 显卡能被支持吗？)
  - [2.2 软件依赖一览](#2.2 软件依赖一览)
- [三、一键脚本：`auto_build.ps1` 完全指南](#三、一键脚本：auto_build.ps1 完全指南)
- - [3.1 快速开始](#3.1 快速开始)
  - [3.2 自动化流程全景图](#3.2 自动化流程全景图)
  - [3.3 关键设计解读](#3.3 关键设计解读)
- [四、手动分步构建（供调试参考）](#四、手动分步构建（供调试参考）)
- - [4.1 源码准备与上游合并](#4.1 源码准备与上游合并)
  - [4.2 编译 ROCm 后端（ggml-hip.dll）](#4.2 编译 ROCm 后端（ggml-hip.dll）)
  - [4.3 编译 Ollama 主程序（ollama.exe）](#4.3 编译 Ollama 主程序（ollama.exe）)
- [五、验证与运行](#五、验证与运行)
- - [5.1 构建产物目录结构](#5.1 构建产物目录结构)
  - [5.2 启动与 GPU 加速验证](#5.2 启动与 GPU 加速验证)
- [六、深度排错与 FAQ](#六、深度排错与 FAQ)
- - [6.1 编译阶段常见错误](#6.1 编译阶段常见错误)
  - [6.2 运行时常见错误](#6.2 运行时常见错误)
  - [6.3 环境变量速查表](#6.3 环境变量速查表)
- [七、总结与最佳实践](#七、总结与最佳实践)

一、为什么选择 ROCm 7.1？

特性	ROCm 6.2	ROCm 7.1
新架构支持	无 RDNA 3.5 / 4	增加 gfx1150 系列（RX 7600 XT 等）
Windows 构建稳定性	需要手动规避 `__builtin_verbose_trap` 等兼容问题	与 VS BuildTools 配合更顺畅
CMake 预设	`ROCm 6`	`rocm_v7_1_windows`（开箱即用）
HIP 编译器优化	基本支持	并行编译效率更高，内存占用更低

如果你用的是 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 官方支持的主流架构及对应显卡：

架构代号	GPU 系列	典型显卡型号	ROCm 7.1 支持
gfx1100	RDNA 3	RX 7900 XTX / XT	✅
gfx1102	RDNA 3	RX 7800 XT / 7700 XT	✅
gfx1030	RDNA 2	RX 6900 XT / 6800 XT	✅
gfx1032	RDNA 2	RX 6600 XT	✅
gfx1010	RDNA 1	RX 5700 XT	✅
gfx906	GCN (Vega)	Radeon VII	✅
gfx1152	RDNA 3.5	RX 7600 XT	✅ (新增)
gfx1151	RDNA 3.5	RX 7700S / 7600M XT	✅ (实验性)
gfx1200	RDNA 4	尚未上市	❌

图1：GPU 架构判断流程

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

2.2 软件依赖一览

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

软件	最低版本	作用	推荐安装方式
Visual Studio 2022 BuildTools	最新	提供 MSVC 编译器与 Ninja	`winget install Microsoft.VisualStudio.2022.BuildTools`
CMake	4.0+	生成构建系统	`winget install Kitware.CMake`
Go	1.24+	编译 Ollama 主程序	`winget install GoLang.Go`
AMD ROCm	7.1	HIP 运行时与编译器	AMD 官网下载
MSYS2 (MinGW-w64)	最新	GCC 工具链，供 CGO 使用	`winget install MSYS2.MSYS2`

安装后快速验证：

powershell 复制代码

cmake --version   # 应显示 4.x
go 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 快速开始

powershell 复制代码

# 克隆一键脚本仓库
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

参数详解：

参数	说明	示例
`-Version`	(必填) 要编译的 Ollama 版本号	`-Version 0.20.6`
`-SkipMerge`	跳过合并上游源码，本地已有代码时使用	`-SkipMerge`
`-SkipROCm`	跳过 ROCm 后端编译，仅更新 CLI	`-SkipROCm`
`-Jobs`	并行编译线程数，默认 6	`-Jobs 8`

常用场景举例：

powershell 复制代码

# 仅重新编译 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 自动化流程全景图

脚本内部的执行管线可概括为五个阶段，每个阶段都内置了错误检测与重试机制。
#mermaid-svg-hJn799k93iwjp7ZM{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-hJn799k93iwjp7ZM .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-hJn799k93iwjp7ZM .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-hJn799k93iwjp7ZM .error-icon{fill:#552222;}#mermaid-svg-hJn799k93iwjp7ZM .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-hJn799k93iwjp7ZM .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-hJn799k93iwjp7ZM .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-hJn799k93iwjp7ZM .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-hJn799k93iwjp7ZM .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-hJn799k93iwjp7ZM .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-hJn799k93iwjp7ZM .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-hJn799k93iwjp7ZM .marker{fill:#333333;stroke:#333333;}#mermaid-svg-hJn799k93iwjp7ZM .marker.cross{stroke:#333333;}#mermaid-svg-hJn799k93iwjp7ZM svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-hJn799k93iwjp7ZM p{margin:0;}#mermaid-svg-hJn799k93iwjp7ZM .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-hJn799k93iwjp7ZM .cluster-label text{fill:#333;}#mermaid-svg-hJn799k93iwjp7ZM .cluster-label span{color:#333;}#mermaid-svg-hJn799k93iwjp7ZM .cluster-label span p{background-color:transparent;}#mermaid-svg-hJn799k93iwjp7ZM .label text,#mermaid-svg-hJn799k93iwjp7ZM span{fill:#333;color:#333;}#mermaid-svg-hJn799k93iwjp7ZM .node rect,#mermaid-svg-hJn799k93iwjp7ZM .node circle,#mermaid-svg-hJn799k93iwjp7ZM .node ellipse,#mermaid-svg-hJn799k93iwjp7ZM .node polygon,#mermaid-svg-hJn799k93iwjp7ZM .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-hJn799k93iwjp7ZM .rough-node .label text,#mermaid-svg-hJn799k93iwjp7ZM .node .label text,#mermaid-svg-hJn799k93iwjp7ZM .image-shape .label,#mermaid-svg-hJn799k93iwjp7ZM .icon-shape .label{text-anchor:middle;}#mermaid-svg-hJn799k93iwjp7ZM .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-hJn799k93iwjp7ZM .rough-node .label,#mermaid-svg-hJn799k93iwjp7ZM .node .label,#mermaid-svg-hJn799k93iwjp7ZM .image-shape .label,#mermaid-svg-hJn799k93iwjp7ZM .icon-shape .label{text-align:center;}#mermaid-svg-hJn799k93iwjp7ZM .node.clickable{cursor:pointer;}#mermaid-svg-hJn799k93iwjp7ZM .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-hJn799k93iwjp7ZM .arrowheadPath{fill:#333333;}#mermaid-svg-hJn799k93iwjp7ZM .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-hJn799k93iwjp7ZM .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-hJn799k93iwjp7ZM .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-hJn799k93iwjp7ZM .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-hJn799k93iwjp7ZM .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-hJn799k93iwjp7ZM .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-hJn799k93iwjp7ZM .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-hJn799k93iwjp7ZM .cluster text{fill:#333;}#mermaid-svg-hJn799k93iwjp7ZM .cluster span{color:#333;}#mermaid-svg-hJn799k93iwjp7ZM div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-hJn799k93iwjp7ZM .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-hJn799k93iwjp7ZM rect.text{fill:none;stroke-width:0;}#mermaid-svg-hJn799k93iwjp7ZM .icon-shape,#mermaid-svg-hJn799k93iwjp7ZM .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-hJn799k93iwjp7ZM .icon-shape p,#mermaid-svg-hJn799k93iwjp7ZM .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-hJn799k93iwjp7ZM .icon-shape .label rect,#mermaid-svg-hJn799k93iwjp7ZM .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-hJn799k93iwjp7ZM .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-hJn799k93iwjp7ZM .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-hJn799k93iwjp7ZM :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 否
是
否
是
否
解析参数
激活 VS BuildTools 环境
跳过合并?
添加 upstream 远程仓库
git fetch --tags
git merge 目标版本
跳过 ROCm?
设置 ROCm 7.1 环境变量
CMake 配置

--preset rocm_v7_1_windows
Ninja 编译 ggml-hip.dll
安装到 dist/windows-amd64
跳过 CLI?
设置 MinGW GCC 环境
go build ollama.exe
拷贝 MinGW 运行时 DLL
生成 BUILD_INFO.txt
构建完成

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 源码准备与上游合并

powershell 复制代码

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 编译环境

powershell 复制代码

$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 环境变量

powershell 复制代码

$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 配置、编译与安装

powershell 复制代码

$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 --parallel 6
cmake --install build/rocm --component llama-server --prefix "dist/windows-amd64" --strip

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

powershell 复制代码

$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-Item ollama.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 加速验证

powershell 复制代码

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

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

在另一个终端测试：

powershell 复制代码

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

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

六、深度排错与 FAQ

6.1 编译阶段常见错误

症状	原因	解决
`hipcc: error: invalid target ID 'gfx1152'`	该架构在 ROCm 7.1 中仍为实验性	改用 `gfx1151` 或精确指定你显卡的架构
`CMake Error: Could not find a HIP compiler`	环境变量未生效	显式指定 `-DCMAKE_HIP_COMPILER="C:/Program Files/AMD/ROCm/7.1/bin/hipcc.bin.exe"`
`clang++: error: use of undeclared identifier '__builtin_verbose_trap'`	使用了 VS 非 BuildTools 版本	安装 Visual Studio 2022 BuildTools，而非 Enterprise/Preview
构建过程中 `ninja` 报内存不足	并行线程太多	减小 `-Jobs`，如 `-Jobs 4`

6.2 运行时常见错误

症状	原因	解决
`ggml_hip_init: HIP library not found`	ROCm 运行时 DLL 缺失	将 `C:\Program Files\AMD\ROCm\7.1\bin` 加入系统 PATH，或复制所需 DLL 到 ollama.exe 目录
`no GPU detected` 但任务管理器显示 GPU	架构不匹配	设置环境变量 `$env:HSA_OVERRIDE_GFX_VERSION="10.3.0"`（数值按你的架构修改）
加载模型到一半崩溃	显存不足	换用 1B/3B 小模型，或降低上下文长度

6.3 环境变量速查表

变量	作用	典型值
`HIP_PATH`	ROCm SDK 根目录	`C:\Program Files\AMD\ROCm\7.1`
`HSA_OVERRIDE_GFX_VERSION`	强制覆盖 GPU 架构版本	`10.3.0`（对应 gfx1030）
`HIP_VISIBLE_DEVICES`	限定使用哪块 GPU	`0`
`CGO_ENABLED`	启用 Go 的 CGO	`1`
`CC` / `CXX`	C/C++ 编译器	`gcc` / `g++`

七、总结与最佳实践

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

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

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

参考资料

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