from torch._C import * # noqa: F403 ImportError: libcupti.so.11.2: cannot open shared object file: No such file or directory

### ImportError: libcupti.so.11.2 cannot open shared object file when importing torch

当遇到`ImportError: libcupti.so.11.2: cannot open shared object file: No such file or directory`错误时，这通常意味着CUDA工具包中的性能分析库(CUPTI)缺失或版本不匹配。该问题常见于安装了特定版本的PyTorch及其依赖项之后。

#### 错误原因解析

此错误表明系统无法找到指定版本的CUPTI共享对象文件(`libcupti.so.11.2`)。可能的原因包括但不限于：

- 安装路径不在系统的环境变量中。
- CUDA版本与所需版本不符。
- CUPTI未随CUDA一起正确安装[^1]。

#### 解决方法

为了修复上述错误，可以采取以下措施之一来解决问题：

##### 方法一：更新或安装正确的CUDA版本

确保已安装的CUDA版本支持所需的CUPTI版本。对于`libcupti.so.11.2`而言，应当确认安装的是对应版本的CUDA Toolkit，并且其安装过程顺利完成。可以通过官方渠道下载并按照指南完成安装。

##### 方法二：设置LD_LIBRARY_PATH环境变量

如果已经拥有合适的CUDA版本，则可能是由于动态链接器未能定位到这些库的位置所引起的。此时可通过修改`LD_LIBRARY_PATH`环境变量指向CUDA库所在位置的方式尝试解决这个问题。例如，在bash shell下执行如下命令：

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/cuda/lib64/

请注意替换路径以反映实际安装情况。

##### 方法三：重新编译PyTorch

有时，预构建版的PyTorch可能会存在兼容性问题。在这种情况下，考虑从源码自行编译一个适合当前环境配置的新版本也是一种可行的选择。不过这种方法较为复杂，建议仅作为最后手段采用。