📈 為何要學習 MQL 程式語言？

在瞬息萬變的金融市場中，交易者總在尋求能提升決策效率與精準度的工具。MetaTrader 平台（MT4/MT5）之所以廣受歡迎，其強大的 MQL（MetaQuotes Language） 程式語言功不可沒。學習如何使用 MQL 程式語言，意味著您不再受限於平台內建的指標與功能。您可以打造完全符合自己交易邏輯的客製化指標、開發自動執行的 EA（Expert Advisor）交易策略，甚至優化現有工具的運算效能。這不僅是技術上的提升，更是將您獨特的市場洞察力轉化為系統化交易優勢的關鍵一步。本篇教學將以最常見的「移動平均線（Moving Average, MA）」為例，帶您從一個最基礎的腳本，逐步深入 MQL 的世界，探索程式化交易的無限可能。

代碼解析：

• input：這是 MQL 中的一個修飾符，告訴編譯器，這個變數是一個外部輸入參數，需要在指標設定視窗中顯示出來。
• int：整數型別，用於定義像「週期（PERIOD）」和「位移（SHIFT）」這樣的純數字參數。
• ENUM_MA_METHOD / ENUM_APPLIED_PRICE：這是「列舉型別（Enumeration）」。您可以將它理解為一個預設好的下拉式選單。MT4 已經幫我們定義好了所有可用的 MA 計算方式（如 `MODE_SMA` 簡單移動、`MODE_EMA` 指數移動等）和適用價格（如 `PRICE_CLOSE` 收盤價、`PRICE_OPEN` 開盤價等），使用列舉型別能避免使用者輸入無效的數值，非常方便。
• = 20 / = 0 …：等號後面的是該參數的「預設值」。
• // 週期：雙斜線後面的文字是「註解」，它會顯示在設定視窗中，作為該參數的說明文字，幫助使用者理解其用途。

代碼解析：

• color：MQL 內建的顏色型別。預設值 `clrWhite` 是 MQL 預定義的顏色常數，代表白色。使用者可以在設定介面中點擊顏色方塊，從調色盤中選擇任意顏色。
• ENUM_LINE_STYLE：與 MA 模式類似，這是線條樣式的列舉型別，包含了 `STYLE_SOLID`（實線）、`STYLE_DASH`（虛線）、`STYLE_DOT`（點線）等多種選項。

邏輯解析：

1. `rates_total` 是 MT4 傳入的當前圖表總 K 棒數，`prev_calculated` 則是上次計算完畢的數量。它們的差值，就是新增加的 K 棒數量。
2. 我們定義 `limit` 來確定迴圈的起點。`rates_total – prev_calculated – 1` 這個公式可以有效地找出新增 K 棒的索引位置。
3. 改變迴圈的方向，從 `limit` 開始遞減至 `0`。這代表我們只計算從新 K 棒開始到當前最新的 K 棒這一段區間，而舊的、已經計算過且不會再改變的數據則被跳過，大大節省了運算資源。
4. `if(limit < 1) limit = 1;` 是一個保險措施，確保即使沒有新 K 棒產生，我們至少也會重新計算第 1 根（剛收盤）和第 0 根（正在跳動）K 棒的數值，以保證指標的即時性。

透過這個簡單的修改，您的指標在效能上已經提升了一個檔次。對於需要同時在多個圖表上運行的交易者來說，這種優化至關重要。

第四步：提升專業度，善用內建工具與最佳實踐

✨ 使用「Styler」自動美化程式碼

程式碼不僅是給機器執行的指令，也是給人看的。清晰、一致的程式碼風格能大幅提升可讀性與未來維護的便利性。MetaEditor 內建了一個名為「Styler」（在工具列上顯示為「調整原始碼」）的強大功能，可以一鍵自動整理您的程式碼格式。

在使用前，您可以先設定自己偏好的風格。點擊選單「工具」→「選項」，在「格式化」標籤頁中，可以選擇不同的內建風格（如 MetaQuotes、Linux、Allman 等），並微調縮排、空格等細節。設定完成後，只需在您的程式碼編輯視窗中點擊一下「調整原始碼」按鈕，編輯器就會自動將您的程式碼整理得井井有條。

📚 深入理解不同移動平均線模式

我們的指標現在可以選擇不同的 MA 類型，但您是否了解它們之間的差異？這對於制定交易策略至關重要。以下是 MQL 中最常用的四種 MA 模式的比較：

🔗 參考權威文件與社群

學習程式語言最好的夥伴就是官方文件。MetaQuotes 官方提供了非常詳盡的 MQL5 語言參考手冊，當您對某個函數不確定時，這是最權威的資訊來源。同時，MQL5 社群也是一個龐大的寶庫，裡面有世界各地的開發者分享程式碼、解決問題，是精進 MQL 技能的絕佳平台。

• 權威連結1: MQL5官方文件 – iMA 函數
• 權威連結2: MQL5 官方程式碼庫

完整程式碼參考

以下是我們經過上述所有步驟改造後的完整 MA 指標程式碼。您可以直接複製到 MetaEditor 中進行編譯和使用。

//+------------------------------------------------------------------+
//|                                                      MA_Pro.mq4 |
//|                      Copyright 2025, 理財研究室 fmstudio.blog |
//|                                      https://fmstudio.blog |
//+------------------------------------------------------------------+
#property copyright "Copyright 2025, 理財研究室 fmstudio.blog"
#property link      "https://fmstudio.blog"
#property version   "1.00"
#property strict

#property indicator_chart_window
#property indicator_buffers 1
#property indicator_plots   1

//--- 輸入參數
input int PERIOD = 20; // 週期
input int SHIFT = 0; // 位移
input ENUM_MA_METHOD METHOD = MODE_SMA; // MA 類別
input ENUM_APPLIED_PRICE PRICE = PRICE_CLOSE; // 適用價格
input color CLR = clrDodgerBlue; // 顏色
input ENUM_LINE_STYLE STYLE = STYLE_SOLID; // 線條種類
input int WIDTH = 2; // 寬度

//--- 指標緩衝區
double MABuffer[];

//+------------------------------------------------------------------+
//| 自訂指標初始化函數                                                 |
//+------------------------------------------------------------------+
int OnInit()
{
   //--- 指標緩衝區映射
   SetIndexBuffer(0, MABuffer);
   
   //--- 設定線條樣式
   SetIndexStyle(0, DRAW_LINE, STYLE, WIDTH, CLR);
   
   //--- 設定指標標籤
   string short_name = "MA(" + (string)PERIOD + ")";
   IndicatorSetString(INDICATOR_SHORTNAME, short_name);
   SetIndexLabel(0, short_name);

   return(INIT_SUCCEEDED);
}

//+------------------------------------------------------------------+
//| 自訂指標迭代計算函數                                                 |
//+------------------------------------------------------------------+
int OnCalculate(const int rates_total,
                const int prev_calculated,
                const datetime &time[],
                const double &open[],
                const double &high[],
                const double &low[],
                const double &close[],
                const long &tick_volume[],
                const long &volume[],
                const int &spread[])
{
   //--- 計算迴圈的起始位置
   int limit;
   if(prev_calculated == 0)
   {
      limit = rates_total - 1;
   }
   else
   {
      limit = rates_total - prev_calculated;
   }

   //--- 主計算迴圈
   for(int i = limit; i >= 0; i--)
   {
      MABuffer[i] = iMA(NULL, 0, PERIOD, SHIFT, METHOD, PRICE, i);
   }

   //--- 返回已計算的 K 棒總數
   return(rates_total);
}
//+------------------------------------------------------------------+