Windows10下用Anaconda+PyTorch 1.4.0搞定SMAC多智能体平台（保姆级避坑指南）

Windows10下Anaconda+PyTorch 1.4.0搭建SMAC多智能体平台的完整实战指南

在强化学习领域，多智能体协作一直是个令人着迷的方向。而SMAC（StarCraft Multi-Agent Challenge）作为基于星际争霸II的多智能体研究平台，因其丰富的战术场景和高度可定制的环境，成为学术界和工业界的热门选择。但对于Windows用户来说，环境配置过程中的版本冲突、路径问题常常让人望而却步。本文将带你从零开始，用Anaconda构建Python 3.7虚拟环境，精准安装PyTorch 1.4.0及其生态组件，最终完成SMAC平台的完整部署。

1. 环境准备与星际争霸II安装

1.1 硬件与基础软件检查

在开始前，请确保你的Windows10系统满足以下条件：

• 64位操作系统（建议版本1903或更高）
• NVIDIA显卡（如使用GPU版本）及对应驱动
• 至少40GB可用磁盘空间（星际争霸II约占用30GB）

关键检查命令 ：

nvidia-smi  # 查看CUDA驱动版本
systeminfo | find "OS 版本"  # 确认系统版本

1.2 星际争霸II安装与配置

从暴雪官网下载星际争霸II客户端时，建议选择完整版而非免费版，某些地图需要完整版支持。安装路径强烈建议避开系统盘（如 D:\Games\StarCraft II ），这能避免后续的权限问题。

安装完成后需设置关键环境变量：

setx SC2PATH "D:\Games\StarCraft II"  # 替换为你的实际路径

注意：如果安装后没有自动创建 Maps 目录，需手动在游戏根目录下创建该文件夹

2. Anaconda环境精准配置

2.1 创建专属Python环境

使用Anaconda Navigator或命令行创建隔离环境：

conda create -n smac_env python=3.7.9 -y
conda activate smac_env

版本选择依据 ：

• Python 3.7是PyTorch 1.4.x的最佳兼容版本
• 避免使用Python 3.8+，会导致后续torch-geometric安装失败

2.2 PyTorch 1.4.0安装策略

根据硬件情况选择安装方式：

常见问题解决：

• 如果遇到 HTTP 000 错误，尝试添加清华镜像源：

  conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
  conda config --set show_channel_urls yes
  

3. 关键依赖库的安装技巧

3.1 torch-geometric及其依赖库

这是整个安装过程中最容易出错的环节。必须严格按照以下顺序安装：

1. 先安装四个前置库（需下载对应版本的whl文件）：

   pip install torch_scatter-2.0.3+cu101-cp37-cp37m-win_amd64.whl
   pip install torch_sparse-0.5.1+cu101-cp37-cp37m-win_amd64.whl
   pip install torch_cluster-1.5.2+cu101-cp37-cp37m-win_amd64.whl
   pip install torch_spline_conv-1.2.0+cu101-cp37-cp37m-win_amd64.whl
   

2. 最后安装主库：

   pip install torch-geometric==1.6.0
   

避坑指南 ：

• 所有whl文件必须来自同一来源（建议官方链接）
• 如果遇到 ERROR: Could not build wheels for... ，尝试先安装Visual C++ Build Tools

3.2 SMAC平台安装

推荐从GitHub源码安装以获得完整功能：

git clone https://github.com/oxwhirl/smac.git
cd smac
pip install -e .

验证安装：

python -c "import smac; print(smac.__version__)"

4. 地图配置与测试运行

4.1 地图文件处理

从SMAC官方仓库下载地图包后：

1. 解压得到 SMAC_Maps 文件夹
2. 将其复制到星际争霸II安装目录的 Maps 文件夹下
3. 设置地图环境变量：

   setx SC2MAPPATH "%SC2PATH%\Maps"
   

查看可用地图列表：

python -m smac.bin.map_list

4.2 非默认路径问题解决

对于自定义安装路径的用户，可能会遇到路径硬编码问题。解决方法：

1. 在 C:\Program Files (x86) 下创建 StarCraft II 空文件夹
2. 在其中创建 Versions 子目录
3. 将实际安装路径中的 Versions\Basexxxxx 文件夹复制到此

注意：这不是最佳实践但能快速解决问题，更优雅的方案是修改SMAC源码中的路径检测逻辑

5. 完整测试与验证

运行简单测试案例：

python -m smac.examples.random_agents

预期行为：

1. 星际争霸II游戏界面自动启动
2. 控制台输出智能体决策信息
3. 游戏正常进行直到结束

如果遇到黑屏或卡顿：

• 检查显卡驱动是否为最新版
• 尝试在SMAC配置中降低渲染质量
• 确认防火墙没有阻止游戏连接

6. 高级配置与性能优化

对于需要长期使用的开发者，建议进行以下优化：

1. 环境固化 ：

   conda env export > smac_env.yaml
   

2. 启动脚本自动化 ： 创建 start_smac.bat 文件包含：

   @echo off
   call activate smac_env
   set SC2PATH=D:\Games\StarCraft II
   python your_script.py
   

3. 多地图管理技巧 ：

   • 使用符号链接管理多个地图集
   • 通过 --map_name 参数指定测试地图

实际项目中，我们曾遇到PyTorch与numpy版本冲突导致的内存泄漏问题。最终锁定numpy==1.19.3版本后稳定运行。这提醒我们：在强化学习项目中，每个依赖项的版本都可能是关键因素。