基于 VS+MFC 的 Gerber 文件解析与分行阅读器实现

简介：面向需要检查与验证 PCB 设计的 C++ 开发者，这份 VS MFC 工程演示如何读取 Gerber 文件，并把解析结果在 List 控件中逐行呈现。它适合已具备一定 C++ 基础、希望理解 Gerber（如 RS-274X）指令与坐标数据解析，同时练习 MFC 对话框、文件选择、列表控件和异常处理的中级学习者。压缩包共 25 个文件、约 150KB，主体为 9 个 .h 头文件与 6 个 .cpp 源文件，另有 .sln、.vcxproj、.rc 等 Visual Studio 解决方案与资源文件，以及 .suo、.aps 等开发环境辅助文件，结构上覆盖主对话框、Gerber 文件读取与显示页面、字符串处理和资源定义等模块。已有 801 人学习下载。读者可从中获得一套可编译的 MFC 示例工程，参考 Gerber 行数据解析、CListCtrl 插入与列文本设置、文件打开流程和错误提示的实现方式，并据此扩展自己的 PCB 数据查看工具。

1. 拿到一份 Gerber 就想先看清它：VS + MFC 写的分行阅读器

产线传来一份 Gerber 文件，双击开来只有记事本，一屏全是 X/Y 坐标和 G 代码，想确认某个焊盘到底在不在，只能拿眼睛一行行扫。这个基于 VS + MFC 的 VC 工程就干这一件事：把 Gerber 文件按行读进来，左边挂序号、右边显示原始指令，顺手把类型、坐标、D 码标出来，翻起来像一份带目录的文本。它不画图形，也不做完整的 PCB 预览，定位就是「读得动、看得清、改得快」的小工具，适合天天要核对制造数据的工艺人员和想拿 MFC 练手的开发者——题里的 gerbera 就是 Gerber，PCB 行业的标准制造文件格式。

2. 工程骨架：VS + MFC + VC 的取舍与目录结构

2.1 这个场景为什么还轮得到 MFC

真正天天用这个工具的人往往在产线电脑上干活，那些机器上什么运行时都没装，拷一个 exe 过去双击就得能用。这一点直接决定了技术选型：MFC 静态链接可以把整个程序压成单文件，不依赖 .NET 的版本，也不用像 Qt 那样拖一堆 dll 过去；CFileDialog 原生就是资源管理器风格，选文件、记住上次目录几乎零成本；CListCtrl 的虚拟列表模式天生适合「数据几万行、屏幕只显示四十行」的场景，比自己画滚动视图省事太多。

代价也得说清楚：MFC 的观感停留在十年前，控件样式不自己写 OwnerDraw 就不好看；Unicode 与 ANSI 混用时字符串转换能让人掉一层皮；想加个深色主题基本等于重画。所以我一般把这个工程的定位写死——内部工具、单文件分发、功能专一。哪天真要做成对外发的商业软件，界面层换 Qt 或者直接上 Web 都行，但读文件和解析这两层必须能原封不动搬走，这也是下面目录结构把Gerber/单独拎出来的原因。

2.2 目录结构：解析层和界面层必须切开

一个能长期维护的小工具，靠的不是代码写得多漂亮，而是边界划得够狠。这个工程里界面层只认一个std::vector<CGerberLine>，其余的都不关心。

GerberLineView/ ├─ GerberLineView.sln └─ GerberLineView/ ├─ GerberLineView.vcxproj 工程文件，字符集/静态 MFC 都在这里配 ├─ pch.h / pch.cpp 预编译头，afxwin.h 在这里一次性吃进去 ├─ framework.h ├─ GerberLineView.h/.cpp CWinApp 派生类，应用入口 ├─ GerberLineViewDlg.h/.cpp 主对话框：打开文件、灌列表、响应消息 ├─ Gerber/ 纯解析层，不 include 任何控件头 │ ├─ GerberLine.h 一条指令的结构体与命令枚举 │ ├─ GerberReader.h/.cpp 读文件、切命令、解析坐标 │ └─ GerberFormat.h FS/MO 状态机需要的格式参数 └─ res/ ├─ GerberLineView.rc 对话框模板和控件都在这里摆 ├─ resource.h 控件 ID，改之前先搜一遍有没有被引用 └─ GerberLineView.ico

