幕雪

cuda怎么卸载：完整指南——从识别组件到彻底清除，Windows与Linux平台通用教程

在高性能计算和深度学习领域，NVIDIA CUDA是不可或缺的并行计算平台。然而，无论是出于升级版本、解决环境冲突，还是纯粹为了系统维护和空间释放，您可能需要将现有的CUDA环境彻底卸载。本篇文章将为您提供一份详尽的CUDA卸载指南，涵盖了从识别相关组件、理解卸载目的，到不同操作系统平台（Windows和Linux）的具体操作步骤，确保卸载过程的完整性和彻底性。

是什么？理解您要卸载的CUDA组件

在谈论“卸载CUDA”时，我们通常指的不仅仅是一个单一的程序，而是一个由多个相互关联的组件组成的生态系统。要彻底清除它，我们需要识别并处理这些关键部分：

  • CUDA Toolkit（CUDA开发工具包）：这是最核心的部分，包含了CUDA运行时库、开发工具（如编译器nvcc）、性能分析工具、CUDA样本以及文档。这是您主要安装和卸载的对象。
  • NVIDIA显示驱动程序（NVIDIA Display Driver）：这是NVIDIA显卡运行所必需的驱动，CUDA Toolkit需要特定版本的驱动才能正常工作。除非您是为了完全重置所有NVIDIA相关软件或遇到驱动本身的问题，否则通常无需卸载显示驱动。
  • cuDNN（CUDA Deep Neural Network Library）：这是一个用于深度神经网络的GPU加速库，它通常以独立的压缩包形式提供，需要手动解压并放置到CUDA Toolkit的特定目录，或者放置在系统可以访问的路径中。
  • TensorRT（Tensor Runtime）：这是NVIDIA用于高性能深度学习推理的SDK，也通常作为独立的库，需要与CUDA Toolkit和cuDNN协同工作。
  • 环境变量：为了让系统能够找到CUDA和其相关的工具，安装程序会在系统或用户环境中设置一系列路径，例如PATH、CUDA_PATH、CUDA_PATH_VXX_Y等。
  • 注册表条目（仅限Windows）：在Windows系统中，安装程序会在注册表中创建大量条目，用于记录安装信息、配置数据等。

为什么？何时需要卸载CUDA？

卸载CUDA通常是由以下几个常见场景驱动的：

  • 版本冲突与升级：

    当您需要安装新版本的CUDA Toolkit时（例如从CUDA 11.x升级到CUDA 12.x），为了避免新旧版本之间的潜在冲突，或者为了确保新版本的全新安装，彻底卸载旧版本是最佳实践。

  • 系统维护与空间释放：

    CUDA Toolkit及其相关组件可能会占用相当大的磁盘空间。如果您不再进行GPU计算开发，或者希望精简系统，卸载CUDA是释放宝贵存储空间的有效方法。

  • 问题排查与环境重置：

    如果您的CUDA开发环境出现异常、编译错误、运行时错误，或者其他难以解决的问题时，一个彻底的卸载并重新安装往往是解决问题的“万能药”。这确保了您拥有一个干净、一致的CUDA环境。

  • 不再需要：

    如果您已经完成了所有的GPU相关项目，或者决定转向其他计算平台，那么卸载CUDA是清理开发环境的自然选择。

哪里？CUDA组件的常见安装路径

了解CUDA组件的常见安装位置有助于您在卸载后手动检查和清理残留文件：

  • Windows 平台：

    • CUDA Toolkit：默认安装路径通常是C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\vX.Y（其中X.Y是版本号）。
    • 其他NVIDIA程序：如NVIDIA Nsight、PhysX等可能位于C:\Program Files (x86)\NVIDIA Corporation\或C:\Program Files\NVIDIA Corporation\。
    • 程序数据：一些隐藏的配置或样本文件可能在C:\ProgramData\NVIDIA Corporation\。
    • 用户数据：用户特定的配置或缓存可能在C:\Users\<您的用户名>\AppData\Local\NVIDIA\。
  • Linux 平台：

    • CUDA Toolkit：默认安装在/usr/local/cuda-X.Y目录下，并通常会创建一个名为/usr/local/cuda的软链接指向当前激活的CUDA版本。
    • 环境变量文件：通常会在~/.bashrc、~/.profile、/etc/profile.d/cuda.sh或系统的其他启动脚本中添加路径。
    • 库文件路径：可能在/etc/ld.so.conf.d/cuda.conf中配置。

