ZLUDA 3步上手让AMD显卡跑起来CUDA程序不用改一行代码【免费下载链接】ZLUDACUDA on non-NVIDIA GPUs项目地址: https://gitcode.com/GitHub_Trending/zl/ZLUDAZLUDA一个运行在 AMD GPU 上的 CUDA 兼容层用替代实现顶替 NVIDIA 驱动 API能让未经修改的 CUDA 程序直接跑在 AMD Radeon 显卡上。这篇教程面向持有 AMD 显卡、手上有 CUDA 程序想跑起来的 Windows 或 Linux 用户从获取到验证成功三步跑通不折腾源码。 项目定位ZLUDA是什么ZLUDA 是 NVIDIA CUDA 驱动的替代实现程序以为自己在调nvcuda.dll实际每个调用都被翻译成 AMD HIP 运行时AMD 的 GPU 编程工具包上的等价操作cuBLAS、cuDNN 这类性能库也一并映射过去。类比一下它相当于给应用装了一个翻译驱动应用不用改显卡换成 AMD 照样干活。️ 支持矩阵先确认你的显卡和系统跑之前先对号入座。ZLUDA 目前只支持 AMD GPU且只支持 RDNA 架构RX 5000 系起Intel 显卡曾有后端、目前暂停macOS 不支持。显卡 / 平台驱动与前置条件支持状态AMD Radeon RX 5000 系及更新RDNA / RDNA2 / RDNA3桌面与集显WindowsAMD 显卡驱动Adrenalin Edition HIP SDKLinuxROCm / HIP 运行时支持Intel Arc 等 Intel 显卡—当前不支持后端暂停可能恢复macOS—不支持PolarisRX 400/500 系、Vega 及服务器级 GPU—不支持 从 0 到跑通三步部署第一步获取 ZLUDAZLUDA 迭代很快直接用最新的 pre-release 包发布页上被标为 stable 的也可以想自己构建再走源码路线。推荐从 ZLUDA 的 Releases 下载 pre-release 包解压后得到zluda/或target\release\目录里面就是nvcuda.dll、libcuda.so等组件。源码构建需要 CMake、Python 3、Rust 与 C 编译器Linux 另需装好 HIPgit clone --recursive https://gitcode.com/GitHub_Trending/zl/ZLUDA cd ZLUDA cargo xtask --release第二步Windows下的zluda.exe启动器方式Windows 上 ZLUDA 自带nvcuda.dll应用会优先加载它。推荐用启动器cd ZLUDA目录 zluda.exe -- 你的程序 [参数]如果应用按固定路径找驱动把 ZLUDA 文件含nvcuda.dll整个复制到应用.exe所在目录同样生效。Steam 游戏可以在该游戏的启动选项里填zluda.exe -- %command%达到同样效果第三步Linux下的libcuda.so替换方式Linux 上 ZLUDA 提供libcuda.so通过动态链接路径让它优先于系统库被加载。推荐写法ZLUDA目录即含libcuda.so的zluda/或target/releaseLD_LIBRARY_PATHZLUDA目录:$LD_LIBRARY_PATH 你的程序 [参数]备选写法用LD_AUDIT指向zluda_ld库效果相同。预期程序正常启动而不是立刻报找不到libcuda.so。✅ 确认ZLUDA安装成功的信号看到cuda_check逐行全 OK → 说明 nvcuda 与 cuBLAS、cuDNN 等性能库全部映射到 HIP SDK 成功。ZLUDA 自带验证小程序Windows 上运行zluda.exe -- cuda_check.exe每行形如cublas12 : OK (C:\hip_sdk\bin\rocblas.dll)括号里是底层 HIP 库的实际路径。看到cuda_check偶发挂住不退出 → 已知是 MIOpen 的问题重跑一次即可。你的程序正常跑完、结果正确 → 说明 PTX 编译PTX 是 NVIDIA 的 GPU 中间汇编、kernel 启动、结果回读整条链路已走通。️ 出错了先看这里libcuda.so not found或找不到nvcuda.dll→ 加载路径没指到 ZLUDA。Windows 上把文件复制到应用.exe目录Linux 上确认LD_LIBRARY_PATH或LD_AUDIT指向含libcuda.so的 ZLUDA 目录。cuda_check里cudnn8/9失败、其余 OK → Windows 官方 HIP SDK 安装器不带 MIOpen。换 AMD 的 nightly 构建下载匹配你显卡 Shader ISA 的therock-dist-windows-gfx*包解压后把HIP_PATH指向该目录目录内需有含rocblas.dll的bin子目录。首次启动极慢甚至像卡死 → ZLUDA 在运行时即时编译 PTX大应用首次编译量大。可提前跑zluda_precompile PATH扫描并预编译进缓存是否更快视应用体积和硬件而定。NVIDIA 卡能跑、AMD 上报错 → 用带日志的模式跑一遍定位失败调用Windows 下zluda.exe --zluda-trace -- 程序日志落在%TEMP%\zluda参考上面 Steam 截图启动选项加--zluda-trace即可再看日志里的 CUDA 错误码。ZLUDA 处于快速迭代期未支持的 CUDA API 与 PTX 指令报错是常态报错时记下日志里的具体调用名。 继续深入官方文档在 docs/src/ 下quick_start.md 是本文的完整版hip_sdk.md 讲两种 HIP SDK 的取舍troubleshooting.md 逐字段解释追踪日志precompiling.md 讲预编译。想理解 ZLUDA 怎么把 CUDA 调用落到 AMD 硬件可以从 zluda/src/impl/ 的驱动实现读起PTX 编译器的行为在 ptx/test/ 下有两百多个测试用例可查。下一步动作挑一个你现在就能跑通的 CUDA 小程序比如 CUDA samples 里的 vectorAdd先按 Linux 或 Windows 一节跑一遍cuda_check再让它跑起来。【免费下载链接】ZLUDACUDA on non-NVIDIA GPUs项目地址: https://gitcode.com/GitHub_Trending/zl/ZLUDA创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考