工程属性里有几项不能随便动，动错了表现往往是「Debug 好好的，拷到别的机器就起不来」：

2.3 入口与主对话框：三行代码定骨架

这个程序不需要主框架窗口、不需要文档视图，单对话框就够。入口里只做三件事，多余的都别往里塞。

// GerberLineView.cpp —— 应用入口，只负责初始化公共控件、建对话框、跑消息循环 BOOL CGerberLineViewApp::InitInstance() { // 列表控件、进度条这些都属于 Common Controls，不注册窗口类 Create 会失败 INITCOMMONCONTROLSEX icc = { sizeof(icc), ICC_WIN95_CLASSES | ICC_LISTVIEW_CLASSES }; InitCommonControlsEx(&icc); CWinApp::InitInstance(); AfxEnableControlContainer(); // 记住上次打开的目录、窗口位置，注册表落在 HKCU\Software\GerberTools 下 SetRegistryKey(_T("GerberTools")); CGerberLineViewDlg dlg; // 单对话框应用，不建 CFrameWnd m_pMainWnd = &dlg; dlg.DoModal(); // 消息循环由 DoModal 内部跑，跑完才返回 return FALSE; // 返回 FALSE 表示不再进 CWinApp::Run }

InitCommonControlsEx里的ICC_LISTVIEW_CLASSES是最容易漏的一行，漏了以后现象很玄学：对话框能弹出来，列表控件区域一片空白，也不报错。SetRegistryKey决定了后面GetProfileString/WriteProfileString落到哪里，改成自己的名字就行，别用默认的。DoModal之后return FALSE是老规矩，返回 TRUE 会让CWinApp::Run再跑一遍消息循环，表现为关掉窗口进程还挂在任务管理器里。

3. 解析核心：一条 Gerber 指令从字节流到结构体

3.1 先看懂一条指令：*是结束符，不是分隔符

很多人在这一步翻车，就是把 Gerber 当成 CSV 一样按行切。它的语法里命令结束符是*，换行符只是排版用的，规范允许一条物理行里塞好几条指令，也允许一条指令跨行——所以「分行显示」这件事，分的是逻辑指令，不是物理行。一段典型的头部长这样：

%FSLAX24Y24*% %MOMM*% %ADD10C,0.2500*% D10* X100000Y200000D02* X120000Y200000D01* M02*

逐条读：%FSLAX24Y24*%是格式说明，L 表示省略前导零、A 表示绝对坐标，X 和 Y 各是 2 位整数加 4 位小数；%MOMM*%说单位是毫米；%ADD10C,0.2500*%定义 D10 这个光圈是直径 0.25mm 的圆；D10*选中它；X100000Y200000D02*是抬笔移动到 (10.0000, 20.0000)；D01是落笔画线；M02是文件结束。%...%包起来的叫扩展命令，G04开头的是注释，这两类在列表里应该给不同颜色，否则一眼扫过去全是噪声。

3.2 读文件：一次读完比分段读更稳

解析层的第一段代码是Load。这里我没用CStdioFile::ReadString逐行读，而是按字节全读进来再切——原因是CStdioFile在 Unicode 工程下的行为跟文件实际编码容易错位，中文路径再叠上来就更难查。

