Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

MQL5 · Avancé

Versionner son code MQL5 avec MQL5 Algo Forge : Git intégré à MetaEditor

Ne plus jamais perdre la version d’un EA qui fonctionnait : MQL5 Algo Forge apporte un dépôt Git à MetaEditor. Activation, commits, synchronisation, branches, fusion, dépôts privés et méthode de travail adaptée au trading algorithmique.

Mis à jour le 23 octobre 2026Lecture : 9 minPar Alix, OptiBot Trading

MQL5 Algo Forge est le service de stockage de code basé sur Git proposé par MetaQuotes pour les projets de trading algorithmique, accessible sur le portail forge.mql5.io et intégré directement à MetaEditor. Il vous permet d’enregistrer chaque étape de votre code sous forme de commits, de synchroniser votre travail avec un serveur distant (pull et push), de créer des branches pour expérimenter sans casser la version stable, puis de les fusionner. Les dépôts sont privés par défaut ; vous pouvez en rendre certains publics pour partager votre travail. Pour l’activer, connectez MetaEditor à votre compte MQL5.community, puis activez Algo Forge depuis le menu contextuel d’un dossier du Navigateur.

Cette page appartient à la rubrique MQL5 avancé. Elle complète la présentation de l’éditeur faite dans Bien utiliser MetaEditor.

Pourquoi versionner un Expert Advisor

Tout développeur d’EA a vécu cette situation : une modification « mineure » dégrade les résultats du backtest, et il est impossible de retrouver exactement la version précédente. Ou bien un robot tourne sur un VPS depuis trois mois, et personne ne sait plus quel code source correspond au fichier .ex5 déployé. La gestion de versions répond à ces problèmes :

  • Historique complet : chaque commit est une photographie du projet, avec un message expliquant ce qui a changé et pourquoi.
  • Retour arrière : revenir à la version qui donnait tel résultat de backtest prend quelques secondes.
  • Expérimentation sans risque : une nouvelle idée de filtre se développe dans une branche ; si elle ne tient pas ses promesses, on l’abandonne sans toucher à la branche principale.
  • Traçabilité de la production : en associant un numéro de version au code déployé, vous savez toujours quel code tourne sur quel compte.
  • Sauvegarde : le dépôt distant protège votre travail d’une panne de disque.

Ce qu’apporte Algo Forge par rapport à un Git classique

Algo Forge reprend les principes de Git, et sa documentation le compare à ce que GitHub représente pour le logiciel libre. Sa spécificité est d’être pensé pour l’écosystème MetaTrader : intégration dans MetaEditor, compte MQL5 commun, portail web où l’on peut parcourir l’arborescence des fichiers, éditer du code, ajouter des commits, naviguer entre les branches et consulter l’activité d’un projet depuis n’importe quel navigateur. Le volet collaboratif est également présent : rejoindre des équipes, discuter des modifications directement dans le code, suivre les contributions de chacun, suivre d’autres auteurs et créer des forks de dépôts publics.

Vous n’êtes pas enfermé dans MetaEditor pour autant : la documentation prévoit l’utilisation de clients Git externes avec les dépôts Algo Forge.

Activer Algo Forge dans MetaEditor

  1. Connectez-vous à votre compte MQL5.community dans MetaEditor : menu Outils, Options, onglet Communauté, saisissez vos identifiants et validez. Si vous n’avez pas de compte, créez-en un sur le site MQL5.community.
  2. Activez Algo Forge : dans le Navigateur, faites un clic droit sur un dossier et choisissez la commande d’activation de MQL5 Algo Forge.
  3. Travaillez avec vos projets : une fois l’activation faite, vous pouvez exécuter les commandes Git sur vos dépôts, consulter l’historique des projets et cloner des dépôts existants ou récupérer les changements distants si vous avez déjà utilisé le service.

Le cycle de travail quotidien

Le cycle de base est le même que dans tout projet Git :

  1. Vérifier les différences : avant de valider, relisez ce qui a changé dans chaque fichier.
  2. Commit : enregistrez localement un ensemble cohérent de modifications avec un message explicite.
  3. Pull : récupérez les changements présents sur le serveur (ceux d’un collègue, ou les vôtres faits depuis une autre machine).
  4. Push : envoyez vos commits vers le dépôt distant.
  5. Branches et fusion : développez une fonctionnalité dans une branche, puis fusionnez-la dans la branche principale une fois validée.

Pour ceux qui préfèrent la ligne de commande, voici l’équivalent avec un client Git externe, à partir de l’adresse de clonage affichée sur la page du dépôt dans le portail :

# cloner le dépôt (copier l'URL depuis la page du dépôt sur forge.mql5.io)
git clone <URL-du-depot> MonEA
cd MonEA

