企业官网建设流程全解析

Windows系统下PyMARL与SMAC强化学习环境搭建全攻略

引言

对于刚接触多智能体强化学习的研究者和开发者来说，环境配置往往是第一个"拦路虎"。特别是当需要在Windows系统上搭建PyMARL框架和SMAC环境时，版本兼容性、依赖冲突、路径配置等问题层出不穷。本文将提供一份详尽的避坑指南，从Anaconda环境配置到最终模型训练与回放，手把手带你完成整个环境搭建过程。

1. 基础环境准备

1.1 Anaconda与Python版本选择

PyMARL对Python版本有严格要求，推荐使用Python 3.7或3.8版本。以下是创建conda环境的正确方式：

conda create -n pymarl python=3.7 -y conda activate pymarl

常见问题及解决方案：

• 问题：conda环境创建失败
  解决：检查网络连接，或尝试更换conda镜像源
• 问题：Python版本不兼容
  解决：确保使用3.7或3.8版本，避免使用3.9及以上版本

1.2 必备工具安装

在开始前，请确保已安装以下工具：

• Git（需添加到系统环境变量）
• PyCharm或其他Python IDE
• Visual Studio Build Tools（用于编译部分依赖）

提示：安装Git时务必勾选"Add Git to the system PATH"选项，否则后续步骤可能失败

2. SMAC环境配置

2.1 SMAC安装

推荐使用以下两种安装方式之一：

方法一（直接安装）：

pip install git+https://github.com/oxwhirl/smac.git

方法二（克隆后安装）：

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

版本对照表：

2.2 星际争霸II客户端安装

1. 从暴雪官网下载并安装StarCraft II
2. 将游戏安装目录添加到系统环境变量SC2PATH中
3. 下载SMAC地图包并解压到$SC2PATH/Maps目录

验证安装：

python -m smac.bin.map_list python -m smac.examples.random_agents

3. PyMARL框架配置

3.1 克隆与依赖安装

git clone https://github.com/oxwhirl/pymarl.git cd pymarl pip install -r requirements.txt

依赖冲突解决方案：

当出现依赖冲突时，可以尝试以下步骤：

1. 备份原环境
2. 创建新的干净环境
3. 按顺序安装：
   • 先安装PyTorch
   • 再安装requirements.txt中的其他依赖

3.2 常见错误修复

问题一：yaml加载错误
解决方案：

# 修改main.py中的yaml加载方式 config_dict = yaml.safe_load(f)

问题二：Git环境变量错误
解决方案： 在sacred/dependencies.py第422行添加：

os.environ["GIT_PYTHON_REFRESH"] = "quiet"

4. 实战训练与调试

4.1 命令行运行

基础命令格式：

python src/main.py --config=qmix --env-config=sc2 with env_args.map_name=2s3z

参数说明：

4.2 PyCharm调试配置

对于习惯使用IDE的开发者，可以在PyCharm中配置运行参数：

1. 创建新的Python配置
2. 脚本路径选择main.py
3. 参数设置为：

   --config=qmix --env-config=sc2 with env_args.map_name=2s3z

注意：with是一个独立参数，后面的参数需要用空格分隔

4.3 模型保存与回放

保存模型配置：

save_model: True save_model_interval: 10000 local_results_path: ./results

加载模型并生成回放：

checkpoint_path: ./results/models/... save_replay: True test_nepisode: 5

回放文件会自动保存到StarCraft II的Replays目录，可在游戏客户端中观看。