如何彻底卸载CUDA？分平台详细步骤

卸载CUDA的步骤因操作系统而异。下面将详细介绍在Windows和Linux平台上的彻底卸载流程。

Windows 平台卸载流程

在Windows环境下，卸载CUDA主要通过控制面板进行，但为了彻底清除，还需要手动检查并删除残留文件和环境变量。

步骤一：通过控制面板卸载主要组件

这是卸载CUDA及其相关软件的第一步，也是最重要的一步。

  1. 打开“控制面板”：可以通过在开始菜单搜索“控制面板”来找到。
  2. 选择“程序” -> “程序和功能”（或“卸载程序”）。
  3. 在程序列表中，找到所有名称中包含“NVIDIA”的条目。您会看到类似以下的项目：
    • NVIDIA CUDA Toolkit X.Y（这是您需要首先卸载的核心组件）
    • NVIDIA Nsight X.Y
    • NVIDIA PhysX System Software（如果是由CUDA安装程序捆绑安装的，也可以考虑卸载）
    • NVIDIA Graphics Driver X.Y（重要提示：通常情况下，您无需卸载显卡驱动。除非您遇到严重的驱动问题或需要进行极其彻底的重置，否则保持驱动不变。卸载驱动可能会导致显示异常。）
    • NVIDIA HD Audio Driver
    • NVIDIA GeForce Experience
    • NVIDIA Display Container
    • NVIDIA Platform Controllers

  4. 卸载顺序建议： 为了避免依赖性问题，建议您按照以下顺序进行卸载：

    NVIDIA CUDA Toolkit X.Y → NVIDIA Nsight X.Y → 其他NVIDIA程序（如PhysX，非驱动部分）。

    驱动程序（NVIDIA Graphics Driver）通常不建议卸载，如果需要重装驱动，可以独立下载最新驱动并覆盖安装。

  5. 对每个要卸载的NVIDIA CUDA相关条目，右键点击，选择“卸载/更改”，然后按照屏幕上的指示完成卸载过程。

步骤二：手动清理残留文件和文件夹

控制面板的卸载程序有时不会完全清除所有文件，因此需要手动检查。

  1. 打开文件资源管理器。
  2. 导航到以下常见路径并删除所有NVIDIA CUDA相关的文件夹（如果它们仍然存在）：
    • C:\Program Files\NVIDIA GPU Computing Toolkit\
    • C:\ProgramData\NVIDIA Corporation\ (ProgramData是一个隐藏文件夹，您可能需要在文件资源管理器中启用“显示隐藏的项目”选项才能看到)
    • C:\Users\<您的用户名>\AppData\Local\NVIDIA\ (AppData也是隐藏文件夹)
    • C:\Program Files\NVIDIA Corporation\ (仅当您确定其中没有其他您需要的NVIDIA软件时)
  3. 检查桌面、开始菜单或任何常用位置是否有CUDA相关的快捷方式，并将其删除。
  4. 清空回收站。

步骤三：清理环境变量

删除旧版本CUDA相关的环境变量是确保新环境干净的关键。

  1. 右键点击“此电脑”（或“我的电脑”），选择“属性”。
  2. 点击“高级系统设置”。
  3. 在“系统属性”对话框中，点击“环境变量”按钮。
  4. 在“系统变量”和“用户变量”两个区域中，仔细查找并删除所有以下相关的变量：
    • CUDA_PATH
    • CUDA_PATH_VXX_Y (例如 CUDA_PATH_V11_7)
    • NVCUDASAMPLES_ROOT
    • NVCUDASAMPLESX_Y_ROOT
    • 在Path变量中，查找并删除所有指向CUDA安装目录（例如 C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\vX.Y\bin, C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\vX.Y\lib\x64）的路径。请务必小心，不要删除其他系统或应用的重要路径。
  5. 确认所有更改并关闭对话框。

步骤四：清理注册表（可选但推荐）