# créer une branche pour tester un nouveau filtre de volatilité
git checkout -b filtre-atr

# ... modifications dans MetaEditor, compilation, backtests ...

git status                         # fichiers modifiés
git diff                           # relire les changements
git add Experts/MonEA.mq5 Include/MonEA/Filters.mqh
git commit -m "Filtre ATR : pas d'entrée si ATR(14) > 2x sa moyenne 100"

# la branche est validée par le backtest : fusion dans la branche principale
git checkout main
git merge filtre-atr
git tag v1.4.0 -m "Version déployée sur le compte démo"
git push origin main --tags

Les étiquettes (tags) sont particulièrement utiles en trading : marquez chaque version mise en démo ou en réel, et vous pourrez toujours reconstruire le fichier exact qui a produit un résultat.

Une méthode adaptée au trading algorithmique

La gestion de versions prend tout son sens si vous reliez le code à vos résultats.

  • Un commit par hypothèse : « ajout d’un filtre de spread », « stop passé de 2 à 2,5 ATR ». Un commit qui mélange cinq changements rend impossible l’attribution d’un écart de performance.
  • Le message mentionne le test : période, symbole, mode de modélisation et résultat clé. L’historique devient un journal de recherche.
  • Synchronisez #property version avec vos étiquettes Git. Le numéro apparaît dans les propriétés du programme et permet de vérifier, sur le VPS, quelle version est chargée ; c’est un point de la checklist avant mise en production.
  • Versionnez les sources, pas les binaires : les fichiers .ex5 se régénèrent par compilation. Conservez les fichiers .mq5 et .mqh, ainsi que les fichiers de paramètres .set qui accompagnent une version.
  • Ne versionnez jamais de secrets : mots de passe, jetons d’API ou identifiants de compte n’ont rien à faire dans un dépôt, même privé.
  • Gardez les rapports lourds hors du dépôt : exports d’optimisation volumineux, caches et fichiers temporaires alourdissent l’historique sans valeur ajoutée.

Ces habitudes facilitent aussi la vie quand vous publiez un produit : chaque mise à jour envoyée sur le Market correspond à une étiquette précise, comme l’explique Publier un produit sur le Market MQL5. Et si votre projet comporte une DLL maison, son code source a lui aussi sa place dans le dépôt, comme le recommande la page Importer des DLL.

Dépôts privés, publics et collaboration

Tous les dépôts sont privés à leur création : personne d’autre que vous n’y a accès. Rendre un dépôt public permet à d’autres utilisateurs d’étudier votre solution et d’en créer un fork. Pour un travail d’équipe (un développeur et un trader, par exemple), la collaboration se fait par les équipes et les discussions directement dans le code. Définissez quelques règles simples : la branche principale ne contient que du code qui compile et a passé les tests de base, chaque modification passe par une branche, et un commentaire de revue précède la fusion.

Pièges fréquents

  • Commit sans compilation : validez toujours un état qui compile ; sinon, revenir à cette version ne sert à rien.
  • Oublier les fichiers inclus : un EA réparti entre Experts et Include doit avoir tous ses fichiers dans le dépôt, sans quoi la version est incomplète.
  • Travailler des semaines sans push : le dépôt local ne protège pas d’une panne de disque.
  • Messages vagues (« modif », « test ») : six mois plus tard, ils ne disent plus rien.
  • Rendre public par erreur : vérifiez la visibilité du dépôt avant d’y placer une stratégie que vous ne souhaitez pas partager.

Questions fréquentes

Faut-il un compte MQL5 pour utiliser Algo Forge ?

Oui. Vous devez être connecté à MetaEditor avec votre compte MQL5.community, via Outils, Options, onglet Communauté. Si vous n’en avez pas, l’inscription se fait sur le site MQL5.community.

Mes dépôts Algo Forge sont-ils visibles par les autres utilisateurs ?

Non par défaut : tous les dépôts sont privés à leur création. Vous pouvez choisir de rendre un dépôt public, ce qui permet à d’autres de l’étudier et d’en créer un fork.

Puis-je utiliser mon client Git habituel au lieu de MetaEditor ?

Oui. La documentation de MetaEditor décrit l’utilisation de clients Git externes avec Algo Forge. Vous pouvez donc combiner l’intégration dans MetaEditor et vos outils en ligne de commande.

Que faut-il versionner dans un projet d’EA ?

Les fichiers sources .mq5 et .mqh, les fichiers de paramètres .set associés aux versions testées et une courte documentation. Laissez de côté les fichiers compilés .ex5, les rapports volumineux et tout identifiant ou mot de passe.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.