CUDA 环境下 `libcuda.so` 缺失问题解决方案

CUDA 环境下 libcuda.so 缺失问题解决方案

问题描述

在运行依赖 CUDA 的程序时，出现如下报错：

/usr/bin/ld: 找不到 -lcuda: 没有那个文件或目录
collect2: error: ld returned 1 exit status

原因分析

• 系统缺少 libcuda.so 文件，导致链接器找不到 CUDA 库。
• 通常 /usr/lib/x86_64-linux-gnu/ 目录下只有 libcuda.so.1，没有 libcuda.so。
• libcuda.so 只是一个开发用的软链接，指向实际的 libcuda.so.1。

解决方法

1. 检查 CUDA 库文件是否存在

   ls /usr/lib/x86_64-linux-gnu/libcuda.so*
   

   如果只有 libcuda.so.1，没有 libcuda.so，继续下一步。

2. 手动创建软链接

   sudo ln -s /usr/lib/x86_64-linux-gnu/libcuda.so.1 /usr/lib/x86_64-linux-gnu/libcuda.so
   

3. 验证软链接

   ls -l /usr/lib/x86_64-linux-gnu/libcuda.so
   

   输出应为：

   libcuda.so -> libcuda.so.1
   

4. 重新运行程序

   问题应已解决。

其他建议

• 确认已正确安装 NVIDIA 驱动和 CUDA 工具包。
• 可用 nvidia-smi 检查显卡和驱动状态。
• 可用 nvcc --version 检查 CUDA 工具链。

如遇新问题，建议记录报错信息并查阅官方文档或社区。