2. Champion 实验环境搭建

在开始规则引擎 Champion 实验之前，必须搭建一个干净、可复现的 Python 运行环境。本章将指导你完成从 Python 版本选择、虚拟环境创建到核心依赖包安装的全过程，并最终验证安装是否成功。

2.1 Python 版本要求

Champion Engine 基于现代 Python 特性开发，对 Python 版本有明确要求。请确保你的系统中安装了受支持的 Python 版本。

Python 版本	支持状态	说明
3.9	✅ 完全支持	推荐用于生产环境，稳定性最佳
3.10	✅ 完全支持	推荐用于开发与实验，性能略有提升
3.11	✅ 完全支持	支持最新语言特性，建议新项目使用
3.8 及以下	❌ 不支持	缺少必要的类型注解与异步支持

2.2 虚拟环境创建

虚拟环境可以为每个项目隔离依赖包，避免不同项目之间的包版本冲突。推荐使用 Python 内置的 venv 模块创建虚拟环境。

以下是创建和激活虚拟环境的完整步骤：

1. 创建虚拟环境： 在项目根目录下执行以下命令，会在当前目录生成一个名为 champion_env 的文件夹。

python -m venv champion_env

2. 激活虚拟环境： 根据你的操作系统选择对应的激活命令。

操作系统	激活命令
Windows (CMD)	champion_env\Scripts\activate.bat
Windows (PowerShell)	champion_env\Scripts\Activate.ps1
macOS / Linux	source champion_env/bin/activate

3. 验证激活： 激活后，终端提示符前面会出现 (champion_env) 字样，表示当前已进入虚拟环境。

2.3 依赖包安装

激活虚拟环境后，使用 pip 安装 Champion Engine 及其核心依赖。Champion Engine 的包名为 champion-engine，安装命令如下：

pip install champion-engine

该命令会自动安装 Champion Engine 及其所有依赖项，包括：

• 核心引擎： 规则解析、推理与执行模块
• 表达式计算： 内置的数学与逻辑表达式求值器
• JSON 支持： 规则与事实数据的序列化/反序列化
• 日志系统： 调试与运行时追踪工具

安装完成后，可以通过以下命令查看已安装的包及其版本：

pip list | findstr champion-engine   # Windows
pip list | grep champion-engine       # macOS / Linux

2.4 验证安装

安装完成后，通过一个简单的 Python 脚本来验证 Champion Engine 是否能够正常导入并运行。创建一个名为 verify_install.py 的文件，写入以下代码：

# verify_install.py
from champion_engine import RuleEngine, Fact

# 创建一个简单的事实
fact = Fact({"temperature": 30})

# 定义一条规则：如果温度大于 25，则输出 "高温预警"
rule = """
RULE "高温预警"
WHEN temperature > 25
THEN print("高温预警：当前温度", temperature)
"""

# 初始化规则引擎并加载规则
engine = RuleEngine()
engine.add_rule(rule)

# 执行推理
engine.execute(fact)

print("✅ Champion Engine 安装验证通过！")

在终端中运行该脚本：

python verify_install.py

如果输出以下内容，则表示安装成功：

高温预警：当前温度 30
✅ Champion Engine 安装验证通过！

2.5 环境搭建流程总览

下图总结了从 Python 版本检查到安装验证的完整流程，帮助你快速定位每一步的关键操作。

2.6 常见问题排查

如果在安装或验证过程中遇到问题，请参考下表进行快速排查：

错误现象	可能原因	解决方案
pip 不是内部或外部命令	Python 未添加到系统 PATH	重新安装 Python 并勾选“Add Python to PATH”
ModuleNotFoundError: No module named 'champion_engine'	未在虚拟环境中安装包	激活虚拟环境后重新执行 pip install champion-engine
pip install 速度慢或超时	默认源在国外，网络不稳定	使用国内镜像源：pip install champion-engine -i https://pypi.tuna.tsinghua.edu.cn/simple
Python 版本不兼容	系统 Python 版本低于 3.9	升级 Python 到 3.9 或更高版本