// GerberReader.cpp —— 整文件读入内存，大小先卡一道，避免误选十几个 G 的压缩包 bool CGerberReader::Load(LPCTSTR path, std::vector<CGerberLine>& out, CString& err) { CFile file; if (!file.Open(path, CFile::modeRead | CFile::shareDenyWrite | CFile::typeBinary)) { err = _T("文件打不开，可能正被别的程序占用，或者路径里含非法字符"); return false; } ULONGLONG len = file.GetLength(); if (len == 0) { err = _T("文件是空的"); return false; } if (len > 64ull * 1024 * 1024) { err = _T("超过 64MB，先确认是不是选错了文件"); return false; } std::string raw; raw.resize((size_t)len); file.Read(raw.data(), (UINT)len); // 本地磁盘上 20MB 也就百来毫秒 file.Close(); // Gerber 基本是纯 ASCII，按系统代码页转宽字符足够；真遇到 UTF-8 带 BOM 再单独判 int wlen = ::MultiByteToWideChar(CP_ACP, 0, raw.data(), (int)raw.size(), nullptr, 0); std::wstring text((size_t)wlen, L'\0'); ::MultiByteToWideChar(CP_ACP, 0, raw.data(), (int)raw.size(), &text[0], wlen); out.clear(); out.reserve(4096); // 预分配一笔，十万行也不会频繁扩容 SplitCommands(text, out); return true; }

参数逐个说：CFile::shareDenyWrite是防止读一半被别人写坏；typeBinary很关键，文本模式会把\r\n自动折叠，切分逻辑就对不上了；64MB 这个阈值是给自己留的后悔药，真实 Gerber 单层通常几 MB 到十几 MB，超过这个数八成是选错了文件或者选了整包。reserve(4096)只是起步值，十万行的文件照样会扩容几次，但比一次不预留强很多。

3.3 切行与解析：CGerberLine与坐标还原

切分的核心规则就一条：遇到*收一条，如果后面紧跟%就一起吃掉，那是扩展命令的尾巴。

// 以 '*' 为命令结束符切分，同时记下物理行号，方便和记事本对照 void CGerberReader::SplitCommands(const std::wstring& text, std::vector<CGerberLine>& out) { std::wstring cur; cur.reserve(128); int physical = 1; // 物理行号，从 1 开始 for (size_t i = 0; i < text.size(); ++i) { wchar_t c = text[i]; if (c == L'\r') continue; // CRLF 只认 LF，回车直接吞 if (c == L'\n') { ++physical; if (cur.empty()) continue; } cur.push_back(c); if (c != L'*') continue; // 还没到命令结尾，继续攒 // %FSLAX24Y24*% 这种，星号后面还有个百分号，得一起收进来 if (i + 1 < text.size() && text[i + 1] == L'%') cur.push_back(text[++i]); CGerberLine ln; ln.no = (int)out.size() + 1; // 指令序号，列表第一列 ln.physical = physical; // 物理行号，列表第五列 ln.raw = cur.c_str(); ParseOne(ln); out.push_back(ln); cur.clear(); } if (!cur.empty()) // 结尾缺 * 的残行，别丢，标成可疑 { CGerberLine ln; ln.no = (int)out.size() + 1; ln.physical = physical; ln.raw = cur.c_str(); ln.cmd = EGerberCmd::Unknown; out.push_back(ln); } }

CGerberLine本身很轻，只有五个字段，因为要装十几万条，多一个CString就是几十兆：

// GerberLine.h enum class EGerberCmd { Unknown, Comment, Extended, SetAperture, Move, Draw, Flash, Arc, EndOfFile }; struct CGerberLine { int no; // 指令序号，从 1 开始 int physical; // 在记事本里看到的行号 CString raw; // 原始文本，显示用，永远不要就地修改 EGerberCmd cmd; bool hasXY; // 只有 D01/D02/D03 才有坐标 double x, y; // 已统一换算成毫米 int aperture; // D 码，比如 10；没选光圈时为 -1 };

坐标还原这一段最容易出错。FSLAX24表示省略前导零，X100000实际是 6 位数字，前 2 位整数、后 4 位小数，所以是 10.0000；但如果写的是X100，就得补成000100再算。单位是英寸时还要乘 25.4，否则列表里一堆 0.3937 会把人对晕。

