调试 MQL5 程序：从编译到剖析的基础排查链路（基础篇）
（1/3）·写过 MQL5 却总被莫名报错卡住？理清编译、调试器与剖析工具的三段式地基
在 MT5 里跑通第一段 MQL5 调试
MQL5 的调试不是靠 Print 硬猜，而是直接用 MetaEditor 自带的调试器逐行跟。开 MT5 后按 F4 进 MetaEditor，在 EA 或指标源码里点行号左侧下断点，再切回 MT5 用「调试」模式启动，程序会在断点处停住并暴露变量当前值。 这套流程最早在 2014-03-24 的社区示例里被演示过，该帖累计浏览 5322 次、跟帖 26 条，说明手动断点调试是多数 MQL5 新手第一个卡点。你今天打开任意一段别人写的 EA，先别改逻辑，下个断点看报价变量怎么流动，比直接编译运行更能摸清结构。 外汇与贵金属品种点差跳变频繁，调试时务必用「每笔 tick」模式而非仅开盘价，否则变量在真实行情里的异常分支你根本看不见，这是高杠杆环境下的基础风险。
「调试到底是哪一步」
这套内容面向写过 MQL5 但还没独立搞定过完整开发的程序员，核心只聊一个事：调试阶段到底卡在哪儿。先说定义，调试是开发流程里专门用来检查并剔除执行错误的环节，你通过观察变量取值、被调函数以及调用时机来拿分析素材。 实际可用的手段就两类，且互为补充。其一是用调试器，它能把程序执行过程按步展开给你看；其二是把状态与函数调用记录打到屏幕、日志或文件里做交互式查看。 很多人以为调试是写完才做的事，其实从你点第一次编译就开始了。编译报错本身就是第一道调试，尤其对只懂变量和结构、没独自跑通过项目的人，先过编译这关比急着单步跟踪更实在。外汇与贵金属 EA 逻辑复杂，编译期暴露的类型错往往能省掉后续数小时的高风险实盘试错。
◍ 编译期先把语法雷排掉
MT5 里的 MetaEditor 编译器不生成原生机器码，而是把 MQL5 源码编成字节码，所以同一套程序在 32 位和 64 位系统都能跑，也方便做加密保护。
按 F7 或点 Compile 之后，Toolbox 的 Errors 选项卡会列出全部问题：红色是语法错误，不修完根本编不过；黄色是警告，能编出 ex5，但运行结果可能偏离预期。用光标高亮某一行描述再敲回车，编辑器直接跳到出错位置。
粗心最容易栽在标点混用上，比如声明变量时把分号写成逗号。下面三段里前一行编不过，后两行才合法：
警告真不能无视。MQL5 编译器会替你抓一类典型手滑——把判等 == 写成赋值 =。在 MQL5 里 if(a=b) 是合法语法（MQL4 不行），含义却变成先把 b 赋给 a 再判断 a 真假，逻辑直接翻车。编译器给这行挂黄标，就是在救你。
编译是调试第一关。红错必须清，黄警也得逐条核对，否则 ex5 能加载，单子可能下歪。外汇和贵金属杠杆高、波动猛，这类隐性逻辑错一旦进场就是实打实回撤。
<span class="keyword">class="type">int</span> a; b; <span class="comment">class=class="str">"cmt">// incorrect declaration</span> <span class="keyword">class="type">int</span> a, b; <span class="comment">class=class="str">"cmt">// correct declaration</span> <span class="keyword">class="type">int</span> a; <span class="keyword">class="type">int</span> b; <span class="comment">class=class="str">"cmt">// correct declaration</span> <span class="keyword">if</span>(a==b) { } <span class="comment">class=class="str">"cmt">// if a is equal to b, then ...</span> <span class="keyword">if</span>(a=b) { } <span class="comment">class=class="str">"cmt">// assign b to a, if a is true, then ... (unlike MQL4, it is applicable in MQL5)</span>
用调试器逐步揪出 MQL5 逻辑漏洞
MT5 的 MetaEditor 自带调试器（F5 启动），这是 MQL4 时代没有的能力。从 MQL4 转过来的老手也得重新适应这套仿真单步执行机制，它能在不跑实盘的情况下把程序逻辑走一遍。 调试器界面核心就六个键：F5 启动、Break 暂停、Shift+F5 停止；F11 步进入函数内部，F10 步过（跳过函数体看下一行），Shift+F11 步出当前函数。光知道按钮没用，得配合断点才有得看。 不设断点或 DebugBreak() 的话，按 F5 只会一路跑完报「调试成功」，你什么都观察不到。在可疑行按 F9 下断点，或手动写 DebugBreak() 跳过不关心的代码，调试器才会在那儿停住等你查。 停下来后看左侧窗：显示当前函数名和行号；右侧 Expression 栏填变量名（或 Shift+F9 加进监测），Value 里就出实时值。哪怕变量是局部声明、你还没进它的作用域，窗口也只显示 Unknown identifier 而不会崩——等单步走进作用域，类型和数值自然浮现。外汇与贵金属 EA 逻辑复杂，这种逐行看值的方式能帮你定位概率性报错，但调试通过不等于策略能盈利，市场高风险依旧。
「用剖析器揪出最慢的函数」
在 MT5 里点 MetaEditor 的 Start profiling，剖析器就会真正跑起你的指标或 EA，而不是像调试器那样逐行停顿。对于挂在图表上的程序，它会一直采集数据，直到你移掉图表对象或按 Stop profiling 才停。 跑完后得到的关键数据是：每个函数被调用次数、单次与累计执行耗时。这里有个容易踩的坑——百分比统计不扣除嵌套调用，所以所有函数的占比加总经常突破 100%，别拿它当整体份额看。 对外汇和贵金属 EA 来说，高频 tick 下某函数若占掉大部分时间，就是实盘滑点和掉帧的高风险源头。剖析器不直接改代码，但能明确指出该先优化哪一段、哪里能省内存。