MT5交易历史导出与Excel图表实战

为什么需要把交易历史导出到Excel

MetaTrader 5 的策略测试器默认只提供统一的余额/净值曲线，当你使用多币种 EA 时，所有品种的交易混在一起，无法直观看到单个品种的绩效。要想单独分析某个品种，只能反复在 EA 外部参数中禁用其他品种重新测试，效率极低。很多交易者论坛分享的 Excel 图表截图，正是为了解决这一痛点：把每笔交易、每个品种的余额曲线、局部回撤全部拆开，用电子表格灵活作图。

本文基于前文的多币种 EA，增加一个报告模块，在测试结束时自动把结果写成 CSV 文件，再用 Excel 的“从文本导入”建立可刷新连接。这样每次跑完测试，只需在 Excel 按 Ctrl+Alt+F5 就能看到最新图表，不需要关闭表格，也不需要手动复制数据。

核心思路与系统架构

整体方案分为两部分：MQL5 端负责数据采集与写文件，Excel 端负责可视化。MQL5 侧新增几个头文件：Enums.mqh 定义交易属性枚举；Report.mqh 包含生成 CSV 的函数；ToString.mqh 提供把数值转字符串且空值显示横线的工具函数。EA 主文件在 OnTester() 中调用 CreateSymbolBalanceReport()，仅在不优化、非可视化模式下写文件。

数据结构上，用一个 Balance 结构体数组 symbol_balance[] 保存每个品种的余额序列。交易属性用 HistoryDealProperties 结构承接，通过 HistoryDealGetString/Integer/Double 系列函数从历史中读取。CSV 文件写在终端通用文件夹：C:\ProgramData\MetaQuotes\Terminal\Common\Files\LastTest.csv。

//--- 余额数组
struct Balance
  {
   double            balance[];
  };
//--- 所有交易品种的余额数组
Balance symbol_balance[];

MQL5端：定义交易属性枚举与结构

为了通用地读取每笔交易的信息，先在 Enums.mqh 中列出需要的属性标识。这样后续函数可以用 switch 分发，避免写死字段。枚举包含交易品种、注释、类型、方向、价格、利润、交易量、库存费、手续费、时间等。

enum ENUM_DEAL_PROPERTIES
  {
   D_SYMBOL     = 0, // 交易的交易品种
   D_COMMENT    = 1, // 交易的注释
   D_TYPE       = 2, // 交易的类型
   D_ENTRY      = 3, // 交易的进场类型
   D_PRICE      = 4, // 交易的价格
   D_PROFIT     = 5, // 交易的结果
   D_VOLUME     = 6, // 交易的交易量
   D_SWAP       = 7, // 库存费
   D_COMMISSION = 8, // 手续费
   D_TIME       = 9, // 交易时间
   D_ALL        = 10 // 所有属性
  };

对应的结构 HistoryDealProperties 用于暂存一笔交易的全部字段。GetHistoryDealProperties() 根据传入的订单号与属性枚举，填充该结构。注意 DEAL_TYPE 和 DEAL_ENTRY 返回的是整数，需要强转成 MQL5 的枚举类型。

struct HistoryDealProperties
  {
   string            symbol;
   string            comment;
   ENUM_DEAL_TYPE    type;
   ENUM_DEAL_ENTRY   entry;
   double            price;
   double            profit;
   double            volume;
   double            swap;
   double            commission;
   datetime          time;
  };

void GetHistoryDealProperties(ulong ticket_number,ENUM_DEAL_PROPERTIES p)
  {
   switch(p)
     {
      case D_SYMBOL: deal.symbol=HistoryDealGetString(ticket_number,DEAL_SYMBOL); break;
      case D_ALL:
         deal.symbol=HistoryDealGetString(ticket_number,DEAL_SYMBOL);
         deal.type=(ENUM_DEAL_TYPE)HistoryDealGetInteger(ticket_number,DEAL_TYPE);
         deal.profit=HistoryDealGetDouble(ticket_number,DEAL_PROFIT);
         deal.time=(datetime)HistoryDealGetInteger(ticket_number,DEAL_TIME);
         break;
      default: Print("属性未列出"); return;
     }
  }

字符串转换与空值处理

CSV 需要在 Excel 中干净显示，因此把交易类型、方向、数值等转为中文或横线。ToString.mqh 中的函数若接到空字符串或零值，统一返回“-”，避免 Excel 把空单元格当零处理。例如 DealTypeToString 把 DEAL_TYPE_BUY 映射为“买”，DEAL_TYPE_SELL 为“卖”；DealEntryToString 把入、出、反转分别映射。

string DealTypeToString(ENUM_DEAL_TYPE deal_type)
  {
   switch(deal_type)
     {
      case DEAL_TYPE_BUY: return "买";
      case DEAL_TYPE_SELL: return "卖";
      default: return "未知";
     }
  }