此步骤需要谨慎操作，错误的注册表修改可能导致系统问题。在进行此步骤之前，强烈建议您备份注册表。

  1. 按下Win + R，输入regedit，然后按回车键打开注册表编辑器。
  2. 在注册表编辑器中，导航到以下路径并删除任何NVIDIA CUDA相关的键和值：
    • HKEY_LOCAL_MACHINE\SOFTWARE\NVIDIA Corporation\：在这个目录下查找与CUDA Toolkit版本相关的子键并删除。
    • HKEY_CURRENT_USER\SOFTWARE\NVIDIA Corporation\：同样查找并删除相关子键。
  3. 您也可以尝试搜索“CUDA”，但请只删除那些您确定是旧的CUDA安装留下来的条目。
  4. 关闭注册表编辑器。

步骤五：重启系统

完成上述所有步骤后，重启您的计算机，以确保所有更改都已生效，并且所有锁定的文件都被释放。

Linux 平台卸载流程

在Linux上，CUDA的卸载方法取决于其安装方式（runfile安装器或deb/rpm包管理器）。

步骤一：卸载CUDA Toolkit

方法一：通过CUDA runfile 安装器卸载（推荐对于runfile安装）

如果您是使用NVIDIA提供的.run文件进行安装的，通常会有一个配套的卸载脚本。

  1. 打开终端。
  2. 导航到CUDA的安装目录（通常是/usr/local/cuda-X.Y/，或者直接使用软链接/usr/local/cuda/）。
  3. 执行卸载脚本： 
    sudo /usr/local/cuda-X.Y/bin/cuda-uninstaller

    或在某些旧版本中：

    sudo /usr/local/cuda/bin/uninstall_cuda_X.Y.pl

    （将X.Y替换为您的CUDA版本号，如果知道确切版本）

  4. 按照屏幕上的提示完成卸载。
方法二：通过包管理器卸载（推荐对于deb/rpm安装）

如果您是通过apt（Debian/Ubuntu）或yum/dnf（RHEL/CentOS/Fedora）安装的CUDA，可以使用包管理器卸载。

  • 对于Debian/Ubuntu系统：

    sudo apt-get --purge remove 'cuda*'

    此命令会尝试卸载所有与“cuda”相关的包，包括CUDA Toolkit、驱动（如果通过apt安装）等。如果您只希望卸载Toolkit，可以更精确地指定包名，例如cuda-toolkit-X-Y。

    sudo apt-get --purge remove cuda-toolkit-X-Y

    （将X-Y替换为您的CUDA版本，如cuda-toolkit-11-7）

    sudo apt-get autoremove

    清理不再需要的依赖。

  • 对于RHEL/CentOS系统：

    sudo yum remove 'cuda*'

    或更精确地：

    sudo yum remove cuda-toolkit-X-Y
    sudo yum autoremove
  • 对于Fedora系统：

    sudo dnf remove 'cuda*'

    或更精确地：

    sudo dnf remove cuda-toolkit-X-Y
    sudo dnf autoremove

步骤二：清理环境变量和软链接

即使卸载了程序，环境变量和软链接可能仍然存在，需要手动清理。

  1. 删除或修改环境变量：
    • 打开您的shell配置文件，例如~/.bashrc、~/.profile。
    • nano ~/.bashrc
    • 查找并删除或注释掉所有指向CUDA路径的行，例如： 
      export PATH="/usr/local/cuda/bin:$PATH"
      export LD_LIBRARY_PATH="/usr/local/cuda/lib64:$LD_LIBRARY_PATH"
    • 检查系统级的环境变量文件：/etc/profile、/etc/environment、/etc/profile.d/cuda.sh（如果存在）。删除或注释掉其中的CUDA相关路径。
    • 保存并关闭文件。
    • 刷新您的shell环境或重启终端： 
      source ~/.bashrc

      或

      source /etc/profile
  2. 删除CUDA软链接：

    如果存在指向特定CUDA版本的软链接/usr/local/cuda，请将其删除。

    sudo rm /usr/local/cuda

步骤三：手动删除残留目录

