Win11 鏖战 SiamMask：从踩坑到出坑的翻车纪录

前言

本文堪称我在 Windows 11 上“鏖战” SiamMask 的翻车实录。一路踩坑、一路填坑，BUG 比头发还多，心态崩了 N 次，才终于从坑里爬出来。对纯小白 + 纯 Windows 组合而言，这套代码的友好度基本为负——每一步都是血泪，每一帧都是劝退。遂成此贴，愿后来人少走弯路。若条件允许，请直接投奔 macOS 或 Linux 怀抱，别在 Win 上硬刚。文中默认你已装好 NVIDIA 显卡驱动、CUDA 及 Anaconda，故不再赘述。

创建 SiamMask 专用虚拟环境

• CUDA： 12.8
• Python： Python 3.10

为了避免依赖冲突，建议为 SiamMask 单独创建一个虚拟环境。操作步骤如下：

• 打开 Anaconda Prompt（Anaconda 命令行工具）
• 输入以下命令创建名为 siammask 的虚拟环境，并指定 Python 版本为 3.10：

conda create -n siammask python=3.10

环境创建完成后，需要先激活 siammask 虚拟环境才能使用：

conda activate siammask

激活成功后，命令行前缀会显示 (siammask)，表示当前已处于该虚拟环境中。
根据你的 CUDA 版本安装对应的 PyTorch 套件。例如，若使用 CUDA 12.8，可执行以下命令：

pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu128

提示：若不清楚自己的 CUDA 版本，可在命令行输入 nvidia-smi 查看；若没有 NVIDIA 显卡，可安装 CPU版本（将上述命令中的 cu128 相关链接替换为 CPU 版本链接）。上述cu128即表示CUDA版本为12.8

接下来就是安装项目依赖库了。

• 进入 SiamMask 项目文件夹后，直接通过 requirements.txt 安装所有依赖：

pip install -r requirements.txt

若 requirements.txt 不在当前目录，可直接将文件拖拽到 Anaconda Prompt 窗口，自动填充文件路径：

pip install -r C:\Users\zephy\Desktop\requirements.txt

重要建议： 由于原作者指定的依赖版本较旧（适配 2019 年的 Python 环境），安装时建议删除 requirements.txt 中各库后面的版本号（如将 numpy==1.17.0 改为 numpy），让 pip 自动安装与当前 Python 3.10兼容的最新版本，减少版本冲突问题。

完成以上步骤后，SiamMask 所需的运行环境就配置好了。

完成环境安装后，接下来就说踩坑血泪史了。

在 Windows 系统中编译项目组件（替代 make.sh）

由于原项目使用的 bash make.sh 命令在 Windows 系统无法直接运行，我们需要手动执行其内部逻辑。所以接