Cerebro 回测引擎详解

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

Cerebro 是 Backtrader 的核心类，负责整个系统的运行。

它的功能包括：

管理数据源、策略、观察者、分析器和编写器，确保系统正常运行。
执行回测或实时数据供给和交易。
返回回测结果。
提供策略绘图功能。

创建 `Cerebro` 实例
#

创建 Cerebro 实例时，可以通过传递一些控制参数：

Cerebro 参数配置说明

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

Cerebro 类的详细说明如下。

实例化参数
#

参数	默认值	说明
`preload`	True	是否预加载传递给策略的数据源。
`runonce`	True	以矢量化模式计算指标，提升系统性能。注：策略和观察者始终基于事件运行。
`live`	False	如果没有数据通过 `islive` 方法报告为实时，但用户仍希望以实时模式运行，可将此参数设为 True。
`maxcpus`	None	优化时使用的 CPU 核心数，默认 None（启用所有可用核心）。
`stdstats`	True	如果为 True，将添加默认观察者：经纪人（现金和价值）、交易和买卖。
`oldbuysell`	False	当 `stdstats` 为 True 且自动添加观察者时，此开关控制买卖观察者的具体行为。
`oldtrades`	False	当 `stdstats` 为 True 且自动添加观察者时，此开关控制交易观察者的具体行为。
`exactbars`	False	- `False`：默认值，将 `Line` 中存储的值都保存到内存。 - `True` 或 `1`：所有 `Line` 对象的内存使用减少至计算所需的最小周期。如果简单移动平均线的周期为 30，则底层数据将始终有一个 30 条的运行缓冲区，以允许计算 SMA。此设置将停用 `preload` 和 `runonce`。使用此设置还将停用绘图。 `-1`：策略级别的数据源和指标/操作将保留所有数据在内存中。如 `RSI` 通过指标 `UpDay` 计算，`UpDay` 不保留所有数据在内存中。这允许保持绘图和预加载功能。 `runonce` 将被停用。 `-2`：作为策略属性的数据源和指标将保留所有点在内存中。例如：`RSI` 内部使用指标 `UpDay` 进行计算，此子指标不保留所有数据在内存中。如果在 `__init__` 中定义了 `a = self.data.close - self.data.high`，那么 `a` 不保留所有数据在内存中。这允许保持绘图和预加载功能。 `runonce` 将被停用。
`objcache`	False	实验选项，用于缓存 `Line` 对象并减少其数量。示例来自 `UltimateOscillator`： `bp = self.data.close - TrueLow(self.data) # -> 创建另一个 TrueLow(self.data) tr = TrueRange(self.data)` 如果为 True，`TrueRange` 内部的第二个 `TrueLow(self.data)` 将匹配 bp 计算中的签名并被重用。极端情况下可能使线对象超出其最小周期而导致问题，因此该功能默认禁用。
`writer`	False	如果为 True，将创建一个默认的 `WriterFile`，输出到标准输出。除用户代码添加的编写器外，这个编写器也会添加到策略中。
`tradehistory`	False	如果为 True，将激活所有策略中每个交易的更新事件日志。也可通过策略方法 `set_tradehistory` 按策略单独设置。
`optdatas`	True	如果为 True 且在优化时（且系统可预加载并使用 runonce），则数据预加载仅在主进程中完成，以节省时间和资源。测试显示，执行时间从 83 秒减少到 66 秒，提升约 20%。
`optreturn`	True	如果为 True，优化结果不是完整的策略对象（包括所有数据、指标、观察者等），而是只包含以下属性的对象（与策略一致）：
`params`（或 `p`）	无	策略执行时的参数。
`analyzers`	无	策略所执行的分析器。多数情况下只需分析器和参数即可评估策略性能。如需详细分析生成的值（如指标值），可关闭此选项。测试显示，执行时间提升了 13%-15%，结合 `optdatas` 总提升达 32%。
`oldsync`	False	从版本 1.9.0.99 开始，多个数据（相同或不同时间框架）的同步方式已变更，以支持不同长度的数据。如需恢复以数据 0 作为系统主控的旧行为，请将此参数设为 True。
`tz`	None	为策略添加全局时区。`tz` 可以是： `None`：策略显示的日期时间将为 UTC，此为标准行为。 `pytz` 实例：用于将 UTC 转换为所选时区。 `字符串`：将尝试实例化 `pytz` 实例。 `整数`：使用 `self.datas` 中对应数据的时区（0 表示使用 `data0` 的时区）。
`cheat_on_open`	False	调用策略的 `next_open` 方法。该方法在 `next` 之前触发，且早于经纪人评估订单的时机。此时指标尚未重新计算，允许在开盘价上进行股数计算时参考前一天的指标发布订单。要启用 `cheat_on_open` 订单执行，还需调用 `cerebro.broker.set_coo(True)`、实例化 `BackBroker(coo=True)`（coo 表示 `cheat-on-open`），或将 `broker_coo` 参数设为 True。除非在下文中禁用，否则 Cerebro 会自动执行此操作。
`broker_coo`	True	自动调用经纪人的 `set_coo` 方法并设为 True，以激活 `cheat_on_open` 执行。仅在 `cheat_on_open` 也为 True 时生效。
`quicknotify`	False	在传递下一价格之前立即传递经纪人通知。对回测无影响，但对实时经纪人，通知可能在条传递之前很久就已发生。设为 True 时将尽快传递通知（参见实时数据源中的 `qcheck`）。出于兼容性，默认为 False，未来可能改为 True。

成员方法
#

addstorecb(callback)

添加回调函数，接收将由 notify_store 方法处理的消息。回调的签名必须支持以下内容：

内存优化与节省技巧

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

Backtrader 的开发是在大内存机器上进行的，加上绘图可视化反馈非常有用（几乎是必需品），这使得设计决策变得简单：将所有数据保存在内存中。但这一决定有一些缺点：

参数优化性能改进

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

Backtrader 通过引入两个新的 Cerebro 参数，优化了在多进程环境下管理数据源和结果的方式。

参数说明：

参数名	默认值	描述
optdatas	True	如果为True并进行优化（系统可以预加载并使用runonce），则数据预加载将仅在主进程中进行一次，以节省时间和资源。
optreturn	True	如果为True，优化结果将不是完整的策略对象（包括所有数据、指标、观察者等），而是带有以下属性的对象（与策略中相同）： - params（或p）：策略执行时的参数 - analyzers：策略执行的分析器

通常只需查看策略参数组合的最终表现（如收益率）。如需查看运行过程中的详细数据（如每个时间点的指标值），请关闭此选项。

异常处理与错误管理

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

设计目标之一是尽早退出，让用户清楚地了解错误发生的位置。这迫使我们在异常情况下编写会中断的代码，从而必须重新审视受影响的部分。

但时机已到，平台开始逐步引入一些异常类型。

日志记录与 Writer 输出

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

Writer 类负责将以下内容写入输出流：

数据源、策略、指标和观察者的 CSV 流。可通过每个对象的 csv 属性控制哪些对象输出到 CSV 流（数据源和观察者默认为 True，指标默认为 False）。

Cerebro on 菠萝学

Cerebro 回测引擎详解

创建 Cerebro 实例 #

Cerebro 参数配置说明

实例化参数 #

成员方法 #

内存优化与节省技巧

参数优化性能改进

异常处理与错误管理

日志记录与 Writer 输出

创建 `Cerebro` 实例
#

实例化参数
#

成员方法
#