MQL5開発入門｜MetaEditor・EA・インジケーター・イベント関数・コンパイルエラーの基本

MQL5開発を始める時は、いきなり複雑なEAやインジケーターを作ろうとするよりも、MT5とMetaEditorの関係、データフォルダ、MQL5フォルダ構成、ファイル種類、イベント関数、コンパイルエラー、ログ確認の流れを先に整理しておくことが重要です。

MQL5は、MT5上でEA、インジケーター、スクリプト、通知ツール、診断ツール、外部連携ツール、補助ツールなどを作るために使われる開発言語です。EAの売買ロジックだけでなく、チャート表示、アラート、CSV出力、WebRequest、Discord通知、Google Sheets連携、バックテスト補助、設定診断など、幅広い用途で使われます。

このページでは、MQL5を学び始める方、既存EAやインジケーターの改修を相談したい方、MetaEditorやコンパイルエラーの見方を確認したい方に向けて、MQL5開発の入口を体系的に整理します。既存記事の基本内容を残しつつ、開発環境、フォルダ構成、初回コンパイル、EAとインジケーターの違い、開発依頼前の整理まで含めて確認できるようにしています。

なお、この記事はMT5 / MQL5の開発画面、ファイル構成、イベント関数、エラー確認、ログ確認、開発依頼前整理を目的とした技術学習記事です。投資判断、売買タイミング、利益、勝率、損失回避、推奨ロット、特定ブローカーへの誘導を目的とした内容ではありません。

この記事で確認すること

MQL5を学ぶ前に知っておくこと

MQL5とは

MQL5は、MetaTrader 5上で動作するプログラムを作成するための言語です。MT5用のEA、インジケーター、スクリプト、ライブラリ、補助ツールを作る時に使われます。MT4用のMQL4とは似ている部分もありますが、注文処理、ポジション管理、イベント処理、データ取得の考え方には違いがあります。

MQL5を使うと、チャート上の情報を取得したり、インジケーターを表示したり、条件に応じて通知したり、ファイルへ記録したり、EAとして注文処理や決済処理を扱ったりできます。さらに、OnTimerによる定期処理、OnTradeTransactionによる取引イベント確認、OnChartEventによるパネル操作なども扱えます。

ただし、MQL5を学ぶ目的は、いきなり売買判断を作ることだけではありません。EAやインジケーターを正しく導入し、設定やログを確認し、エラー発生時に原因を切り分け、開発依頼前に必要な情報を整理できるようになることも重要です。

MQL5で作れる主なもの

MQL5で作れるものは、EAだけではありません。表示用のインジケーター、単発処理のスクリプト、共通部品として使うincludeファイル、通知や記録を補助するツール、WebRequestを使う外部連携ツールなども作成できます。

公式リファレンスと学習記事の使い分け

MQL5を正確に学ぶには、公式リファレンスで関数名、イベント名、引数、戻り値、仕様を確認することが重要です。一方で、公式リファレンスだけでは、EA開発の責務分離、ログ設計、バックテスト確認、開発依頼前の整理までは分かりにくい場合があります。

そのため、公式リファレンスでは個別関数の正確な仕様を確認し、学習記事では「どの場面で使うのか」「どの順番で確認するのか」「失敗時にどこを見るのか」を整理するのがよいです。EAファンクラブでは、関数辞書、イベント処理、注文処理、ログ設計、開発依頼前資料を分けて確認できるように整理しています。

MQL5開発環境を整える前に確認すること

MQL5開発環境を整える時は、MT5本体、MetaEditor、データフォルダ、MQL5フォルダ、コンパイル結果、ログの確認場所を分けて理解する必要があります。コードの文法より先に、どこへ保存し、どこでコンパイルし、どのMT5で読み込むのかを確認してください。

複数のMT5をインストールしている場合、別のMT5のデータフォルダへファイルを保存してしまうことがあります。MetaEditorでコンパイルはできているのに、普段使っているMT5側のNavigatorに表示されない場合は、まずデータフォルダの対応関係を確認してください。

MT5とMetaEditorの関係

MT5はEAやインジケーターを動かす側、MetaEditorはMQL5コードを作成・編集・コンパイルする側です。MT5のメニューからMetaEditorを開くと、そのMT5のデータフォルダに対応した開発環境を開けます。

