Conda 安装 CUDA Toolkit 解决 nvcc 找不到的问题

在使用 Conda 安装 CUDA 时，很多人会遇到 nvcc: command not found 的问题。这是因为 conda install cudatoolkit 只安装了 CUDA 运行时（runtime），并不包含 nvcc 这样的开发工具。本文介绍如何正确安装 nvcc 并配置环境变量，使其正常运行。

$ nvcc -V
bash: nvcc: command not found

参考：conda 安装 cuda toolkit 解决 nvcc 找不到问题

即使 cudatoolkit 已安装，nvcc 仍然不可用，因为：

• conda cudatoolkit 只包含 CUDA 运行库，不包含 nvcc。

• 没有安装完整的 CUDA Toolkit。

• 环境变量未正确配置。

解决方案：

方法 1：使用 Conda 安装完整的 CUDA Toolkit

从 NVIDIA 的官方频道安装完整的 CUDA Toolkit，包括 nvcc：

conda install -c nvidia cuda-toolkit=11.8.0    (这里版本号根据需要设置)

安装完成后，验证 nvcc：

nvcc -V

如果显示 CUDA 版本信息，说明 nvcc 已成功安装。

ubuntu@ubuntu:~$ nvcc -V
nvcc: NVIDIA (R) Cuda compiler driver
Copyright (c) 2005-2025 NVIDIA Corporation
Built on Tue_May_27_02:21:03_PDT_2025
Cuda compilation tools, release 12.9, V12.9.86
Build cuda_12.9.r12.9/compiler.36037853_0

方法 2：手动下载并安装 CUDA（适用于无 sudo 权限，比较麻烦，推荐第一种方法）

如果你没有 sudo 权限，可以手动安装 CUDA：

1. 下载 CUDA 11.7（或其他版本）

wget https://developer.download.nvidia.com/compute/cuda/11.7.0/local_installers/cuda_11.7.0_linux.run -O ~/cuda_11.7.0.run

2. 安装到用户目录

sh ~/cuda_11.7.0.run --silent --toolkit --override

这会默认安装到 ~/cuda/ 目录。

3. 配置环境变量

export PATH=$HOME/cuda/bin:$PATH
export LD_LIBRARY_PATH=$HOME/cuda/lib64:$LD_LIBRARY_PATH

让这些变量永久生效：

echo 'export PATH=$HOME/cuda/bin:$PATH' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=$HOME/cuda/lib64:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc

4. 验证 nvcc

nvcc -V

如果 nvcc 输出 CUDA 版本信息，说明安装成功。

方法 3：使用 CUDA 预编译二进制（无需安装）

如果你不能安装，但可以解压文件：

wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2004/x86_64/cuda-repo-ubuntu2004_11.7.0-1_amd64.deb -O ~/cuda.deb
dpkg-deb -x ~/cuda.deb ~/cuda

然后配置环境变量：

export PATH=$HOME/cuda/usr/local/cuda/bin:$PATH
export LD_LIBRARY_PATH=$HOME/cuda/usr/local/cuda/lib64:$LD_LIBRARY_PATH
source ~/.bashrc

然后运行 nvcc -V 进行验证。