Windows CMD 多版本 CUDA & cuDNN 一键切换管理方案（完整实战指南）

PowerShell 版：

Windows 多版本 CUDA + cuDNN 环境配置完全指南

之前我分享过 PowerShell 版本的 Switch-CUDA 多版本切换方案。但实际开发中，很多场景必须在 CMD 窗口里工作——比如 VS 2022 Developer Command Prompt、Python venv 的 activate.bat、某些编译工具链等。本文记录如何将整套方案移植到 CMD，实现与 PowerShell 版完全一致的体验。

目录

Windows CMD 多版本 CUDA & cuDNN 一键切换管理方案（完整实战指南）

一、问题背景

二、方案设计

整体架构

设计要点

三、核心脚本详解

3.1 switch-cuda.bat

3.2 verify-cuda.bat

3.3 cmd-init.bat（CMD 的 profile）

四、CMD 与 PowerShell 的踩坑对比

五、部署步骤

5.1 前提条件

5.2 放置文件

5.3 注册 AutoRun

5.4 验证

六、实际使用效果

七、卸载方法

八、总结

---

---

---

---

一、问题背景

在 Windows 上同时安装多个 CUDA 版本（如 12.6、12.8、12.9、13.0、13.1）并搭配各自的 cuDNN 是 AI 开发的常见需求。不同的项目依赖不同的 CUDA 版本：

以下示例来自部分实践

• ComfyUI + PyTorch 2.7.1 需要 CUDA 12.6
• FaceFusion / onnxruntime-gpu 需要 CUDA 12.9
• 最新模型编译可能需要 CUDA 13.x

PowerShell 版本：

Windows 多版本 CUDA + cuDNN 环境配置完全指南

PowerShell 版本通过 profile 中定义 Switch-CUDA 函数，可以一条命令完成切换。但在 CMD 窗口中，这套方案完全失效——CMD 没有 profile 函数机制，PATH 中也不一定包含脚本目录。

---

---

---

二、方案设计

整体架构

D:\Program\
├── switch-cuda.bat      # 核心：切换 CUDA 版本
├── verify-cuda.bat       # 辅助：验证环境完整性
├── cmd-init.bat          # CMD 的 "profile"：定义快捷命令
├── switch-cuda.ps1       # (已有) PowerShell 版
└── verify-cuda.ps1       # (已有) PowerShell 版

---

---

设计要点

1. 环境变量管理

切换时需要同时修改以下变量，编译工具链才能正确找到 CUDA：

变量	用途
CUDA_HOME	CMake / setuptools 查找 CUDA
CUDA_PATH	NVIDIA 官方约定
CUDA_ROOT	部分旧项目使用
CudaToolkitDir	Visual Studio MSBuild 使用
CUDNN_PATH	cuDNN 头文件和库的位置
PATH	确保 nvcc 指向正确版本

---

2. cuDNN 路径通过注册表管理

每个 CUDA 版本对应的 cuDNN 路径存储在系统环境变量中，命名规则为 cuDNN_PATH_V{版本号}，版本号中的 . 替换为 _。例如：

系统变量名	值（示例）
cuDNN_PATH_V12_6	C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.6\bin
cuDNN_PATH_V12_8	C:\Program Files\NVIDIA\CUDNN\v9.8\bin\12.8
cuDNN_PATH_V13_1	C:\Program Files\NVIDIA\CUDNN\v9.17\bin\13.1

脚本通过 reg query 读取这些注册表值，而不是硬编码路径，这样新增 CUDA 版本时只需添加一个系统变量即可。

---

3. PATH 过滤

切换版本时，必须先清除 PATH 中所有旧的 CUDA/cuDNN 路径，再插入新版本的路径到最前面。否则 where nvcc 会找到多个版本，编译时可能链接到错误的库。

---

4. doskey 宏实现快捷调用

CMD 没有 profile 函数，但通过注册表 AutoRun 项可以让每个 CMD 窗口启动时自动执行一个初始化脚本，在其中用 doskey 定义宏命令，效果等同于 PowerShell 的 profile 函数。

---

---

---

三、核心脚本详解

3.1 switch-cuda.bat

@echo off
chcp 65001 >nul 2>&1
setlocal EnableDelayedExpansion

set "VER=%~1"
if "!VER!"=="" (
    echo Usage: switch-cuda.bat ^<version^>
    echo Available: 12.6, 12.8, 12.9, 13.0, 13.1
    goto :End
)

