一、指标基类与生命周期：深入理解 Indicator 基类

说实话，Backtrader 的指标系统，我刚开始接触时也觉得有点绕。但后来我发现，只要搞懂了它的生命周期，一切就豁然开朗了。今天我们就来聊聊 Indicator 基类，以及那几个关键的生命周期方法。

1.1 Indicator 基类：一切指标的起点

在 Backtrader 里，所有自定义指标都要继承 bt.Indicator。这个基类就像个骨架，帮你搭好了数据流、参数管理、绘图配置这些基础设施。你只需要往里面填自己的逻辑就行。

我个人习惯，写一个新指标前，先想清楚三件事：

• 输入数据：用 lines 定义输出线
• 参数配置：用 params 定义可调参数
• 绘图设置：用 plotinfo 控制图表样式

这三样东西，都是在类定义阶段就初始化好的。嗯，这里要注意，它们的初始化时机非常早——早于任何数据到达之前。

1.2 生命周期方法：从初始化到计算完成

一个指标从创建到输出结果，会经历几个阶段。我把它画成了下面这张图，方便你理解：

1.3 __init__：搭建计算框架

__init__ 是实例化时调用的。你想想看，这时候数据还没开始流动，所以你不能在这里做实际计算。那它用来干嘛？

• 定义计算所需的中间变量
• 注册子指标或数据源
• 设置计算所需的参数

举个例子，我写一个简单的 SMA 指标：

class MySMA(bt.Indicator):
    lines = ('sma',)  # 定义输出线
    params = (('period', 20),)  # 定义参数
    
    def __init__(self):
        # 这里只是搭建计算逻辑，不实际计算
        # 使用内置的 MovingAverageSimple 作为子指标
        self.addminperiod(self.params.period)
        self.lines.sma = bt.ind.MovingAverageSimple(
            self.data, period=self.params.period
        )

我曾经犯过一个错误：在 __init__ 里直接访问 self.data[0] 想获取当前值。结果发现拿到的全是 0。为什么？因为这时候数据还没加载进来呢！

1.4 next 与 once：逐点计算 vs 批量计算

这两个方法，是实际干活的地方。

next：每个 bar 调用一次。适合逻辑简单、需要逐笔判断的场景。比如：

def next(self):
    # 每个 bar 都会执行这里
    self.lines.sma[0] = sum(
        self.data.get(size=self.params.period)
    ) / self.params.period

once：一次性计算所有 bar。适合计算密集型指标，性能更好。比如：

def once(self, start, end):
    # start 和 end 是数组的起止索引
    data_array = self.data.array
    for i in range(start, end):
        self.lines.sma[i] = sum(
            data_array[i-self.params.period+1:i+1]
        ) / self.params.period

我个人习惯，如果指标逻辑不复杂，优先用 next。代码更直观，调试也方便。但如果你要处理几千只股票、上万根 K 线，那 once 的性能优势就体现出来了。

1.5 prenext 与 preonce：最小周期前的准备

这两个方法，很多人容易忽略。但它们其实很重要。

你想想看，一个 20 日均线，前 19 根 K 线是算不出值的。那这段时间怎么办？Backtrader 提供了 prenext 和 preonce 来处理这个「预热期」。

def prenext(self):
    # 最小周期未满足时，用已有数据计算
    # 或者直接赋默认值
    self.lines.sma[0] = self.data[0]  # 简单填充

如果不重写 prenext，默认行为是输出 NaN。这在某些策略里会导致问题——比如你用了 if self.sma[0] > self.data[0]，NaN 参与比较会返回 False，可能错过交易信号。

我记得有一次做期货策略，就因为没处理 prenext，导致前 20 个 bar 全部没有信号，错过了开仓时机。后来加了个简单的填充逻辑，问题就解决了。

1.6 lines、params、plotinfo 的初始化时机

这三个东西，很多人搞不清它们什么时候生效。我直接给你总结成表格：

属性	初始化时机	能否动态修改	典型用途
lines	类加载时	不能	定义输出线名称和数量
params	类加载时	实例化时可覆盖	定义可调参数
plotinfo	类加载时	实例化后可修改	控制绘图样式

说白了，lines 就像你盖房子时的承重墙——一旦定下来就不能改。而 params 和 plotinfo 就像软装——可以后期调整。

1.7 实战建议：如何组织你的指标代码

根据我的经验，一个清晰的自定义指标应该这样组织：

1. 先写类定义：明确 lines、params、plotinfo
2. 再写 __init__：搭建计算框架，注册子指标
3. 然后写 next/once：实现核心计算逻辑
4. 最后写 prenext/preonce：处理边界情况

嗯，这里要注意，prenext 和 preonce 不是必须的。如果你的指标在最小周期前不需要特殊处理，可以省略。但如果你要保证指标从第一根 bar 就有值，那就得实现它们。

好了，关于指标基类和生命周期，就聊这么多。记住一句话：理解生命周期，你就掌握了 Backtrader 指标开发的钥匙。

---

公众号:蓝海资料掘金营，微信deep3321