複数のMT5を使っている場合、MetaEditorの起動元を間違えると、別のデータフォルダへファイルを保存してしまうことがあります。開発中は、MT5の「ファイル」からデータフォルダを開き、対象フォルダとMetaEditorの保存先が一致しているか確認してください。

特に開発依頼や検証でファイルを受け渡す時は、「どのMT5のデータフォルダに置いたか」「どのフォルダへ配置したか」「コンパイル後に.ex5が生成されたか」を記録しておくと、確認がしやすくなります。

データフォルダとMQL5フォルダの関係

MT5のMQL5関連ファイルは、通常、データフォルダ内のMQL5フォルダに整理されます。EAはExperts、インジケーターはIndicators、スクリプトはScripts、共通部品はInclude、ライブラリはLibrariesへ置くのが基本です。

ファイルを正しい場所へ置いても、コンパイルしていない場合や、MT5側でNavigatorを更新していない場合は、一覧に表示されないことがあります。ファイル配置、コンパイル、MT5側表示、ログ確認は、別々の確認項目として扱ってください。

MQL5フォルダの基本構成

MQL5開発では、ファイルの保存場所を間違えないことが重要です。EA、インジケーター、スクリプト、共通部品、ライブラリは、それぞれ役割が違います。フォルダの意味を先に理解しておくと、コンパイル後にMT5側へ表示されない問題を減らせます。

MQL5で扱う主なファイル種類

MQL5開発では、.mq5、.mqh、.ex5、.setなど、複数のファイルを扱います。それぞれ役割が異なるため、開発依頼や不具合確認の時も、どのファイルを送るべきかを分けて考える必要があります。

特に、.ex5しかないEAやインジケーターは、通常、ソースコードとして中身を編集することはできません。改修や原因調査を依頼する場合は、.mq5や関連する.mqhがあるかを確認してください。

EA・インジケーター・スクリプトの違い

MQL5では、EA、インジケーター、スクリプトを作成できます。どれもMQL5で作れますが、動き方と目的が違います。開発前に、作りたいものがEAなのか、インジケーターなのか、スクリプトなのかを分けておくことが重要です。

たとえば、売買注文を出すものはEAとして扱うのが基本です。一方、チャートに値を表示したり、ラインを描画したりするものはインジケーターとして作ることが多くなります。単発の確認処理や一括出力であれば、スクリプトが向いている場合もあります。

MQL5の主なイベント関数

MQL5では、イベント関数を起点に処理が実行されます。EA、インジケーター、スクリプトでは使うイベント関数が異なるため、どのタイミングで処理が動くのかを理解しておく必要があります。

イベント関数は、単なる関数名ではなく、MT5側から呼び出される入口です。OnTickにすべてを書き込む、OnCalculateの再計算範囲を考えない、OnInitで失敗を返さない、OnDeinitでObjectを削除しすぎる、といった設計は後から問題になりやすいため、役割を分けて考えてください。

初回コンパイルで確認すること

MQL5コードを書いた後は、MetaEditorでコンパイルします。コンパイルに成功すると、通常は.ex5ファイルが生成され、MT5側でEAやインジケーターとして読み込めるようになります。

コンパイル時にエラーが出ている場合は、該当箇所を修正するまでMT5側で正常に使えません。警告だけの場合でも、型変換、未使用変数、暗黙変換、精度低下の可能性など、後から不具合につながる内容が含まれることがあります。

エラーと警告の違い

エラーは、コンパイルが完了できない問題です。文法ミス、関数名の誤り、引数の数違い、型の不一致、セミコロン忘れ、括弧の閉じ忘れ、includeファイル不足などが原因になります。

警告は、コンパイル自体は通るものの、確認した方がよい注意です。未使用変数、型変換、精度低下の可能性などが表示される場合があります。警告を放置しても動くことはありますが、検証や配布前には内容を確認してください。

コンパイル済みなのにMT5へ表示されない場合

コンパイルは通ったのにMT5へ表示されない場合、まず保存先を確認します。EAならExperts、インジケーターならIndicators、スクリプトならScriptsに配置されているかを見ます。次に、MT5側のNavigatorを更新したか、対象MT5とMetaEditorのデータフォルダが一致しているかを確認してください。

また、コンパイルしたファイル名とMT5に表示される名前が違って見える場合もあります。ファイル名、保存フォルダ、コンパイル日時、MT5の再起動有無を整理して確認すると、原因を追いやすくなります。