set "VALID="
for %%v in (12.6 12.8 12.9 13.0 13.1) do if "!VER!"=="%%v" set "VALID=1"
if not defined VALID (
    echo [ERROR] Invalid version: !VER!
    goto :End
)

set "CUDA_BASE=C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v!VER!"
if not exist "!CUDA_BASE!\bin\nvcc.exe" (
    echo [ERROR] CUDA !VER! not installed: !CUDA_BASE!
    goto :End
)

REM -- 构造 cuDNN 注册表键名: cuDNN_PATH_V12_8
set "VER_U=!VER:.=_!"
set "VER_KEY=cuDNN_PATH_V!VER_U!"

REM -- 从注册表读取 cuDNN 路径
set "CUDNN_PATH="
for /f "tokens=2,*" %%a in ('reg query "HKLM\SYSTEM\...\Environment" /v "!VER_KEY!" 2^>nul ^| findstr /i "REG_"') do set "CUDNN_PATH=%%b"

if not defined CUDNN_PATH (
    echo [WARNING] System variable !VER_KEY! not found
    goto :End
)

REM -- 过滤 PATH 中旧的 CUDA/cuDNN 条目
set "NEW_PATH="
call :FilterPath

REM -- 组装新 PATH（新版本在最前面）
set "FINAL_PATH=!CUDA_BIN!;!CUDA_BIN_X64!;!CUDNN_PATH!;!NEW_PATH!"

REM -- 用 endlocal 技巧将变量导出到父环境
endlocal & (
    set "CUDA_HOME=%CUDA_BASE%"
    set "CUDA_PATH=%CUDA_BASE%"
    set "CUDA_ROOT=%CUDA_BASE%"
    set "CudaToolkitDir=%CUDA_BASE%\"
    set "CUDNN_PATH=%CUDNN_PATH%"
    set "PATH=%FINAL_PATH%"
)

---

关键技术点：

• 延迟展开 !var!：CMD 默认在解析阶段就展开 %var%，遇到含空格的路径（如 C:\Program Files\...）会断裂。setlocal EnableDelayedExpansion + !var! 让变量在执行阶段才展开，避免空格问题。

• endlocal & 导出技巧：setlocal 创建的局部变量会在 endlocal 时销毁。但 endlocal & set "VAR=%VAR%" 这个写法会在 endlocal 执行前先展开 %VAR%，再在父环境中 set，从而实现变量导出。

• PATH 过滤用 findstr /c:"完整字符串"：/c: 参数让 findstr 把整个字符串当作搜索目标，避免空格被拆分成多个关键词。配合 && 短路跳转，比在 if 括号块里操作安全得多。

switch-cuda.bat 完整示例脚本：

@echo off
chcp 65001 >nul 2>&1
setlocal EnableDelayedExpansion

REM ============================================================
REM  switch-cuda.bat  -  CMD CUDA version switcher
REM  Put in D:\Program\ (already in PATH) or call with full path
REM  Usage:  switch-cuda.bat 12.8
REM ============================================================

set "VER=%~1"
if "!VER!"=="" (
    echo Usage: switch-cuda.bat ^<version^>
    echo Available: 12.6, 12.8, 12.9, 13.0, 13.1
    goto :End
)

set "VALID="
for %%v in (12.6 12.8 12.9 13.0 13.1) do if "!VER!"=="%%v" set "VALID=1"
if not defined VALID (
    echo [ERROR] Invalid version: !VER!
    goto :End
)

set "CUDA_BASE=C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v!VER!"
if not exist "!CUDA_BASE!\bin\nvcc.exe" (
    echo [ERROR] CUDA !VER! not installed: !CUDA_BASE!
    goto :End
)

REM -- cuDNN registry key: cuDNN_PATH_V12_8
set "VER_U=!VER:.=_!"
set "VER_KEY=cuDNN_PATH_V!VER_U!"

set "CUDNN_PATH="
for /f "tokens=2,*" %%a in ('reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v "!VER_KEY!" 2^>nul ^| findstr /i "REG_"') do set "CUDNN_PATH=%%b"
if not defined CUDNN_PATH (
    echo [WARNING] System variable !VER_KEY! not found
    goto :End
)

REM -- Filter old CUDA/cuDNN entries from PATH
set "NEW_PATH="
call :FilterPath

set "CUDA_BIN=!CUDA_BASE!\bin"
set "CUDA_BIN_X64=!CUDA_BASE!\bin\x64"
set "FINAL_PATH=!CUDA_BIN!;!CUDA_BIN_X64!;!CUDNN_PATH!;!NEW_PATH!"

