MQL5 指标调用入门：句柄、缓冲区与安全编程

一、什么是指标句柄

MQL5 里，指标不是直接算出来的值，而是一个「句柄（handle）」——你向终端申请「我要用某个指标」，它返回一个整数句柄，之后用 CopyBuffer 从这个句柄取数据。句柄机制让指标计算在终端内部高效缓存，EA 反复取数不必重算。

理解句柄是理解 MQL5 指标调用的关键：你把「指标配方」交给终端，它给你一个取数窗口。这个窗口在 OnInit 里建一次，OnCalculate/OnTick 里反复用，而不是每次都重新创建。

二、用 iMA / iRSI 等创建句柄

iMA、iRSI、iMACD 等内置函数返回句柄。参数要写全：品种、周期、各指标专属参数、应用的价位（如 PRICE_CLOSE）。句柄创建失败会返回 INVALID_HANDLE，必须检查，否则后续 CopyBuffer 全拿不到数据。

int maHandle = iMA(_Symbol, _Period, 20, 0, MODE_SMA, PRICE_CLOSE);
if(maHandle == INVALID_HANDLE) { Print("iMA failed"); return; }

三、用 CopyBuffer 取数据

CopyBuffer(handle, buffer_index, start_pos, count, array) 把指标某条缓冲线（如 MACD 的 main、signal）的若干根 K 线数据拷进数组。buffer_index 从 0 开始，具体哪个是主线哪个是信号线要看指标定义。返回拷贝的条数，小于预期说明数据不足。

double ma[3];
int n = CopyBuffer(maHandle, 0, 0, 3, ma);
if(n < 3) { Print("copy failed"); return; }
double maPrev = ma[1], maLast = ma[0];

四、句柄的生命周期与释放

句柄在 OnInit（或构造函数）里创建，在 OnDeinit（或析构）里用 IndicatorRelease(handle) 释放，避免资源泄漏。反复在 OnTick 里创建句柄而不释放，会耗尽句柄额度，导致后续指标全部失效——这是常见的隐蔽 bug。

五、自定义指标的句柄

对自己写的 custom indicator，用 iCustom(_Symbol, _Period, 'indicator_name', param1, param2, ...) 取得句柄，参数顺序必须和指标输入参数完全一致。iCustom 的容错性差，参数错一个就可能拿到空数据，务必对照指标源码核对。

六、常见错误清单

• 不检查返回值是否为 INVALID_HANDLE
• 在 OnTick 反复创建句柄不释放
• CopyBuffer 的 buffer_index 写错（主线/信号线混淆）
• iCustom 参数顺序与指标输入不一致
• 取数 start_pos 越界导致拿到空数组

七、调试句柄问题

句柄相关的 bug 往往表现为「指标值全是 0 或 EMPTY」。排查顺序：先看 iXxx 返回值是否 INVALID_HANDLE，再看 CopyBuffer 返回条数，最后打印前几根值确认缓冲区内容。把这三步固化成习惯，能省下大把调试时间。

八、多周期指标取数

实战常在 EA 里取更高周期指标（如 H1 的 MA）做过滤：iMA(_Symbol, PERIOD_H1, ...) 指定周期即可。但注意数据同步——高周期 K 线在低级周期 tick 上并非实时更新，当前高周期 K 线可能还没收盘。若直接用其最新值做信号，会悄悄变成未来函数。正确做法是明确区分「已收盘的高周期 K 线」与「正在形成的高周期 K 线」，只用前者。

九、句柄与多线程测试器

测试器的遗传优化会并行跑多个 EA 副本，每个副本独立建句柄、互不干扰。但如果你把句柄存成全局且假设唯一，某些写法下可能串味。养成『句柄随 EA 实例走、退出即释放』的习惯，多线程优化才不会出怪问题，回测结果才可信。

10、小结