WSL Ubuntu 安装cuda
时间: 2025-05-16 22:04:17 浏览: 42
### 在 WSL Ubuntu 环境下安装和配置 CUDA
要在 WSL (Windows Subsystem for Linux) 的 Ubuntu 环境中成功安装和配置 CUDA,可以按照以下方法操作:
#### 1. 下载并设置 `pin` 文件
在终端中运行以下命令来下载 `pin` 文件,该文件用于优先级管理:
```bash
wget https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/cuda-wsl-ubuntu.pin
sudo mv cuda-wsl-ubuntu.pin /etc/apt/preferences.d/cuda-repository-pin-600
```
此步骤确保系统的包管理器能够识别 NVIDIA 提供的 CUDA 软件仓库[^1]。
#### 2. 添加 CUDA 软件源
通过以下命令添加 CUDA 的官方软件源到 APT 配置中:
```bash
sudo apt-key adv --fetch-keys https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/7fa2af80.pub
sudo add-apt-repository "deb https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/ /"
```
这一步是为了让系统可以从 NVIDIA 的服务器获取最新的 CUDA 工具链版本。
#### 3. 更新包列表
更新本地包索引以反映新加入的 CUDA 源:
```bash
sudo apt-get update
```
#### 4. 安装 CUDA Toolkit
执行以下命令完成工具包的核心组件安装:
```bash
sudo apt-get -y install cuda
```
如果希望简化流程或者只需要基础功能支持,则可以选择更精简的方式,比如仅安装核心开发套件及相关依赖项:
```bash
sudo apt-get install nvidia-cuda-toolkit
```
这种方式适合于不需要额外库的情况,例如某些特定场景下的深度学习框架部署需求[^3]。
#### 5. 设置环境变量
编辑用户的 shell profile 文件(通常是 `.bashrc` 或者 `.zshrc`),追加如下内容以便正确加载 CUDA 库路径:
```bash
echo 'export CUDA_HOME=/usr/local/cuda' >> ~/.bashrc
echo 'export PATH=${CUDA_HOME}/bin:$PATH' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${CUDA_HOME}/lib64' >> ~/.bashrc
source ~/.bashrc
```
这些导出语句定义了必要的环境参数,使得编译程序时能自动找到 GPU 编程所需的头文件与动态链接库位置[^5]。
#### 6. 测试安装是否成功
验证 CUDA 是否正常工作的一个简单办法是运行样例测试代码。进入示例目录并构建项目:
```bash
cd /usr/local/cuda/samples/1_Utilities/deviceQuery
make
./deviceQuery
```
如果没有错误消息并且显示设备详情说明已经成功启用硬件加速能力[^4]。
---
### 注意事项
对于不同操作系统组合可能存在的兼容性差异,请参照具体发行版对应的指南调整上述过程中的细节部分;另外,在实际应用过程中遇到任何异常状况都可以查阅官方文档寻求帮助。
阅读全文
相关推荐

