REM -- Export out of setlocal
endlocal & (
    set "CUDA_HOME=%CUDA_BASE%"
    set "CUDA_PATH=%CUDA_BASE%"
    set "CUDA_ROOT=%CUDA_BASE%"
    set "CudaToolkitDir=%CUDA_BASE%\"
    set "CUDNN_PATH=%CUDNN_PATH%"
    set "PATH=%FINAL_PATH%"
)

echo.
echo [OK] Switched to CUDA %~1
echo    CUDA     : %CUDA_HOME%
echo    CUDA x64 : %CUDA_HOME%\bin\x64
echo    cuDNN    : %CUDNN_PATH%
echo.
nvcc --version 2>nul | findstr "release"
goto :eof

REM ============================================================
:FilterPath
set "_R=!PATH!"
:_FL
if not defined _R goto :eof
for /f "tokens=1,* delims=;" %%a in ("!_R!") do (
    set "_E=%%a"
    set "_R=%%b"
)
if not defined _E goto :_FL
set "_SKIP="
echo !_E! | findstr /i /c:"NVIDIA GPU Computing Toolkit" >nul 2>&1 && set "_SKIP=1"
echo !_E! | findstr /i /c:"NVIDIA\CUDNN" >nul 2>&1 && set "_SKIP=1"
if defined _SKIP goto :_FL
if defined NEW_PATH (set "NEW_PATH=!NEW_PATH!;!_E!") else (set "NEW_PATH=!_E!")
goto :_FL

:End
endlocal

---

---

3.2 verify-cuda.bat

验证脚本检查 5 项内容：

1. CUDA 版本：逐个检查 nvcc.exe 是否存在并输出版本号
2. cuDNN 完整性：检查每个 CUDA 版本对应的 cuDNN 的 bin/ 和 include/ 目录是否都存在，统计 DLL 数量
3. 异常检测：查找 bin/ 存在但 include/ 缺失的情况（常见于手动安装不完整）
4. 关键环境变量：从注册表读取系统级 CUDA_PATH
5. PATH 中的 nvcc 顺序：显示 where nvcc 的结果，确认优先级正确

处理含空格路径执行的技巧：

REM 错误写法 —— CMD 会把引号路径当文件名
for /f "tokens=*" %%o in ('"!_NVCC!" --version') do ...

REM 正确写法 —— 用 cmd /c 包一层
for /f "tokens=*" %%o in ('cmd /c ""!_NVCC!" --version" 2^>nul ^| findstr "release"') do ...

for /f 在执行命令时，如果整个命令字符串以引号开头，CMD 会尝试把它当作文件名打开。用 cmd /c 启动子进程来执行，就绕过了这个解析问题。

verify-cuda.bat 完整示例脚本：

@echo off
chcp 65001 >nul 2>&1
setlocal EnableDelayedExpansion

REM ============================================================
REM  verify-cuda.bat  -  CUDA/cuDNN environment verification
REM  Usage:  verify-cuda.bat
REM ============================================================

set "CUDA_ROOT=C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA"
set "CUDNN_ROOT=C:\Program Files\NVIDIA\CUDNN"

REM ===== 1. CUDA versions =====
echo.
echo ===== CUDA version check =====
for %%v in (v12.6 v12.8 v12.9 v13.0 v13.1) do call :CheckCuda %%v
goto :Sec2

:CheckCuda
set "_NVCC=!CUDA_ROOT!\%1\bin\nvcc.exe"
if not exist "!_NVCC!" (
    echo   [FAIL] CUDA %1 : nvcc not found
    goto :eof
)
REM use cmd /c to safely execute path with spaces
for /f "tokens=*" %%o in ('cmd /c ""!_NVCC!" --version" 2^>nul ^| findstr "release"') do echo   [OK] CUDA %1 : %%o
goto :eof

REM ===== 2. cuDNN completeness =====
:Sec2
echo.
echo ===== cuDNN completeness check =====

REM -- Embedded cuDNN 8.x in v12.6
set "_BOK=0"
set "_IOK=0"
if exist "!CUDA_ROOT!\v12.6\bin\cudnn64_8.dll" set "_BOK=1"
if exist "!CUDA_ROOT!\v12.6\include\cudnn.h" set "_IOK=1"
if "!_BOK!"=="1" if "!_IOK!"=="1" (
    echo   [OK] cuDNN 8.x - v12.6 embedded - bin + include OK
) else (
    echo   [FAIL] cuDNN 8.x - v12.6 embedded - incomplete
)

call :CheckCudnn 12.8 v9.8
call :CheckCudnn 12.9 v9.17
call :CheckCudnn 13.0 v9.14
call :CheckCudnn 13.1 v9.17
goto :Sec3

