MQL4到MQL5代码迁移完全指南：语法差异解析与EA适配实战要点
MQL4到MQL5代码迁移完全指南：语法差异解析与EA适配实战要点
有个数字我第一次看到时愣了下：MQL5 官方文档里，OrderSend 的参数列表有 13 个，而 MQL4 同名字段只有 11 个。多出来的不是装饰，是两个专门用来区分「订单」和「成交」的参数。很多从 MQL4 搬过来的 EA，编译能过，回测也能跑，一上模拟盘就开始出现重复开仓、止损挂不上、平仓平不掉。问题往往不在策略逻辑，而在这些看不见的语法差异上。
我自己也踩过这个坑。早些年把一套 MQL4 的均线突破 EA 往 MT5 上搬，代码复制过去改了几个函数名就编译，结果回测里每笔单子都开了两次。查了半天才发现，MQL4 里 PositionSelect 和 OrderSelect 混着用没感觉，MQL5 里订单、成交、持仓是三套账，不分开处理就会重复计数。这就是迁移最容易忽略的地方——不是语法报错，是语义变了。
先搞清楚：MQL5 把「一笔单」拆成了三件事
MQL4 的交易模型很简单，一个订单从头到尾就是一条记录，开仓、持仓、平仓都在 OrderSelect 里查。MQL5 不一样，它把交易生命周期拆成了订单（order）、成交（deal）、持仓（position）三个独立对象。
订单是「委托」，成交是「实际发生的买卖」，持仓是「当前还拿着的仓位」。一个市价单可能产生一笔订单加一笔成交，再形成一笔持仓；部分平仓时，一笔持仓会对应多笔成交。这套模型更贴近真实交易，但对从 MQL4 过来的人很不友好，因为你习惯的「遍历订单找持仓」在 MQL5 里得改成遍历持仓。
- MQL4 的 OrderSelect(i, SELECT_BY_POS, MODE_TRADES) 查的是当前挂单和持仓，MQL5 对应的是 PositionsTotal() 配合 PositionGetTicket()
- MQL4 的 OrderType() 返回值里 OP_BUY、OP_SELL 同时表示持仓方向，MQL5 里持仓方向用 POSITION_TYPE_BUY / POSITION_TYPE_SELL
- MQL4 平仓用 OrderClose(ticket, lots, price, slippage)，MQL5 没有这个函数，要用 CTrade 类的 PositionClose，或者自己封装 OrderSend 发反向单
注意：MQL5 里 OrderSend 的请求结构是 MqlTradeRequest，返回结构是 MqlTradeResult，两个结构体都得先清零再填字段。漏掉 ZeroMemory 是新手最常见的错误之一，残留字段会让服务器直接拒单。
那些编译不报错、运行时才出问题的差异
语法层面最隐蔽的是数组和字符串处理。MQL4 的字符串比较用 == 就行，MQL5 里虽然也支持，但涉及大小写和编码时行为不完全一致，稳妥做法是用 StringCompare。数组方面，MQL4 的动态数组可以用 ArrayResize 反复扩，MQL5 里如果数组作为函数参数传递，默认是引用传递，改一个地方会影响到调用方，这点跟 MQL4 的值传递习惯不同。
指标调用也是重灾区。MQL4 的 iMA、iRSI 这些函数直接返回句柄值当指标值用，MQL5 里它们返回的是指标句柄（handle），真正的数值要再用 CopyBuffer 去取。很多人迁移时直接把 iMA 的返回值当价格用，回测里信号全是乱的。
伪代码对比一下更直观：
MQL4 写法：double ma = iMA(NULL, 0, 20, 0, MODE_SMA, PRICE_CLOSE, 1);
MQL5 写法：int handle = iMA(_Symbol, _Period, 20, 0, MODE_SMA, PRICE_CLOSE); 然后用 double buf[]; CopyBuffer(handle, 0, 1, 1, buf); 取 buf[0]。
这里有个常见错误：CopyBuffer 的第三个参数是起始位置，第四个是数量，顺序搞反了会取到空数组，指标值全是 0，EA 就变成一直开多或者一直不开仓。建议在 OnInit 里就把句柄建好，放到全局变量，别在 OnTick 里反复创建，否则句柄泄漏会让 EA 越跑越慢。
参数配置与回测：迁移后先别急着看收益
迁移完代码，第一件事不是调参数，是验证行为一致性。同一套逻辑，MQL4 和 MQL5 跑同一段历史数据，信号数量应该接近。如果差很多，先查指标取值和持仓遍历，别急着改策略。
回测方法上，建议固定数据区间做对照，比如选一段有明显趋势和一段震荡的行情分别跑。参数用默认值先跑一遍，再改。评价指标看三个就够：交易次数、最大回撤、盈亏比。胜率可以看，但别当唯一标准。
示例参数配置（非真实回测结果，仅演示格式）：
- 品种：EURUSD，周期 H1，数据区间取近两年
- 均线周期：快线 20，慢线 60，止损 200 点，止盈 400 点
- 点差建模：固定 10 点，滑点 3 点
- 对照指标：交易次数差异控制在 10% 以内视为行为一致
注意：MQL5 策略测试器的「建模」选项里，真实 tick 和 OHLC 的结果可能差很多，迁移验证阶段建议先用 OHLC 快速跑通，再上真实 tick 复核。别拿不同建模方式的结果直接对比，那样得出的结论没意义。
部署到 VPS 前，先过一遍报错清单
代码在本地跑通，搬到 VPS 上又是另一回事。MQL5 的 EA 对运行环境更敏感，尤其是指标句柄和全局变量。常见的几个报错和排查方向：
- 「invalid handle」：指标句柄没建成功，检查 OnInit 里 iMA 的参数是否合法，品种名是否带后缀
- 「not enough money」：MQL5 的保证金计算和 MQL4 不同，尤其涉及锁仓和净值比例时，先确认账户是净额还是对冲模式
- 「trade disabled」：多半是 EA 属性里没勾选「允许算法交易」，或者品种交易时段限制
- 「order send failed 10009」：这个码通常表示请求已处理，不是错误，别看到非零就以为失败
VPS 选型上，延迟和稳定性比配置更重要。跑多品种 EA 的话，内存留够余量，别卡在临界值。经纪商方面，不同平台对品种命名和合约参数的处理有差异，比如 XM、Exness、IC Markets、Pepperstone 这些，有的品种带后缀，有的最小手数不同，迁移时要把 SymbolInfo 相关参数做成可配置，别写死。具体规则以各经纪商官网公布为准。
说个容易忽略的细节：MQL5 里 SymbolInfoDouble 取合约规格时，如果品种名拼错，返回的是 0 而不是报错，后面除零或者手数算成 0 就悄悄失败了。上线前加一句打印校验，能省很多排查时间。
最后提醒一句
迁移完、回测过、VPS 也部署好了，很多人会漏掉「日志分级」这一步。MQL5 的 Print 和 Comment 在实盘高频调用时会影响性能，把调试输出改成按日志级别开关，实盘只留关键错误。这个环节不显眼，但它是区分「能跑」和「跑得稳」的分界线。你在迁移 MQL4 代码时，最先卡住的是哪个函数？留言聊聊。
免责声明：本文仅代表作者观点，不构成任何投资建议。市场有风险，交易需谨慎。
