Indie 脚本禁止使用 global 关键字，需通过类成员变量（如 self.global_value）或 Var/MutSeriesF 等内置类型实现跨周期状态存储；本文详解两种典型场景下的正确实践与选型逻辑。
indie 脚本禁止使用 `global` 关键字，需通过类成员变量（如 `self.global_value`）或 `var`/`mutseriesf` 等内置类型实现跨周期状态存储；本文详解两种典型场景下的正确实践与选型逻辑。
在 Indie 脚本开发中，常见的误区是试图用 Python 原生 global 声明维持跨 K 线的状态——这不仅会触发 "global statements are prohibited" 编译错误，更违背 Indie 的执行模型：每个计算周期（bar）独立调用、无共享全局作用域。正确的持久化方案必须依托 Indie 提供的上下文生命周期管理机制。
✅ 推荐方案一：使用类成员变量（适用于“实时持续更新”场景）
当需要在每根 K 线上更新并立即使用最新值（例如记录最近收盘价、累计计数），且不关心回溯测试中的中间状态还原时，直接将变量定义为类实例属性即可：
# indie:lang_version = 5
from indie import indicator, param, plot, color, MainContext
@indicator("Persistent Value Demo")
@param.int("length", default=10, min=1, title="Length")
@plot.line("last_close", color=color.BLUE, title="Last Close Price")
class Main(MainContext):
def __init__(self):
self.last_close = 0.0 # 初始化为浮点数，确保类型安全
def calc(self, length):
self.last_close = self.close[0] # 每根K线更新一次
return self.last_close
⚠️ 注意：此类变量在实时行情中持续有效，但在历史回测中若发生重绘（如指标参数变更或图表缩放），Indie 会自动重建实例，因此该值不会“回滚”到历史某根 K 线的状态——它只反映当前运行上下文的最新快照。
✅ 推荐方案二：使用 Var 或 MutSeriesF（适用于“历史可追溯”场景）
若需变量行为与价格序列一致（例如在策略回测中精确复现每根 K 线的历史值，支持 self.xxx[1] 访问前一根值），应使用 Var（单值缓存）或 MutSeriesF（动态浮点序列）：
from indie import indicator, param, plot, color, Var, MutSeriesF
@indicator("History-Aware Counter")
@plot.line("counter", color=color.ORANGE, title="Bar Counter")
class Main(MainContext):
def __init__(self):
self.counter = Var(0) # 初始化为0，支持索引访问（如 self.counter[1]）
def calc(self):
self.counter.set(self.counter.get() + 1) # 自增
return self.counter.get()
-
Var(T)：轻量级单值容器，支持.get()/.set()和历史索引（[0],[1],[2]…），适合计数器、标志位等简单状态。 -
MutSeriesF：功能更全的可变浮点序列，适合需累积计算（如移动平均中间值）、多步依赖的复杂逻辑。
? 总结选型原则
| 需求场景 | 推荐类型 | 特点 |
|---|---|---|
| 实时盯盘、仅需当前最新值 | 类成员变量（self.xxx） |
最简、高效，无历史回溯能力 |
回测一致性、需访问历史值（如 self.x[1]） |
Var 或 MutSeriesF
|
与 self.close 行为对齐，支持完整序列操作 |
| 多周期协同、状态需随图表缩放/重绘自动恢复 | 必须用 Var/MutSeriesF
|
Indie 运行时会自动管理其生命周期 |
切记：Indie 不是通用 Python 环境，其核心设计围绕确定性、可重现的时序计算展开。放弃 global，拥抱 self 与 Var，是写出健壮、可维护 Indie 指标的起点。