MQL5開発でつまずきやすいポイント

MQL5開発でつまずいた時は、コードのロジックだけでなく、ファイル配置、コンパイル結果、MT5側の表示、ログ、権限、外部連携設定を順番に確認します。特に初期段階では、単純な配置ミスやコンパイル未実施が原因になることもあります。

EA開発で分けて考える責務

MQL5でEAを作る場合は、エントリー条件だけでなく、発注前チェック、注文処理、決済、リスク管理、ログ、通知を分けて考えます。これらをすべてOnTickの中へ直接書くと、後から原因を追いにくくなります。

EAが注文しない場合でも、理由は1つではありません。シグナルが成立していないのか、フィルターで止まったのか、ロットや証拠金のチェックで止まったのか、注文送信後にretcodeで失敗したのかを分けてログに残す必要があります。

このように責務を分けておくと、バックテスト、デモ環境、実運用前確認、不具合調査のいずれでも原因を追いやすくなります。特に配布用EAや開発依頼品では、注文が出ない時の理由をログで追えることが重要です。

インジケーター開発で確認すること

インジケーター開発では、値の計算、チャート表示、バッファ、サブウィンドウ、アラート、Object表示などを確認します。EAと違い、注文処理ではなく表示や計算が中心になります。

インジケーターをEAから読み込む場合は、iCustomやCopyBufferで値を取得する構成になります。この場合、インジケーター単体で表示できるか、EA側でハンドルを作成できるか、CopyBufferで値を取得できるかを分けて確認します。

CopyBufferとインジケーター値の確認

MQL5でEAからインジケーター値を使う場合、CopyBufferを使って値を取得することがあります。CopyBufferで値が取れない場合、インジケーターハンドルの作成失敗、取得本数不足、配列方向の理解不足、確定足と現在足の混同などが原因になることがあります。

EA側でインジケーター値を使う時は、まずOnInitでハンドルが正しく作られているか、次にBarsCalculatedで計算済み本数が足りているか、CopyBufferの戻り値が想定どおりかを確認します。値が0だから条件不成立なのか、値そのものが取得できていないのかをログで分けてください。

MQL5開発でログ確認を前提にする

MQL5開発では、動いたかどうかだけでなく、なぜ動いたのか、なぜ動かなかったのかを追えることが重要です。特にEAでは、シグナル不成立、発注前チェック停止、注文失敗、決済失敗、通知失敗、設定不正を同じログ表現にしないようにします。

ログは後から慌てて追加するものではなく、開発時点で仕様の一部として考えるのが望ましいです。OnInitで主要設定を出す、シグナル判定で見送り理由を出す、注文処理ではretcodeとGetLastErrorを分ける、外部連携では送信結果だけを出し、認証情報やURLの実値は出さない、といった設計が必要です。

バックテスト前に確認すること

EA開発では、コンパイルが通ることと、バックテストで意図した条件を確認できることは別です。バックテストを行う場合は、銘柄、時間足、期間、スプレッド、モデル、初期残高、setファイル、最適化条件を記録してください。

バックテスト結果は将来の結果を保証するものではありません。あくまで、EAの処理が想定どおり動いているか、発注、決済、ログ、停止条件、通知、エラー時の挙動を確認するための検証材料として扱います。

MT4からMT5へ移行する時の注意点

MT4で使っていたEAやインジケーターをMT5へ移したい場合、単純なファイルコピーでは動かないことがあります。MQL4とMQL5では、注文処理、ポジション管理、イベント関数、インジケーターの扱い、コンパイル環境が異なるためです。

移植というより、MT5向けに再設計する前提で考えた方が安全です。特に、OrderSend、Position、History、Deal、TradeTransaction、CopyBuffer、iCustom、Magic Number管理、複数ポジション管理は、MT5の構造に合わせて見直す必要があります。

MT4版のソースがある場合でも、そのまま貼り付けてコンパイルできるとは限りません。MT5側でどの機能を再現したいのか、どの機能は不要なのか、ログや通知をどう扱うのかを整理してから進めてください。

開発依頼前に整理すること

MQL5開発を依頼する場合は、「EAを作りたい」「インジケーターを作りたい」だけでは仕様が不足しやすくなります。作りたいものの種類、目的、使用するインジケーター、対象銘柄、時間足、判定タイミング、ログ、表示、通知、検証条件を分けて整理してください。