生成CSV报告的主函数

CreateSymbolBalanceReport() 是核心。它先确保通用文件夹存在，用 FileOpen 以 FILE_CSV|FILE_WRITE|FILE_ANSI|FILE_COMMON 打开 LastTest.csv。接着写表头：基础列包含时间、品种、类型、方向、交易量、价格、库存费、利润、回撤%、余额；若 SYMBOLS_COUNT>1，动态追加每个品种名作为独立余额列。

随后 HistorySelect(0,TimeCurrent()) 拉取全部历史，按交易笔数扩容 symbol_balance 各子数组。循环每笔交易：取属性、累加总余额、调用 MaxDrawdownToString 算局部回撤，最后拼成逗号分隔行写入。这样 Excel 打开就是标准分列数据。

void CreateSymbolBalanceReport()
  {
   int file_handle=FileOpen("LastTest.csv",FILE_CSV|FILE_WRITE|FILE_ANSI|FILE_COMMON);
   if(file_handle>0)
     {
      string headers="TIME,SYMBOL,DEAL TYPE,ENTRY TYPE,VOLUME,PRICE,SWAP($),PROFIT($),DRAWDOWN(%),BALANCE";
      if(SYMBOLS_COUNT>1) for(int s=0;s<SYMBOLS_COUNT;s++) StringAdd(headers,","+InputSymbols[s]);
      FileWrite(file_handle,headers);
      HistorySelect(0,TimeCurrent());
      int deals_total=HistoryDealsTotal();
      for(int i=0;i<deals_total;i++)
        {
         ulong ticket=HistoryDealGetTicket(i);
         GetHistoryDealProperties(ticket,D_ALL);
         balance+=deal.profit+deal.swap+deal.commission;
         // ... 写行 ...
        }
      FileClose(file_handle);
     }
  }

回撤计算逻辑详解

MaxDrawdownToString 用静态变量 max、min 跟踪局部极值。第一笔交易初始化；之后若余额创新高，用之前极小值算回撤百分比 (100 - min/max*100)，并更新极值；若未新高，则更新 min，回撤显示“-”。这给出“每达到新高时回顾的最大回撤”，便于看曲线峰谷风险。

string MaxDrawdownToString(int n,double balance,double &max_dd)
  {
   static double max=0.0,min=0.0;
   if(n==0){max_dd=0;max=balance;min=balance;}
   else if(balance>max){max_dd=100-((min/max)*100);max=balance;min=balance;}
   else {max_dd=0;min=fmin(min,balance);}
   return(max_dd==0?"-":DoubleToString(max_dd,2));
  }

在EA中挂载报告功能

主文件包含 Report.mqh 等头文件，并在 OnTester() 中加几行：仅当 IsTester() && !IsOptimization() && !IsVisualMode() 才生成，避免优化批次刷屏。测试结束就会在通用文件夹看到 LastTest.csv。

double OnTester()
  {
   if(IsTester() && !IsOptimization() && !IsVisualMode())
      CreateSymbolBalanceReport();
   return(0.0);
  }

Excel端：建立可刷新数据连接

直接双击 CSV 打开，Excel 会锁文件，EA 下次写不进。正确做法：新建 xlsx，点“数据”选项卡的“自文本”，选 LastTest.csv，向导中分隔符选逗号，列格式通用。导入时指定 A1 起始，然后在“外部数据范围属性”里勾选“刷新时保留格式”“打开文件时刷新”，确定后数据入表。

此后 MT5 跑完测试，Excel 不必关。按 Ctrl+Alt+F5 或点“全部刷新”，CSV 被 EA 重写后表格即时更新。这是比复制粘贴高效的关键。

绘制余额与回撤图表

选中余额相关列表头及整列数据（Shift+End+下箭头），插入折线图即得多品种余额曲线。把图表剪切到独立 Sheet 方便看。横轴默认交易序号，右键“选择数据”可改为时间列。再选回撤%列做柱状图放下方，用条件格式标红大回撤。

最终工作簿可长期保留，每次回测后刷新即得新图，适合做策略迭代记录。你也可依此扩展：增加净值列、按魔法码筛选、用 Power Query 替代旧向导。

与其他方案对比及常见坑

• MT5 原生 HTML 报告：不能分品种折线，且每次覆盖；本方案 CSV+Excel 可累积对比。
• 自己用 JS 解析 html：灵活但需另写解析器，本文 MQL5 直写更稳。
• 直接 Open CSV：文件锁导致 EA 写失败，必须用外部数据导入。
• 编译示例 ZIP 报错：检查自定义库函数返回类型，按新编译器修正。
• 多品种表头错位：确保 SYMBOLS_COUNT 与 InputSymbols 一致，否则余额列对不上。