CUDA12.5 安装mmdetection

### 安装 mmdetection 并确保与 CUDA 12.5 的兼容性

为了使 mmdetection 正确运行并保持与 CUDA 12.5 的良好兼容性，需注意几个关键环节：依赖项检查、环境配置以及可能遇到的问题及其解决方案。

#### 依赖项检查

mmdetection 需要特定版本的 Python 和 PyTorch 来支持其功能。对于 CUDA 12.5 版本的支持情况，在官方文档中并未直接提及 mmdetection 对应的具体 CUDA 支持列表[^1]；然而基于以往的经验和社区反馈，通常较新的 PyTorch 发布会提供对最新 CUDA 版本的支持。因此建议使用最新的稳定版 PyTorch 进行尝试。

确认已安装适用于 Windows 的 Anaconda 或 Miniconda 后，创建一个新的虚拟环境来隔离项目所需的包：

conda create -n open-mmlab python=3.8 -y
conda activate open-mmlab

接着更新 `pip` 工具至最新版本，并通过 pip 安装 mmcv-full（这是 mmdetection 所必需的一个库），指定编译时使用的 CUDA 版本为 12.5:

pip install --upgrade pip
pip install mmcv-full -f https://download.openmmlab.com/mmcv/dist/cu125/index.html

上述命令中的 `-f` 参数指定了一个额外索引页面链接，该链接指向了针对不同 CUDA 版本优化过的预构建二进制文件位置。这里选择了 cu125 表明我们希望下载适配于 CUDA 12.5 的版本[^2]。

#### 环境配置

完成以上步骤之后就可以继续按照常规流程安装 mmdetection 及其他必要的组件：

git clone https://github.com/open-mmlab/mmdetection.git
cd mmdetection
pip install -r requirements/build.txt
pip install -e .

这组指令将会克隆仓库到本地计算机上，进入目录后再依次执行两个安装操作——首先是读取 build 文件夹下的需求清单以获取所有外部依赖关系，其次是采用开发模式(-e选项)来进行源码级别的安装。

#### 常见错误排除

如果在安装过程中遇到了任何问题，可以考虑以下几个方面进行排查：

- **NVIDIA 显卡驱动程序不匹配**：由于显卡驱动版本会影响可用的 CUDA 功能集，所以应当先验证当前系统的 GPU 是否已经安装有对应于所选 CUDA 版本(即 12.5)的驱动程序。可以通过 nvidia-smi 命令查询系统状态，如显示的信息表明正在使用的 CUDA 版本低于预期，则需要前往 NVIDIA 官网查找合适的驱动更新。

- **PyTorch 编译参数设置不当**：当手动编译 PyTorch 而不是利用预先打包好的 whl 文件时，可能会因为未正确传递给定的 CUDA 构建标志而导致无法识别硬件加速特性。此时应该重新审视 CMakeLists.txt 中有关 CUDA_ARCH_LIST 设置的部分，确保它涵盖了目标平台上的实际架构型号。

- **MMCV Full 不可获得**：有时即使指定了正确的 URL 地址仍有可能找不到相应版本的 MMCV Full 。这时不妨切换成仅包含核心功能的基础版 mmcvc-light ，虽然性能稍逊一筹但是稳定性更高一些。