:CheckCudnn
set "_CV=%~1"
set "_DV=%~2"
set "_BOK=0"
set "_IOK=0"
set "_DC=0"
if exist "!CUDNN_ROOT!\!_DV!\bin\!_CV!" set "_BOK=1"
if exist "!CUDNN_ROOT!\!_DV!\include\!_CV!" set "_IOK=1"
if "!_BOK!"=="1" (
    for %%f in ("!CUDNN_ROOT!\!_DV!\bin\!_CV!\cudnn*.dll") do set /a _DC+=1
)
if "!_BOK!"=="1" if "!_IOK!"=="1" (
    echo   [OK] CUDA !_CV! = cuDNN !_DV! : bin[!_DC! dll] + include OK
    goto :eof
)
set "_MSG="
if "!_BOK!"=="0" set "_MSG=!_MSG!bin missing "
if "!_IOK!"=="0" set "_MSG=!_MSG!include missing"
echo   [FAIL] CUDA !_CV! = cuDNN !_DV! : !_MSG!
goto :eof

REM ===== 3. Anomaly detection =====
:Sec3
echo.
echo ===== Anomaly detection =====
set "_FOUND=0"
if exist "!CUDNN_ROOT!" (
    for /d %%d in ("!CUDNN_ROOT!\*") do (
        if exist "%%d\bin" (
            for /d %%s in ("%%d\bin\*") do (
                set "_DN=%%~nxd"
                set "_SN=%%~nxs"
                if exist "%%d\bin\!_SN!" if not exist "%%d\include\!_SN!" (
                    echo   [WARN] cuDNN !_DN!\bin\!_SN! exists but include\!_SN! missing
                    set "_FOUND=1"
                )
            )
        )
    )
)
if "!_FOUND!"=="0" echo   [OK] No anomalies

REM ===== 4. Key environment variables =====
echo.
echo ===== Key environment variables =====
for /f "tokens=2,*" %%a in ('reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v "CUDA_PATH" 2^>nul ^| findstr /i "REG_"') do echo   CUDA_PATH = %%b

REM ===== 5. nvcc in PATH =====
echo.
echo ===== nvcc in PATH =====
where nvcc 2>nul
if errorlevel 1 echo   [WARN] nvcc not found in PATH

echo.
endlocal

---

---

3.3 cmd-init.bat（CMD 的 profile）

@echo off
doskey switch-cuda="D:\Program\switch-cuda.bat" $*
doskey verify-cuda="D:\Program\verify-cuda.bat" $*

doskey 定义的宏在当前 CMD 会话中生效，$* 表示传递所有参数。通过注册表 AutoRun 让每个 CMD 窗口启动时自动加载：

HKCU\Software\Microsoft\Command Processor\AutoRun = "D:\Program\cmd-init.bat"

cmd-init.bat 完整示例脚本：

@echo off
REM ============================================================
REM  cmd-init.bat  -  CMD autorun script (like PS profile)
REM  Location: D:\Program\cmd-init.bat
REM  
REM  This script runs automatically every time a CMD window opens.
REM  It defines doskey macros so you can type:
REM    switch-cuda 12.6
REM    verify-cuda
REM  from anywhere, just like PowerShell.
REM ============================================================

doskey switch-cuda="D:\Program\switch-cuda.bat" $*
doskey verify-cuda="D:\Program\verify-cuda.bat" $*

REM Add more macros below as needed:
REM doskey ll=dir /a $*

---

---

---

四、CMD 与 PowerShell 的踩坑对比

坑点	PowerShell	CMD
路径含空格	引号包裹即可	!var! 延迟展开 + cmd /c 双层引号
读系统变量	[Environment]::GetEnvironmentVariable()	reg query HKLM\...\Environment
PATH 过滤	-notmatch 正则	findstr /c: + && 短路跳转
括号块中的冒号	无影响	: 被误解析为 label，需要规避
括号块中的特殊字符	自动转义	&、(、) 必须 ^ 转义或避免在括号内
快捷命令	profile 定义函数	AutoRun + doskey 宏
作用域导出	无需（函数直接修改会话）	endlocal & set 技巧

---

---

---

五、部署步骤

5.1 前提条件

确保系统环境变量中已配置好每个 CUDA 版本对应的 cuDNN 路径变量。在 PowerShell 中检查：

[Environment]::GetEnvironmentVariable('cuDNN_PATH_V12_6', 'Machine')
[Environment]::GetEnvironmentVariable('cuDNN_PATH_V12_8', 'Machine')
# ... 其他版本

