MQL5 · Bases du langage
Bien utiliser MetaEditor : compilation, débogueur et profileur MQL5
Compiler sans se perdre dans les erreurs, déboguer pas à pas sur données réelles ou historiques, espionner des variables et profiler un EA : les fonctions essentielles de MetaEditor et leurs raccourcis.
MetaEditor est l’environnement de développement livré avec MetaTrader 5. Il sert à écrire le code, à le compiler (touche F7) pour produire le fichier exécutable .ex5, à le déboguer pas à pas avec des points d’arrêt (F9), soit sur des données réelles (F5), soit sur l’historique dans le Strategy Tester (Ctrl+F5), et à le profiler pour mesurer où le programme passe son temps. Maîtriser ces trois fonctions vous fera gagner plus de temps que n’importe quelle astuce de code : la plupart des bugs d’un Expert Advisor se trouvent en quelques minutes avec un point d’arrêt bien placé, là où des dizaines de messages Print() n’y parviennent pas toujours.
Cette page fait partie de la rubrique Les bases du langage MQL5.
Organisation de l’interface
MetaEditor s’ouvre depuis le terminal par le bouton dédié de la barre d’outils ou la touche F4. L’interface comporte trois zones principales :
- le Navigateur, qui affiche l’arborescence du dossier MQL5 :
Experts,Indicators,Scripts,Include,Libraries,Files; - l’éditeur, avec coloration syntaxique, complétion automatique des noms de fonctions et de constantes, et aide contextuelle (F1 sur un mot-clé ouvre sa page de documentation) ;
- la Boîte à outils, en bas, dont les onglets affichent les erreurs de compilation, les résultats de recherche, l’état du débogage et les résultats du profileur.
Les fichiers source portent l’extension .mq5 pour les programmes et .mqh pour les fichiers inclus. Les programmes doivent se trouver dans le dossier de données du terminal, sous MQL5, pour apparaître dans le Navigateur du terminal après compilation.
Compiler
La compilation se lance avec F7 ou le bouton Compiler. Selon l’aide de MetaEditor, l’exécutable .ex5 est généré dans le même dossier que le fichier source principal. Les erreurs et avertissements apparaissent dans l’onglet Erreurs de la Boîte à outils et sont également signalés dans le code. Un double-clic sur une erreur, ou la commande « Aller à la ligne » du menu contextuel, place le curseur à la ligne et à la colonne concernées.
Deux règles de lecture des messages :
- corrigez la première erreur d’abord : une accolade manquante ou un point-virgule oublié peut provoquer une cascade de messages qui disparaissent ensemble ;
- ne négligez pas les avertissements : ils ne bloquent pas la compilation, mais signalent souvent une vraie erreur de logique, comme une conversion qui perd des données ou une variable utilisée sans être initialisée.
Les messages les plus fréquents et leur correction sont regroupés dans Erreurs de compilation fréquentes.
Options de compilation
L’aide décrit deux réglages. L’optimisation peut être maximale ou désactivée : la désactiver accélère la compilation pendant le développement, tandis que la version finale doit être compilée avec l’optimisation. L’architecture du processeur cible peut être choisie (X64 standard ou variantes exploitant les instructions AVX) ; l’aide recommande la version X64 standard pour un programme distribué, afin d’assurer la plus large compatibilité.
Déboguer
Le débogueur exécute le programme sous contrôle de MetaEditor et permet de l’arrêter à un endroit précis pour examiner les variables.
Lancer une session
- Sur données réelles (F5) : le programme tourne sur un graphique spécial alimenté par les prix en direct du serveur. Utile pour vérifier le comportement sur les ticks réels, mais il faut attendre que les conditions se produisent.
- Sur données historiques (Ctrl+F5) : le programme tourne dans le Strategy Tester. On peut reproduire à volonté une situation passée, y compris un week-end. Le symbole, la période et l’intervalle de test se règlent dans les paramètres de MetaEditor, onglet Débogage.
Points d’arrêt et pas à pas
Un point d’arrêt se pose par un double-clic dans la marge grise à gauche d’une ligne, ou en plaçant le curseur sur la ligne et en appuyant sur F9 (un second appui le désactive). Quand l’exécution atteint ce point, elle s’interrompt et l’onglet Débogage affiche la pile des appels. On avance ensuite avec les commandes suivantes :
| Commande | Raccourci | Effet |
|---|---|---|
| Pas à pas détaillé | F11 | Entre dans la fonction appelée |
| Pas à pas principal | F10 | Exécute la ligne sans entrer dans les fonctions |
| Pas à pas sortant | Maj+F11 | Termine la fonction courante et remonte d’un niveau |
| Reprendre | F5 | Continue jusqu’au prochain point d’arrêt |
| Arrêter | Maj+F5 | Termine la session de débogage |
Expressions espionnées
La liste des expressions espionnées affiche la valeur de variables ou d’expressions à chaque arrêt. L’aide précise qu’elle accepte des calculs simples, l’accès aux éléments de tableau (par exemple A[3][4]) et aux membres des objets. Ajouter « Local » affiche automatiquement toutes les variables de la portée courante. Le suffixe ,b ou ,x après une expression entière l’affiche en binaire ou en hexadécimal, pratique pour lire des drapeaux.
DebugBreak et _DEBUG
La fonction DebugBreak() place un point d’arrêt dans le code lui-même : la documentation précise qu’elle n’interrompt l’exécution que si le programme est lancé en mode débogage, et qu’elle est sans effet sinon. On l’utilise pour s’arrêter sur une condition rare, par exemple quand un lot calculé est négatif. La macro _DEBUG, définie lors des compilations de débogage, permet d’inclure du code de diagnostic qui disparaît de la version finale (voir #include, #define et #property). À l’exécution, MQLInfoInteger(MQL_DEBUG) indique si le programme tourne en mode débogage.
L’aide de MetaEditor déconseille de distribuer les fichiers .ex5 produits lors du débogage : recompilez toujours la version finale avec F7.
Profiler
Le profileur mesure le temps passé dans chaque fonction et chaque ligne. Il se lance depuis le menu Débogage avec « Démarrer le profilage sur données réelles » ou « sur données historiques » ; MetaEditor compile automatiquement une version adaptée. L’aide indique que le profilage sur historique utilise toujours le mode non visuel du testeur.
La méthode est l’échantillonnage : le programme est interrompu environ 10 000 fois par seconde et le profileur note la position et la pile d’appels. Les résultats apparaissent dans l’onglet Profileur de la Boîte à outils, présentés par fonctions ou par lignes, avec deux mesures : Total CPU (présence de la fonction n’importe où dans la pile) et Self CPU (interruptions survenues directement dans la fonction), cette dernière étant l’indicateur principal pour repérer les goulots d’étranglement. Les lignes coûteuses sont aussi surlignées dans le code, et les résultats peuvent être exportés. L’optimisation des performances est approfondie dans Profiler et optimiser son code.
Exemple : un script préparé pour le débogage
//+------------------------------------------------------------------+
//| Script : DebugBreak, _DEBUG et MQL_DEBUG |
//+------------------------------------------------------------------+
void OnStart()
{
if(MQLInfoInteger(MQL_DEBUG))
Print("Execution en mode debogage");
double closes[];
ArraySetAsSeries(closes, true);
int n = CopyClose(_Symbol, _Period, 0, 100, closes);
if(n <= 0)
{
Print("CopyClose a echoue, erreur ", GetLastError());
return;
}
double somme = 0.0;
for(int i = 0; i < n; i++)
{
somme += closes[i]; // poser un point d'arret ici (F9) et espionner "i" et "somme"
if(closes[i] <= 0.0)
DebugBreak(); // arret uniquement en mode debogage, sur une valeur anormale
}
#ifdef _DEBUG
PrintFormat("[DEBUG] %d valeurs lues, somme %.5f", n, somme);
#endif
PrintFormat("Moyenne des %d dernieres clotures : %.*f", n, _Digits, somme / n);
}
Ouvrez ce script dans MetaEditor, posez un point d’arrêt sur la ligne de la somme, lancez Ctrl+F5 et avancez avec F10 en observant i et somme dans la liste des expressions espionnées.
Bonnes pratiques
- Compilez souvent : quelques lignes, puis F7. Une erreur est plus facile à localiser dans un code qui compilait une minute plus tôt.
- Déboguez sur historique pour reproduire un problème observé en réel à une date précise ; complétez au besoin avec le test visuel du Strategy Tester.
- Profilez avant d’optimiser : l’intuition se trompe souvent sur la partie lente d’un programme.
- Gardez une version finale propre : compilation normale, optimisation activée, code de débogage exclu par
#ifdef _DEBUG.
FAQ
Où se trouve le fichier .ex5 après compilation ?
Dans le même dossier que le fichier source principal .mq5, selon l’aide de MetaEditor. S’il est dans le dossier MQL5 du terminal, le programme apparaît dans le Navigateur du terminal après actualisation.
Quelle différence entre F5 et Ctrl+F5 dans MetaEditor ?
F5 lance le débogage sur données réelles, sur un graphique alimenté par les prix du serveur. Ctrl+F5 lance le débogage sur données historiques, dans le Strategy Tester, ce qui permet de rejouer une période passée.
DebugBreak arrête-t-il mon EA en compte réel ?
Non. La documentation précise que DebugBreak n’interrompt l’exécution que si le programme a été lancé en mode débogage ; sinon l’appel est sans effet. Il reste préférable de ne pas le laisser dans la version finale.
Que signifient Total CPU et Self CPU dans le profileur ?
Total CPU compte les échantillons où la fonction apparaît n’importe où dans la pile d’appels, donc son temps et celui des fonctions qu’elle appelle. Self CPU compte uniquement le temps passé dans la fonction elle-même : c’est la mesure à regarder en premier pour trouver un goulot d’étranglement.
- Types de données en MQL5
- Variables, constantes et portée
- Paramètres input et sinput
- Opérateurs et expressions
- Conditions if, else et switch
- Boucles for, while et do while
- Écrire ses propres fonctions
- Tableaux statiques et dynamiques
- ArraySetAsSeries et indexation des séries
- Manipuler les chaînes de caractères
- Dates, heures et fuseaux
- Structures (struct) et MqlRates, MqlTick
- Énumérations (enum) personnalisées
- #include, #define et #property
- Les fonctions événementielles
- Print, Comment, Alert : déboguer avec le journal
- NormalizeDouble et précision des prix
- SymbolInfoDouble, SymbolInfoInteger
- AccountInfoDouble : lire les informations du compte