また、依頼時には、必要な情報と送らない方がよい情報を分けることも重要です。仕様確認に必要なのは、ロジック、設定、ログ、スクリーンショット、setファイル、発生条件です。口座番号、パスワード、認証トークン、Webhook URL、APIキーなどの実値は、そのまま送らないようにしてください。

送る情報・送らない方がよい情報

開発依頼や不具合相談では、情報が不足していると原因確認に時間がかかります。一方で、機密情報をそのまま送ってしまうと安全上の問題があります。送る情報と送らない方がよい情報を分けて整理してください。

記事固有の実務チェック表

よくある質問

MQL5開発を始めるには何を用意すればよいですか？

MT5とMetaEditorが使える環境を用意し、データフォルダ、MQL5フォルダ、Experts / Indicators / Include の違いを確認してください。最初は小さなEAやインジケーターを作り、保存、コンパイル、MT5側表示、ログ確認までの流れを確認すると進めやすくなります。

MetaEditorだけを開けば開発できますか？

MetaEditorでコードを書くことはできますが、実際に動かすMT5のデータフォルダと一致しているか確認する必要があります。複数のMT5を使っている場合は、別のデータフォルダへ保存していることがあります。

EAとインジケーターは何が違いますか？

EAは自動売買、ポジション管理、通知、診断などに使われることが多く、OnTickやOnTimerなどを中心に動きます。インジケーターはチャート表示や計算が中心で、OnCalculateを使う構成が基本です。

コンパイルエラーが出た場合はどうすればよいですか？

MetaEditorのErrors欄で、エラー行、エラー内容、関数名、引数、型、括弧、セミコロン、includeファイルの有無を確認してください。エラーが残っている場合は、通常.ex5が生成されず、MT5側で実行できません。

コンパイルは通ったのにMT5に表示されないのはなぜですか？

保存先が違う、ExpertsではなくIndicatorsへ置いている、MT5側のNavigatorが更新されていない、別のMT5データフォルダを見ている、などが考えられます。まずはMT5からデータフォルダを開き、保存先とコンパイル結果を確認してください。

MQL5を知らなくても開発依頼できますか？

可能です。ただし、作りたい機能、対象銘柄、時間足、既存ソースの有無、setファイル、ログ、スクリーンショットを整理しておくと確認しやすくなります。MQL5の文法を説明するよりも、期待する動作と確認できる資料を整理することが重要です。

ex5ファイルだけでも改修できますか？

通常、.ex5はコンパイル済みの実行用ファイルであり、ソースコードとして編集することはできません。改修を依頼する場合は、.mq5や関連する.mqhがあるか確認してください。

MQL5開発でログはどの程度必要ですか？

EAや通知ツールでは、ログは重要です。シグナル不成立、発注前チェック停止、注文失敗、決済失敗、通知失敗、設定不正を分けて確認できるようにすると、不具合調査や検証がしやすくなります。

関連ページ

MQL5開発を進める時は、開発環境、関数辞典、エラーコード、EA設計、注文処理、ログ設計、開発依頼前資料を分けて確認すると、作業の抜け漏れを減らしやすくなります。

まとめ

MQL5開発を学ぶ時は、いきなり複雑なEAや売買ロジックを作るのではなく、MetaEditor、データフォルダ、MQL5フォルダ構成、ファイル種類、EAとインジケーターの違い、イベント関数、コンパイルエラー、ログ確認を順番に整理することが重要です。

.mq5、.mqh、.ex5、.setファイルは、それぞれ役割が異なります。改修や不具合確認を行う場合は、実行用ファイルだけでなく、ソースコード、includeファイル、設定ファイル、ログの有無も確認してください。

EAではOnInit、OnTick、OnDeinit、OnTimer、OnTradeTransactionが重要になり、インジケーターではOnCalculateやバッファ管理が重要になります。表示系、判定系、売買実行系、通知系、外部連携系を混同しないことが、開発や改修を進める上で大切です。

開発依頼や不具合相談を行う場合は、対象ファイル、setファイル、ログ、スクリーンショット、発生条件、改修したい内容を整理してください。APIキー、Webhook URL、認証トークン、口座番号などの実値は、そのまま送らないよう注意してください。