---

---

5.2 放置文件

将以下文件放入 D:\Program\（或你偏好的脚本目录）：

switch-cuda.bat
verify-cuda.bat
cmd-init.bat

---

---

5.3 注册 AutoRun

方法一（推荐）：运行 setup-cmd-init.bat 一键注册

setup-cmd-init.bat 完整示例脚本：

@echo off
chcp 65001 >nul 2>&1
REM ============================================================
REM  setup-cmd-init.bat  -  Register cmd-init.bat as CMD AutoRun
REM  Run once with admin privileges (right-click -> Run as admin)
REM ============================================================

set "INIT_PATH=D:\Program\cmd-init.bat"

if not exist "%INIT_PATH%" (
    echo [ERROR] %INIT_PATH% not found. Please copy cmd-init.bat to D:\Program\ first.
    pause
    exit /b 1
)

REM Register for current user (HKCU, no admin needed)
reg add "HKCU\Software\Microsoft\Command Processor" /v AutoRun /t REG_SZ /d "\"%INIT_PATH%\"" /f

if errorlevel 1 (
    echo [ERROR] Failed to set registry key.
    pause
    exit /b 1
)

echo.
echo [OK] CMD AutoRun registered successfully!
echo     Key  : HKCU\Software\Microsoft\Command Processor\AutoRun
echo     Value: "%INIT_PATH%"
echo.
echo Now every new CMD window will auto-load switch-cuda / verify-cuda macros.
echo Re-open your CMD window to take effect.
echo.
pause

方法二（手动）：在 CMD 中执行：

reg add "HKCU\Software\Microsoft\Command Processor" /v AutoRun /t REG_SZ /d "\"D:\Program\cmd-init.bat\"" /f

---

---

5.4 验证

重新打开一个 CMD 窗口：

verify-cuda
switch-cuda 12.6
nvcc --version

---

---

---

六、实际使用效果

(.venv) J:\PythonProjects4\FaceLift> switch-cuda 12.6

[OK] Switched to CUDA 12.6
   CUDA     : C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.6
   CUDA x64 : C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.6\bin\x64
   cuDNN    : C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.6\bin
Cuda compilation tools, release 12.6, V12.6.85

(.venv) J:\PythonProjects4\FaceLift> verify-cuda

===== CUDA version check =====
  [OK] CUDA v12.6 : Cuda compilation tools, release 12.6, V12.6.85
  [OK] CUDA v12.8 : Cuda compilation tools, release 12.8, V12.8.93
  [OK] CUDA v12.9 : Cuda compilation tools, release 12.9, V12.9.41
  [OK] CUDA v13.0 : Cuda compilation tools, release 13.0, V13.0.88
  [OK] CUDA v13.1 : Cuda compilation tools, release 13.1, V13.1.80
===== cuDNN completeness check =====
  [OK] cuDNN 8.x - v12.6 embedded - bin + include OK
  [OK] CUDA 12.8 = cuDNN v9.8 : bin[8 dll] + include OK
  [OK] CUDA 12.9 = cuDNN v9.17 : bin[8 dll] + include OK
  [OK] CUDA 13.0 = cuDNN v9.14 : bin[8 dll] + include OK
  [OK] CUDA 13.1 = cuDNN v9.17 : bin[8 dll] + include OK
===== Anomaly detection =====
  [OK] No anomalies
===== Key environment variables =====
  CUDA_PATH = C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v13.1
===== nvcc in PATH =====
C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.6\bin\nvcc.exe

切换后 PATH 中只保留目标版本的 nvcc，其他版本的路径被干净地移除。

---

---

---

七、卸载方法

如需移除 AutoRun 注册：

reg delete "HKCU\Software\Microsoft\Command Processor" /v AutoRun /f

---

---

---

八、总结

维度	说明
兼容性	CMD / VS Developer Command Prompt / venv 环境均可使用
一致性	与 PowerShell 版行为完全一致，同一目录共存
可扩展	新增 CUDA 版本只需：添加系统变量 + 修改脚本中的版本列表
便捷性	通过 doskey 宏实现零路径依赖的快捷调用

CMD 的 batch 脚本语法比 PowerShell 繁琐得多，尤其是处理含空格路径和特殊字符时陷阱密布。核心经验是：用 goto + call :label 替代括号块，用 !var! 延迟展开替代 %var%，用 cmd /c 包裹含空格路径的命令执行。掌握这三点，大部分 PS → CMD 的移植就能顺利完成。