包管理器或卸载脚本可能不会完全清除所有目录，特别是对于runfile安装。

  1. 删除CUDA Toolkit的安装目录： 
    sudo rm -rf /usr/local/cuda-X.Y

    （请将X.Y替换为您卸载的CUDA版本号，例如cuda-11.7。如果/usr/local/cuda软链接仍然存在且指向旧版本，也可以删除它。）

  2. 检查其他可能的NVIDIA相关目录，例如/opt/nvidia/（较少见，除非有其他NVIDIA工具）。
  3. 检查并删除/etc/ld.so.conf.d/cuda.conf文件（如果存在）。 
    sudo rm /etc/ld.so.conf.d/cuda.conf

    然后更新共享库缓存：

    sudo ldconfig

步骤四：卸载NVIDIA驱动（通常不需要，谨慎操作）

与Windows类似，除非您是专门为了重新安装驱动来解决问题，否则通常不需要卸载NVIDIA显示驱动程序。 卸载驱动可能导致图形界面无法启动。

  • 对于Debian/Ubuntu系统：

    sudo apt-get --purge remove 'nvidia*'

    此命令会卸载所有NVIDIA相关的驱动和组件。之后可能需要重新安装NVIDIA驱动。

  • 对于RHEL/CentOS/Fedora系统：

    sudo yum remove 'nvidia*'
    sudo dnf remove 'nvidia*'
  • 通过NVIDIA安装脚本卸载（如果驱动是通过.run文件安装）：

    导航到您下载NVIDIA驱动.run文件的目录，并执行：

    sudo ./NVIDIA-Linux-x86_64-XXX.YY.run --uninstall

    （将XXX.YY替换为您的驱动版本号）

步骤五：重启系统

在Linux上，重启系统是确保所有更改（尤其是环境变量和内核模块）完全生效的最佳方式。

卸载cuDNN与TensorRT

cuDNN和TensorRT通常不是通过系统安装程序安装的，而是作为压缩包下载后手动解压到指定位置（通常是CUDA Toolkit的安装目录内或自定义目录）。因此，它们的卸载非常简单：

  1. 删除文件： 直接删除您手动解压的cuDNN和TensorRT的文件夹。
    • 如果它们被解压到CUDA Toolkit目录内（例如/usr/local/cuda/include和/usr/local/cuda/lib64），并且您已经删除了整个CUDA Toolkit目录，那么它们也应该已被删除。
    • 如果它们在自定义路径，请手动找到并删除这些文件夹。
  2. 清理环境变量： 检查并删除您为cuDNN或TensorRT手动设置的任何环境变量（例如LD_LIBRARY_PATH中指向它们路径的条目）。

卸载后的验证

完成所有卸载步骤后，进行验证以确保CUDA已彻底移除：

  • 验证nvcc命令：

    在终端或命令提示符中输入：

    nvcc --version

    如果CUDA已成功卸载，您应该收到“命令未找到”、“’nvcc’ 不是内部或外部命令”或类似的错误信息。

  • 检查环境变量：
    • 在Windows上，重新打开“环境变量”对话框，确认所有CUDA相关的变量已消失。
    • 在Linux上，在终端输入echo $PATH和echo $LD_LIBRARY_PATH，确认不再包含CUDA路径。
  • 检查安装目录：

    手动导航到之前CUDA的安装目录（如C:\Program Files\NVIDIA GPU Computing Toolkit\或/usr/local/cuda-X.Y），确认它们已被删除或为空。

注意事项与常见问题

  • 备份： 在进行任何系统级修改之前，始终建议备份您的重要数据。
  • 谨慎操作： 特别是在修改环境变量、清理注册表或删除系统目录时，务必小心。错误的操作可能导致系统不稳定或需要重新安装操作系统。
  • 驱动问题： 卸载NVIDIA显卡驱动程序可能导致显示问题（例如分辨率变低、没有图形界面），请确保您知道如何重新安装合适的驱动。通常情况下，只需卸载CUDA Toolkit而非驱动。
  • 不同版本： 不同的CUDA版本可能在卸载流程上略有差异，特别是旧版本。但本指南涵盖的通用步骤应适用于绝大多数情况。
  • 依赖关系： 有些第三方软件可能依赖于特定版本的CUDA。卸载CUDA后，这些软件可能无法正常运行，除非您重新安装了兼容的CUDA版本。

通过遵循本指南的详细步骤，您应该能够成功并彻底地卸载NVIDIA CUDA Toolkit及其相关组件，为您的系统提供一个干净的环境，无论是为了安装新版本还是进行系统维护。


cuda怎么卸载