项目 环境安装与路径说明

时间: 2026-08-07 11:44:37

# 环境安装与路径说明

一、环境要求

> ⚠️ 你当前 Python 路径显示为 pythoncore-3.14-64，版本满足要求。

二、安装 Mesa

安装核心库

pip install -U mesa

推荐安装（含可视化、网络等常用依赖）

pip install -U "mesa[rec]"

完整安装（含开发依赖）

pip install -U "mesa[all]"

三、项目放置路径

你的 Mesa 示例目录在：

XXX\Python\pythoncore-3.14-64\Lib\site-packages\mesa\examples\advanced\

建议的项目结构

将你的狼群模型放在 advanced 目录下，与官方示例同级：

XXX\Python\pythoncore-3.14-64\Lib\site-packages\mesa\examples\advanced\

├── wolf_sheep/ # 官方示例

├── wolf_pack_dynamics/ # ← 你的项目（建议命名）

│ ├── __init__.py

│ ├── agents.py

│ ├── model.py

│ ├── app.py

│ └── run_and_export.py

├── boltzmann_wealth_model/

├── boid/

├── conway/

├── schelling/

├── virus_on_network/

└── ...

为什么放在这里？

- wolf_pack_dynamics 模块中使用了相对导入：

from mesa.examples.advanced.wolf_pack_dynamics.model import WolfPackDynamics
from mesa.examples.advanced.wolf_pack_dynamics.agents import Sheep, Wolf, GrassPatch

- 放在 mesa/examples/advanced/ 下可以确保导入路径正确

- 与官方示例同级，便于对照和调试

四、验证安装

1. 检查 Mesa 版本

import mesa
print(mesa.__version__)

2. 运行可视化

cd XXX\Python\pythoncore-3.14-64\Lib\site-packages\mesa\examples\advanced\wolf_pack_dynamics
solara run app.py

浏览器打开 http://localhost:8765 即可看到交互界面。

五、备选方案：任意路径运行

如果不想把项目放在 site-packages 里，可以：

方案一：修改导入方式（推荐）

在 app.py 和 run_and_export.py 中使用绝对导入：

# 如果你的项目在 D:\wolf_sim\
import sys
sys.path.append(r"D:\wolf_sim")


from wolf_pack_dynamics.model import WolfPackDynamics
from wolf_pack_dynamics.agents import Sheep, Wolf, GrassPatch

方案二：使用 PYTHONPATH

set PYTHONPATH=xxxxx\wolf_project
python run_and_export.py

六、文件校验清单

在移交项目前，确保以下文件齐全：

七、快速启动

# 1. 进入目录
cd XXX\Python\pythoncore-3.14-64\Lib\site-packages\mesa\examples\advanced\wolf_pack_dynamics


# 2. 运行可视化
solara run app.py


# 3. 或批量运行（导出CSV）
python run_and_export.py

八、常见问题

移交时请附带本说明文件，确保接收方能直接运行。