3. 环境搭建：安装 Backtrader、依赖库与验证

在开始编写回测策略之前，需要先搭建一个干净、可复现的 Python 运行环境。本章将指导你完成 Backtrader 及其核心依赖库的安装，并通过一个简单的测试脚本验证环境是否就绪。

3.1 环境概览与版本要求

Backtrader 是一个纯 Python 库，对系统环境要求较低，但为了保证回测结果的稳定性和性能，建议使用以下软件版本组合：

3.2 安装核心依赖库

使用 Python 包管理器 pip 可以一次性安装 Backtrader 及其所有依赖。打开终端（Windows 用户使用 CMD 或 PowerShell，macOS/Linux 用户使用 Terminal），执行以下命令：

# 创建并激活虚拟环境（可选但强烈推荐）
python -m venv bt_env
# Windows:
bt_env\Scripts\activate
# macOS/Linux:
source bt_env/bin/activate

# 安装 Backtrader 及核心依赖
pip install backtrader numpy pandas matplotlib

安装过程会自动解析并下载所有依赖包。如果网络环境受限，可以使用国内镜像源加速：

pip install backtrader numpy pandas matplotlib -i https://pypi.tuna.tsinghua.edu.cn/simple

3.3 依赖关系与架构

Backtrader 的回测引擎并非孤立运行，它与 NumPy、Pandas、Matplotlib 三个库形成了紧密的协作关系。下面的 SVG 图展示了各组件在回测流程中的角色与数据流向：

3.4 验证安装：运行测试脚本

环境搭建完成后，编写一个简短的测试脚本来验证所有库是否正常工作。该脚本会生成一组模拟价格数据，运行一个简单的移动平均线策略，并输出回测结果。

# test_backtrader.py
import backtrader as bt
import pandas as pd
import numpy as np
import matplotlib.pyplot as plt

# 1. 生成模拟数据
dates = pd.date_range('2023-01-01', periods=100, freq='D')
data = pd.DataFrame({
    'close': np.random.randn(100).cumsum() + 100,
    'open': np.random.randn(100).cumsum() + 100,
    'high': np.random.randn(100).cumsum() + 102,
    'low': np.random.randn(100).cumsum() + 98,
    'volume': np.random.randint(1000, 5000, 100)
}, index=dates)

# 2. 定义简单策略
class TestStrategy(bt.Strategy):
    def next(self):
        if not self.position:
            if self.data.close[0] > self.data.close[-1]:
                self.buy(size=10)
        else:
            if self.data.close[0] < self.data.close[-1]:
                self.sell(size=10)

# 3. 运行回测
cerebro = bt.Cerebro()
feed = bt.feeds.PandasData(dataname=data)
cerebro.adddata(feed)
cerebro.addstrategy(TestStrategy)
cerebro.broker.setcash(10000.0)

print(f'初始资金: {cerebro.broker.getvalue():.2f}')
cerebro.run()
print(f'最终资金: {cerebro.broker.getvalue():.2f}')

# 4. 绘制结果
cerebro.plot()
print('✅ 环境验证通过！所有库安装正常。')

在终端中运行该脚本：

python test_backtrader.py

如果一切正常，你将看到类似如下的输出，并弹出一个包含净值曲线和交易信号的 Matplotlib 图表窗口：

初始资金: 10000.00
最终资金: 10023.45
✅ 环境验证通过！所有库安装正常。

3.5 环境验证清单

为了确保后续章节的学习不受环境问题干扰，建议逐项核对以下清单：