// 把 "100000" 按 2 位整数 + 4 位小数还原；LA 模式需要在左边补零 double CGerberReader::ScaleCoord(const CString& digits, int intLen, int decLen) { CString s = digits; int need = intLen + decLen; while (s.GetLength() < need) s = _T("0") + s; // 前导零省略，这里补回来 if (s.GetLength() > need) s = s.Right(need); // 超长按规范截尾 double v = _ttof(s) / pow(10.0, decLen); if (m_bInch) v *= 25.4; // %MOIN*% 时统一换成毫米 return v; }

intLen和decLen不是硬编码的，是从%FSLAX24Y24*%里现读出来的——有的老设备导出的文件是 X25、X23，写死就废了。m_bInch由%MOIN*%或%MOMM*%设置，遇到一条就更新一次状态。

4. 分行显示：用 CListCtrl 虚拟列表撑住十万行

4.1 为什么把文本塞进 CEdit 是个坑

最省事的写法是把整个文件SetWindowText到一个多行编辑框里，五行代码搞定。但Gerber 文件动辄几万条指令，编辑框会开始卡：光标一移动就整块重绘，滚动条拖动明显掉帧；想给注释行换个颜色基本没戏；想「跳到第 8000 行」还得自己算字符偏移再EM_SETSEL，算错一位就跳歪。这些坑我在别的项目里全踩过一遍，所以这里直接上CListCtrl的报告视图加LVS_OWNERDATA——它不会为每一条数据建一个LVITEM，只在需要绘制某几行时才回调问你要。

4.2 虚拟列表：只回答看得见的那几十行

虚拟列表有两个前提，缺一不可：资源编辑器里给列表控件勾上Owner data，代码里再调SetItemCountEx。少任何一个，表现都是空白，还不报错。

BOOL CGerberLineViewDlg::OnInitDialog() { CDialogEx::OnInitDialog(); CListCtrl& lst = m_list; lst.SetExtendedStyle(LVS_EX_FULLROWSELECT | LVS_EX_DOUBLEBUFFER | LVS_EX_GRIDLINES); lst.InsertColumn(0, _T("序号"), LVCFMT_RIGHT, 70); lst.InsertColumn(1, _T("原始指令"), LVCFMT_LEFT, 420); lst.InsertColumn(2, _T("类型"), LVCFMT_LEFT, 90); lst.InsertColumn(3, _T("X, Y (mm)"), LVCFMT_LEFT, 160); lst.InsertColumn(4, _T("物理行"), LVCFMT_RIGHT, 70); return TRUE; } // 文件解析完，只登记总数，一行都不建 void CGerberLineViewDlg::RefreshList() { m_list.SetItemCountEx((int)m_lines.size(), LVSICF_NOSCROLL); m_list.Invalidate(FALSE); }

真正干活的是LVN_GETDISPINFO。它对每个可见单元格调一次，你的任务就是把pszText填好、别越界、别返回临时对象的指针。

void CGerberLineViewDlg::OnGetdispinfoList(NMHDR* pNMHDR, LRESULT* pResult) { NMLVDISPINFO* pDI = reinterpret_cast<NMLVDISPINFO*>(pNMHDR); *pResult = 0; if (pDI->item.iItem < 0 || (size_t)pDI->item.iItem >= m_lines.size()) return; const CGerberLine& ln = m_lines[(size_t)pDI->item.iItem]; switch (pDI->item.iSubItem) { case 0: _stprintf_s(pDI->item.pszText, pDI->item.cchTextMax, _T("%d"), ln.no); break; case 1: _tcscpy_s (pDI->item.pszText, pDI->item.cchTextMax, (LPCTSTR)ln.raw); break; case 2: _tcscpy_s (pDI->item.pszText, pDI->item.cchTextMax, CmdName(ln.cmd)); break; case 3: if (ln.hasXY) _stprintf_s(pDI->item.pszText, pDI->item.cchTextMax, _T("%.3f, %.3f"), ln.x, ln.y); else pDI->item.pszText[0] = _T('\0'); break; case 4: _stprintf_s(pDI->item.pszText, pDI->item.cchTextMax, _T("%d"), ln.physical); break; default: break; } }

