如何彻底卸载CUDA避免残留？

Question

如何彻底卸载CUDA并清除所有残留文件和配置，避免影响后续版本安装？在卸载后，系统仍可能存在旧的驱动、内核模块、环境变量或位于 `/usr/local/cuda`、`/etc/ld.so.conf.d/` 中的软链接与库路径，导致新版本冲突。应如何通过命令行精准移除CUDA Toolkit、Driver及相关依赖，并手动清理注册表（Windows）或配置文件（Linux），确保无残留？

Answer 1

彻底卸载CUDA并清除所有残留文件与配置的完整指南

在深度学习、高性能计算等IT领域，NVIDIA CUDA已成为不可或缺的技术栈。然而，在多版本迭代过程中，若未正确卸载旧版CUDA Toolkit与驱动，极易导致新版本安装失败或运行异常。本文将从基础到深入，系统性地讲解如何在Linux与Windows平台上彻底清除CUDA相关组件，包括驱动、内核模块、环境变量、软链接、库路径及注册表项，确保无任何残留影响后续部署。

1. 理解CUDA的组成结构

CUDA并非单一软件，而是一套包含多个子系统的复杂技术栈：

• CUDA Driver：由NVIDIA显卡驱动提供，支持GPU执行CUDA程序。
• CUDA Toolkit：开发工具集，包含编译器（nvcc）、调试器、库文件等。
• CUDA Runtime & Driver API：运行时库和接口。
• 内核模块：如nvidia.ko、nvidia-uvm等，加载于操作系统内核。
• 环境变量与路径配置：如PATH、LD_LIBRARY_PATH、/etc/ld.so.conf.d中的条目。
• 软链接：常见于/usr/local/cuda指向具体版本目录。

2. Linux平台下的彻底卸载流程

2.1 查询已安装的CUDA包

使用以下命令列出所有与CUDA相关的已安装包：

dpkg -l | grep -i cuda
dpkg -l | grep -i nvidia

2.2 卸载CUDA Toolkit及相关依赖

根据包管理器类型执行卸载：

发行版	命令
Ubuntu/Debian	sudo apt-get --purge remove "*cuda*" "*cublas*" "*cufft*" "*curand*" "*cusolver*" "*cusparse*" "*npp*" "*nvjpeg*" "nsight*"
RHEL/CentOS	sudo yum remove "*cuda*" "*nvidia*"

2.3 移除NVIDIA驱动

使用NVIDIA官方提供的卸载脚本或手动删除：

sudo /usr/bin/nvidia-uninstall
# 或者使用runfile安装时生成的日志清理

2.4 清理残留文件与目录

手动删除可能遗留的关键路径：

sudo rm -rf /usr/local/cuda*
sudo rm -f /etc/ld.so.conf.d/cuda*.conf
sudo ldconfig
sudo rm -rf /opt/cuda

2.5 删除内核模块

确认当前加载的模块并移除：

lsmod | grep nvidia
sudo rmmod nvidia_uvm nvidia_drm nvidia_modeset nvidia

随后清除initramfs中的镜像：

sudo update-initramfs -u

2.6 清理环境变量

检查并编辑shell配置文件：

grep -r "CUDA" ~/.bashrc ~/.profile ~/.zshrc /etc/environment
# 手动删除export PATH、LD_LIBRARY_PATH中关于CUDA的条目

3. Windows平台下的深度清理策略

3.1 使用控制面板卸载主程序

进入“程序和功能”，卸载以下组件：

• NVIDIA CUDA Toolkit X.X
• NVIDIA Graphics Driver
• NVIDIA PhysX
• NVIDIA GeForce Experience（可选）

3.2 使用DDU进行驱动级清理

推荐使用Display Driver Uninstaller (DDU) 工具，在安全模式下彻底清除显卡驱动及注册表项。

3.3 手动清理注册表残留

使用regedit定位并删除以下路径（操作前请备份注册表）：

HKEY_LOCAL_MACHINE\SOFTWARE\NVIDIA Corporation\CUDA
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\nv*

3.4 清除文件系统残留

删除以下目录：

C:\Program Files\NVIDIA GPU Computing Toolkit\
C:\ProgramData\NVIDIA Corporation\
C:\Users\Public\Documents\NVIDIA Corporation\

4. 验证清理完整性

graph TD A[开始验证] --> B{nvidia-smi是否报错?} B -->|是| C[驱动已清除] B -->|否| D[重新执行驱动卸载] C --> E{nvcuda.dll是否存在?} E -->|否| F[Runtime已清除] E -->|是| G[手动删除dll或重装系统] F --> H[检查环境变量] H --> I[确认无CUDA路径] I --> J[清理完成]

5. 常见问题分析与规避建议

在实际运维中，常遇到如下典型问题：

1. nvcc仍可执行：说明/usr/local/cuda软链接未删除或PATH未更新。
2. 开机自动加载nvidia模块：需检查/etc/modules-load.d/是否有残留配置。
3. ldconfig仍能找到libcuda.so：/etc/ld.so.conf.d/中存在旧路径。
4. Windows蓝屏或启动失败：注册表损坏，建议使用DDU+系统还原。
5. Docker容器内调用失败：宿主机驱动未完全清理，影响nvidia-container-toolkit。
6. 多用户环境下权限混乱：~/.bashrc中存在个人配置，需逐用户清理。
7. UEFI Secure Boot阻止驱动加载：需在BIOS中禁用或签名驱动。
8. 旧版本库被动态链接器缓存：执行sudo ldconfig -v刷新缓存。
9. conda环境中残留pycuda或cupy：需pip uninstall并清理site-packages。
10. 符号链接指向不存在目录：检查/usr/local/cuda -> /usr/local/cuda-12.2，目标是否存在。