MQL5调试与排错完全指南：10个提升开发效率的实战技巧
MQL5调试与排错完全指南：10个提升开发效率的实战技巧
断点失效？日志看不懂？EA不交易？一文涵盖MQL5开发中常见的调试问题与解决方案
做EA开发的人都有体会：写代码的时间可能只占30%，剩下70%都在找bug。同样一个问题，新手可能要折腾好几天，老手十分钟就能定位。差距在哪里？就在调试方法上。
风险提示：本文内容仅为技术工具分享与原理探讨，不构成任何投资建议。本网站仅提供软件开发技术服务，不涉及任何交易平台运营或经纪业务。所有交易行为均由用户自行决策并承担相应风险。
MQL5的调试有它的特殊性：事件驱动架构、实时行情驱动、调试器有局限性。用传统的调式思路可能处处碰壁。今天分享10个实战技巧，覆盖从环境配置到高级调试的全场景，拿来就能用。
技巧1：调试环境正确配置——先确保工具能用
很多人调试出问题，其实是环境没配对，不是代码的问题。先检查这几项：
- 工具→选项→专家顾问→勾选"允许实时调试"
- EA属性→勾选"允许自动交易"和"允许DLL导入"
- 专家日志窗口打开（快捷键Ctrl+L）
操作参考：启动调试的四个快捷键要记牢：F5开始调试运行到断点，F9设置/取消断点，F10单步跳过（Step Over），F11单步进入（Step Into）。断点是空心圆表示无效（代码没编译或不是可执行行），实心红点才是有效断点。
技巧2：分级日志系统——Print的正确打开方式
很多人调试全靠Print，打一堆日志看不过来，关了又找不到问题。正确的做法是建立分级日志体系：
input int DebugLevel = 2; // 日志级别：0-3，数字越大日志越详细
void DebugPrint(int level, string msg)
{
if(level <= DebugLevel)
Print("[Debug", level, "] ", msg);
}
void ErrorPrint(string msg)
{
Print("[ERROR] ", msg);
}
知识点：四级日志的分工：Level 0只打错误（必须看），Level 1打关键操作（开仓、平仓、状态变化），Level 2打详细流程（条件判断、参数值），Level 3打调试细节（变量值、循环次数）。平时设为2级，出问题时调到3级排查。
图：MQL5四级日志分级体系
重点：分级日志是提升调试效率性价比较高的方法之一。花10分钟把你的日志系统改成分级的，以后排错速度至少提升50%。这也是许多专业EA开发团队的常用配置。
技巧3：断点不触发？5种情况逐个排查
设置了断点但调试器不停下来，几乎每个MQL5开发者都遇到过。按下面这5种情况逐个排查：
情况1：用了Sleep函数，调试器挂起
原因：Sleep会阻塞主线程，调试器无法响应。
解决：用OnTimer定时器+状态机的方式实现非阻塞延迟，不要用Sleep。
情况2：断点设在不会执行的代码上
比如if条件不满足的分支、注释掉的代码、空行、变量声明行。在函数入口设断点，然后单步跟进去看。
情况3：EA没有正确加载
图表右上角笑脸是红的或没有笑脸→EA没运行。检查AutoTrading按钮是否开启、EA属性是否允许交易。
情况4：OnTick没有被调用
没有行情数据或图表品种不对。在OnTick第一行加Print看有没有输出。检查右下角连接状态是否正常。
情况5：行情太快断点来不及（M1及以下周期）
小周期tick太快，断点还没反应过来就过了。换大周期调试，或者用条件断点+日志代替。
风险：Sleep函数是MQL5调试中的常见陷阱。不仅断点会失效，连整个MT5界面都会卡住。生产代码中也要尽量避免使用Sleep，改用状态机+定时器的非阻塞方案，既好调试又不卡顿。
技巧4：EA不交易？按这个流程图5步排查
"EA挂上去了，笑脸是绿的，但就是不开单"——这是经常被问到的问题。按下面这5步走，大多数情况能定位到原因。
图：EA不交易5步诊断流程
Step 1：看笑脸状态——EA有没有运行？
红笑脸/没笑脸→EA没运行。检查AutoTrading按钮、EA属性设置、是否编译成功。绿笑脸→EA在运行，继续下一步。
Step 2：看专家日志——有没有报错？
有OnInit error→初始化失败，查错误码。有报错信息→按错误信息排查。没有任何输出→OnTick没被调用，检查行情连接。正常初始化但没开仓→继续下一步。
Step 3：看信号条件——为什么没触发？
开debug模式（把DebugLevel调到3），看每个条件判断的结果。常见原因：时间过滤器不在交易时段、波动率过滤器ATR不满足、仓位过滤器已有持仓只允许一单、资金过滤器保证金不足。
Step 4：看Journal日志——订单有没有被拒？
EA发了订单但被拒绝→Journal里有记录。常见拒绝原因：止损太近（小于stops level）、报价失效（off quotes）、保证金不足、交易被禁用。
Step 5：终极排查——二分法加日志
以上都没找到问题，就在代码关键节点加日志，像二分查找一样逐步缩小范围，看执行到哪一步停了。
操作参考：一个快速验证技巧：在开仓函数的入口处故意打一条明显的日志（比如"=== 开仓函数被调用了 ==="）。如果日志里有这条但没开仓→问题在开仓函数内部。如果日志里没有→问题在信号判断那边，开仓函数根本没被调用。一下就能缩小一半范围。
技巧5：用好GetLastError——错误码不是摆设
很多MQL5函数失败了只返回false，不说原因。这时候GetLastError就是你的好帮手。
bool result = trade.Buy(0.01, _Symbol);
if(!result)
{
int err = GetLastError();
Print("开仓失败，错误码：", err,
"，原因：", ErrorDescription(err));
}
下面是10个高频出现的错误码，建议收藏：
| 错误码 | 名称 | 原因与解决 |
|---|---|---|
| 130 | ERR_INVALID_STOPS | 止损止盈太近，检查stops level，设远一点 |
| 131 | ERR_INVALID_PRICE | 价格精度不对，用NormalizeDouble规整 |
| 133 | ERR_TRADE_DISABLED | 交易被禁用，开启EA属性的允许交易 |
| 135 | ERR_OFF_QUOTES | 报价失效，重试或增大滑点容忍 |
| 136 | ERR_CHANGE_PRICE | 价格已变，重新获取价格再下单 |
| 148 | ERR_TRADE_TOO_MANY_ORDERS | 订单太多，减少挂单数量 |
| 4009 | ERR_TRADE_NOT_ALLOWED | 不允许交易，检查EA属性设置 |
| 4109 | ERR_TRADE_CONTEXT_BUSY | 交易上下文忙，等一下重试，别连续发单 |
| 4110 | ERR_LONG_ONLY | 只允许做多，卖单被拒 |
| 4111 | ERR_SHORT_ONLY | 只允许做空，买单被拒 |
知识点：GetLastError返回的是上一次操作的错误码，而且调用一次后就会重置为0。所以要在失败后立刻调用，中间不能插其他函数调用，否则错误码可能被覆盖。这是新手常踩的坑。
技巧6：变量监视与条件断点——精准定位
断点不只是"到这就停"，还可以更智能。
监视窗口：把关键变量拖到监视窗口，断点停下时可以实时查看值。支持数组、结构体、类对象的展开查看。
条件断点：不是每次到这都断，而是满足某个条件才断。比如"循环第100次才出问题"、"某个变量超过阈值时断"。用法：右键断点→条件→输入布尔表达式。
调用堆栈：看当前函数是被谁调用的，一层一层往上追。特别适合递归、回调、事件处理中的问题——你知道出问题了，但不知道是谁触发的。
进阶原理：条件断点的工作原理是：调试器在每个断点处检查条件，如果不满足就自动继续执行。所以如果条件断点设在高频执行的代码上（比如OnTick里），会明显减慢执行速度。调试完记得关掉或改成普通断点。
技巧7-10：快速掌握剩余四个技巧
技巧7：回测中的调试技巧
回测是调试的好帮手——速度可控、数据可重复、环境隔离。三个技巧：①先用少量数据（1个月）快速验证，没问题再用全量；②可视化模式按空格键单步前进，看每一步发生了什么；③回测完导出日志，用筛选功能分析。
进阶原理：回测调试的核心优势是"可复现"——同样的数据跑两次，结果完全一样。这意味着你可以反复验证bug，不用担心环境变化。实盘调试就做不到这一点，因为行情一直在变。所以建议90%的逻辑bug都应该在回测阶段解决掉，带到实盘的只能是和实盘特有的问题。
技巧8：实盘调试的安全姿势
风险：实盘调试有真实亏损风险，务必谨慎。安全调试5原则：优先用模拟盘、必须实盘时用最小手数、开启只读模式（只打日志不下单）、设置硬止损、调试时全程盯着，出问题立刻停止。
技巧9：性能调试——EA为什么这么卡？
定位性能瓶颈的方法：用GetTickCount()给每个函数计时，看谁花的时间最多。常见瓶颈：OnTick里做太复杂的计算→移到OnTimer；频繁调用CopyBuffer→缓存结果；字符串拼接太多→减少优化。
技巧10：状态机+断言——高级调试思维
把EA的运行状态明确化（初始化、待机、开仓、持仓、平仓、错误），出问题时一看状态就知道卡在哪了。再加断言（Assert）验证"应该成立"的条件，不成立立刻报错，把问题扼杀在开发期。
重点：调试能力 = 经验 + 方法 + 工具。10个技巧不可能一次全学会，但分级日志（技巧2）和EA不交易诊断流程（技巧4）是性价比较高的，建议尽早实践。如果你的EA有问题自己排查不了，可以联系我们做EA诊断和修复服务。
风险提示：本文内容仅为技术工具分享与原理探讨，不构成任何投资建议。本网站仅提供软件开发技术服务，不涉及任何交易平台运营或经纪业务。所有交易行为均由用户自行决策并承担相应风险。
🎬 关注晓辉编程视频号
MT4/MT5 EA开发实战 | 技术方法探讨 | 编程技巧干货
微信搜索：晓辉编程
💬 添加晓辉为好友
免费领取《MQL5调试工具包》 | EA问题诊断 | 进技术交流群
微信号：XiaoHuiProgramming 回复【调试工具包】