cchTextMax是 Windows 给的缓冲区长度，一般 260 起步，_stprintf_s和_tcscpy_s都必须带上它，这是 Release 崩溃的头号来源。CmdName返回LPCTSTR常量字符串，别在里面返回CString的临时对象——函数一返回指针就悬空了。

4.3 着色、跳转与搜索：让十万行能被人用

光能显示还不够，人眼在一屏四十行里找一条D03是徒劳的。给不同指令上色是最省成本的改造，用NM_CUSTOMDRAW只改文字颜色，不动背景，避免整行重绘的闪烁：

void CGerberLineViewDlg::OnNMCustomdrawList(NMHDR* pNMHDR, LRESULT* pResult) { NMLVCUSTOMDRAW* pCD = reinterpret_cast<NMLVCUSTOMDRAW*>(pNMHDR); *pResult = CDRF_DODEFAULT; if (pCD->nmcd.dwDrawStage == CDDS_PREPAINT) { *pResult = CDRF_NOTIFYITEMDRAW; return; } if (pCD->nmcd.dwDrawStage != CDDS_ITEMPREPAINT) return; size_t idx = (size_t)pCD->nmcd.dwItemSpec; if (idx >= m_lines.size()) return; switch (m_lines[idx].cmd) { case EGerberCmd::Comment: pCD->clrText = RGB(120, 120, 120); break; // 注释灰掉 case EGerberCmd::Draw: pCD->clrText = RGB(0, 80, 200); break; // D01 画线蓝 case EGerberCmd::Flash: pCD->clrText = RGB(0, 130, 0); break; // D03 闪光绿 case EGerberCmd::Unknown: pCD->clrText = RGB(200, 0, 0); break; // 认不出的标红 default: break; } }

跳转用EnsureVisible加选中，比滚动条可靠得多：m_list.EnsureVisible(gotoIdx, FALSE); m_list.SetItemState(gotoIdx, LVIS_SELECTED | LVIS_FOCUSED, LVIS_SELECTED | LVIS_FOCUSED);。搜索时不要遍历控件，直接遍历m_lines对raw做Find，虚拟列表的索引和vector下标是一一对应的，这就是把解析层和界面层切开换来的好处。

5. 避坑与排查：只在真实文件上才炸的五个问题

5.1 中文路径下读不到内容

现象：同一份文件放在D:\gerber\下能打开，放到D:\新建文件夹\板子\下就提示打不开，或者读出来是一堆乱码。

原因：工程是 Unicode 字符集，但内部某处用了fopen或者把CString强转成const char*传给 CRT，路径在中途被截断或按 ANSI 解释，非中文区域就变成了问号。

解决：整条链路统一走TCHAR和CFile，不要为了图快调 CRT 的文件接口。确实需要转换时明确写CW2A(p, CP_UTF8)或CA2W(p, CP_ACP)，别用隐式转换。

5.2 最后一条指令总是不显示

现象：文件末尾那条M02*或者最后一个D03*在列表里找不到，用记事本打开明明有。

原因：切分循环里写了if (pos == npos) break;这类提前退出，末尾没有结束符的残余内容被直接丢掉；另一种是文件末尾没有换行，ReadString的最后一次返回没被处理。

解决：循环结束后必须检查cur是否为空，非空就当成一条「残行」收进去并标记为Unknown，宁可标红也别静默吞掉——这类丢数据的 bug 最难被发现，因为界面看起来一切正常。

5.3 十万行的文件一打开就「未响应」

现象：双击打开文件后标题栏变成「无响应」，进度条不走，几十秒后才刷出来。

原因：读取、解析、SetItemCountEx全塞在 UI 线程里，中间没有一次PeekMessage，Windows 超过五秒收不到消息就判定假死。

解决：把Load放到工作线程，线程里只碰m_lines和CGerberReader，绝对不碰任何控件；解析完PostMessage(m_hWnd, WM_APP + 1, 0, 0)回主线程再刷新列表。中间进度用PostMessage传百分比，别用SendMessage，会死锁。

UINT CGerberLineViewDlg::LoadThread(LPVOID p) { auto* self = static_cast<CGerberLineViewDlg*>(p); CString err; self->m_lines.clear(); bool ok = self->m_reader.Load(self->m_path, self->m_lines, err); // 只碰数据 ::PostMessage(self->m_hWnd, WM_APP + 1, (WPARAM)ok, 0); // 回主线程刷新 return 0; }

5.4 列表行号和记事本对不上

现象：用户按列表第 37 行去记事本找第 37 行，内容完全不是一回事，然后开始怀疑工具坏了。

原因：Gerber 以*结束命令，换行只是排版，很多 CAM 软件导出时会把三四条指令写在同一个物理行。你按物理行切，人家按逻辑指令数，两边当然对不上。

解决：两个行号都要有。第一列给指令序号，第五列给物理行号，标题写清楚「序号 / 物理行」，用户自己会选该信哪个。这是纯展示层的事，一行ln.physical = physical就能省掉无数解释。

5.5 Debug 能跑，Release 一闪就退

现象：Debug 下点开文件一切正常，切 Release 编译出来，打开稍大一点的文件直接消失，事件查看器里也没留下什么有用信息。

原因：LVN_GETDISPINFO里把pDI->item.pszText直接赋成了CString的临时缓冲区指针，或者_stprintf_s的第二个参数传了个估算的长度，越界写坏了堆。Debug 下有填充字节和运行时检查兜着，Release 一优化立刻现原形。

解决：所有写入严格用pDI->item.cchTextMax；禁止pszText = (LPTSTR)(LPCTSTR)str这种写法；Debug 阶段打开/RTC1和 Application Verifier 先跑一遍大文件，比事后猜要省时间得多。

6. 二次开发：把「能看」改成「能校验、能导出、能批量」

这份工程当阅读器用已经够，但真正有价值的改造是让它从「看」变成「查」。我一般按下面这个顺序加，每一步都能独立交付，不会互相拖累：

校验器是投入产出比最高的一项。做法很简单：在ParseOne里维护一个std::set<int> m_definedApertures，遇到%ADD就塞进去，遇到D10*这类选择指令时查一下集合，没定义就把这条CGerberLine的cmd改成Unknown并附一句原因。列表里立刻一片红，工艺员一眼就知道这份文件被改坏了。注意校验必须放在解析之后单独走一遍，别混进ParseOne里，否则解析和校验耦合在一起，后面想关掉校验都关不干净。

导出 CSV 的坑在编码。Excel 默认按 GBK 打开无 BOM 的文本，中文列名会变乱码，所以文件开头必须先写\xEF\xBB\xBF三个字节的 UTF-8 BOM，再用CStdioFile写 UTF-8 内容。这个细节我吃过亏——导出的表在同事机器上全是问号，排查了半小时才发现是 BOM 的锅。

命令行模式更适合产线：把一个目录下的所有 Gerber 批量跑一遍校验，有问题就返回非零退出码，脚本里if errorlevel 1直接拦下来，比人工一个个点开看靠谱得多。实现上就是在InitInstance里判断__argc > 1，走无界面的分支，跑完return FALSE退出，完全不用建对话框。

从那以后我每次接这类「看着简单」的文件解析需求，都先把读文件那一层抽成不依赖 MFC 的纯 C++ 类，再用一个几十行的控制台程序跑通，最后才接界面——省下来的调试时间远比多写的那点代码值。压缩包解开就是一个完整的 VS 解决方案，双击.sln重定向一下工具集就能编译，希望帮到你。

本文还有配套的精品资源，点击获取