从新手到专家：MQL5中的协作式调试指南（基础篇）
MQL5 里调试到底在查什么
调试在 MQL5 里不是“让程序跑通”这么简单，核心动作是定位 EA、指标或脚本在实时或测试环境下偏离预期的那一行逻辑。MT5 自带的调试器能挂到策略测试器或图表事件上，断点命中后可直接看变量快照。 原文给出的落地路径分两步：先找 bug，再选调试技术。找 bug 阶段靠编译器报错和运行时异常（比如数组越界、无效指针）缩小范围；技术层面归纳了三种可用手段，覆盖从打印日志到断点单步的不同粒度。 对外汇与贵金属自动化而言，这类排查直接关系实盘资金——策略在回测里不报错不代表直播不崩。建议开 MT5 后随便挂一个自带 EA，故意写错一处数组下标，亲自走一遍断点流程，比看文档来得快。
「编译器抛错报告怎么读」
在 MT5 里写 MQL5，编译报错是日常而非意外。一个中等规模项目编译时可能一次刷出 50 行红字，但真正要紧的不是数量，而是报告的四列结构：描述、文件、行、列。 描述列告诉你错误性质，比如“wrong parameters count”就是参数个数不对；文件列定位到具体 mq5，例如 D1 PriceMarker.mq5；行号让你直接跳过去；列号在单行塞了多个函数调用时才显出价值。 下面这段真实报错样本来自一个带漏洞的示例：连续 7 处 ObjectDelete 调用在 70–76 行全报“wrong parameters count”，编译器提示内置原型是 bool ObjectDelete(long, const string)。这说明原代码大概率只传了对象名、漏了图表 ID。外汇与贵金属 EA 调试高风险，参数错可能导致订单对象误删，先在策略测试器隔离验证再上真仓。 协作调试比单啃教程快。许多人读不完免费的长篇 MQL5 文档，但边改一个真项目边查对应章节，完成时就自然吃透了相关语法。下面代码块就是本次要一起修的那份报告原文。
<span style="background-class="type">color:rgb(class="num">255, class="num">221, class="num">0);"> &class="macro">#x27;D1 PriceMarker.mq5&class="macro">#x27; </span> <span class="number">class="num">1</span> &class="macro">#x27;<span class="functions">ObjectDelete</span>&class="macro">#x27; - wrong parameters count D1 PriceMarker.mq5 <span class="number">class="num">70</span> <span class="number">class="num">5</span> built-in: <span class="keyword">class="type">bool</span> <span class="functions">ObjectDelete</span>(<span class="keyword">class="type">long</span>,<span class="keyword">const</span> <span class="keyword">class="type">class="kw">string</span>) D1 PriceMarker.mq5 <span class="number">class="num">70</span> <span class="number">class="num">5</span> &class="macro">#x27;<span class="functions">ObjectDelete</span>&class="macro">#x27; - wrong parameters count D1 PriceMarker.mq5 <span class="number">class="num">71</span> <span class="number">class="num">5</span> built-in: <span class="keyword">class="type">bool</span> <span class="functions">ObjectDelete</span>(<span class="keyword">class="type">long</span>,<span class="keyword">const</span> <span class="keyword">class="type">class="kw">string</span>) D1 PriceMarker.mq5 <span class="number">class="num">71</span> <span class="number">class="num">5</span> &class="macro">#x27;<span class="functions">ObjectDelete</span>&class="macro">#x27; - wrong parameters count D1 PriceMarker.mq5 <span class="number">class="num">72</span> <span class="number">class="num">5</span> built-in: <span class="keyword">class="type">bool</span> <span class="functions">ObjectDelete</span>(<span class="keyword">class="type">long</span>,<span class="keyword">const</span> <span class="keyword">class="type">class="kw">string</span>) D1 PriceMarker.mq5 <span class="number">class="num">72</span> <span class="number">class="num">5</span> &class="macro">#x27;<span class="functions">ObjectDelete</span>&class="macro">#x27; - wrong parameters count D1 PriceMarker.mq5 <span class="number">class="num">73</span> <span class="number">class="num">5</span> built-in: <span class="keyword">class="type">bool</span> <span class="functions">ObjectDelete</span>(<span class="keyword">class="type">long</span>,<span class="keyword">const</span> <span class="keyword">class="type">class="kw">string</span>) D1 PriceMarker.mq5 <span class="number">class="num">73</span> <span class="number">class="num">5</span> &class="macro">#x27;<span class="functions">ObjectDelete</span>&class="macro">#x27; - wrong parameters count D1 PriceMarker.mq5 <span class="number">class="num">74</span> <span class="number">class="num">5</span> built-in: <span class="keyword">class="type">bool</span> <span class="functions">ObjectDelete</span>(<span class="keyword">class="type">long</span>,<span class="keyword">const</span> <span class="keyword">class="type">class="kw">string</span>) D1 PriceMarker.mq5 <span class="number">class="num">74</span> <span class="number">class="num">5</span> &class="macro">#x27;<span class="functions">ObjectDelete</span>&class="macro">#x27; - wrong parameters count D1 PriceMarker.mq5 <span class="number">class="num">75</span> <span class="number">class="num">5</span> built-in: <span class="keyword">class="type">bool</span> <span class="functions">ObjectDelete</span>(<span class="keyword">class="type">long</span>,<span class="keyword">const</span> <span class="keyword">class="type">class="kw">string</span>) D1 PriceMarker.mq5 <span class="number">class="num">75</span> <span class="number">class="num">5</span> &class="macro">#x27;<span class="functions">ObjectDelete</span>&class="macro">#x27; - wrong parameters count D1 PriceMarker.mq5 <span class="number">class="num">76</span> <span class="number">class="num">5</span> built-in: <span class="keyword">class="type">bool</span> <span class="functions">ObjectDelete</span>(<span class="keyword">class="type">long</span>,<span class="keyword">const</span> <span class="keyword">class="type">class="kw">string</span>) D1 PriceMarker.mq5 <span class="number">class="num">76</span> <span class="number">class="num">5</span>
◍ D1 PriceMarker 编译报错的参数与标识符坑
在 MT5 里编译 D1 PriceMarker.mq5 时，编译器直接甩出一堆错误，集中在 15、27、37、41、77 行。最显眼的是 ObjectCreate 和 ObjectDelete 的「wrong parameters count」——内置签名要求 ObjectDelete(long,const string)，而 ObjectCreate(long,const string,ENUM_OBJECT,int,datetime,double,...) 最少要 6 个实参，老脚本按旧版 3 参数写法必然挂。 第 37 行更乱：ObjectSetText 报 undeclared identifier，后面紧跟一连串 ',' unexpected token 和 '+' illegal operation use。典型原因是把 labelName 当变量拼接进函数却没先声明，或者少了分号导致表达式被截断，编译器读到第 87 列才遇到 ')' unexpected token。 第 41 行 OBJPROP_Y 未声明，紧接着 ObjectSetInteger 重载匹配失败。MQL5 里纵坐标属性枚举是 OBJPROP_YDISTANCE 或 OBJPROP_YOFFSET，直接写 OBJPROP_Y 编译器不认，两个重载 bool ObjectSetInteger(long,const string,ENUM_OBJECT_PROPERTY_INTEGER,long) 都接不住。 开 MT5 载入该 ea 前，先按上面行号把参数个数和枚举名改对，否则策略连加载都做不到，外汇与贵金属品种波动大，脚本跑不起来就谈不上风控。
编译报错时先盯住 ObjectSetInteger 的调用签名
MT5 编译器在终端里报出的调用信息，最直接的用途是定位对象属性写入函数的用法偏差。上面这段构建日志显示，D1 PriceMarker.mq5 第 41 行调用了内置函数 ObjectSetInteger，参数为 long、const string、ENUM_OBJECT_PROPERTY_INTEGER、int、long 五类，而本次构建共抛出 20 个错误与 4 个警告，错误密度集中在 21 行附近的第 5 列。 ObjectSetInteger 的第五个参数在文档语义里是 long 型属性值，若你传了普通 int 字面量或把颜色、宽度等枚举错填进整型槽位，就会触发整型属性不匹配的类错误。开 MT5 把光标放到报错行，对照函数签名逐一核对参数顺序，比全局搜错误码更快。 外汇与贵金属图表上挂对象属于高风险环境下的脚本操作，参数写错可能导致标记错位却不报致命错，建议先在模拟账户验证绘制逻辑。
built-in: class="type">bool ObjectSetInteger(class="type">long,const class="type">class="kw">string,ENUM_OBJECT_PROPERTY_INTEGER,class="type">int,class="type">long) D1 PriceMarker.mq5 class="num">41 class="num">5 class="num">20 errors, class="num">4 warnings class="num">21 class="num">5