简介：这份资源面向使用 Visual Studio 与 MFC 进行桌面开发的 C++ 学习者，以及需要查看 PCB 设计文件的硬件工程师，解决 Gerber 文件内容难以直观浏览与逐行核对的问题。资源包共 25 个文件，约 150KB，以 h 头文件与 cpp 源文件为主，辅以 vcxproj、sln 工程配置、rc 资源脚本、ico 图标及 ReadMe 说明，构成一个可直接编译运行的 MFC 工程。项目围绕 Gerber 格式解析展开，涉及 RS-274X 指令集、坐标与单位处理，并通过 CListCtrl 将解析结果逐行呈现，同时借助 CFileDialog 完成文件选择与读取流程。代码中划分了文件读取、字符串处理、页面显示等模块，便于读者理解 MFC 消息机制、控件重载与异常处理思路。目前已有 801 人学习，适合希望提升 C++ 工程实践与 PCB 数据解析能力的开发者参考。
1. 从一块 Gerber 文件说起：为什么 MFC 里读它总翻车
如果你在 PCB 行业待过，大概率遇到过这种需求：客户丢过来一个.gbr文件，让你在 Windows 桌面端把它读出来，按行显示在界面上，最好还能高亮坐标和 D 码。听起来简单，但真动手写，你会发现 Gerber 根本不是「文本文件」那么简单——它是一套有状态机的矢量图形描述格式，RS-274X 标准里藏着光圈定义、坐标格式省略、模态指令这些坑。用 VS 建一个 MFC 工程，VC 环境下用 CStdioFile 逐行读，十有八九会在%ADD或G54D10这类行上卡住。这篇笔记拆的就是一个「读取 Gerber 文件并分行显示」的 MFC 小工具，适合刚接触 CAM 前端、需要快速做文件预览的 VC 开发者，也适合想搞懂 Gerber 解析边界的老手。它不追求渲染出完整 PCB 图形，只解决一件事：把文件内容可靠地拆行、解析、显示出来，为后续的图形化或数据提取打底。
2. Gerber 分行读取的底层逻辑：RS-274X 状态机与 MFC 文件流
2.1 为什么不能直接按\n切
Gerber 文件在 RS-274X 规范里，行结束符理论上可以是LF、CR、CRLF，甚至有些老设备导出时混用。更麻烦的是，一条完整的「命令」不一定只占一行——比如坐标数据可以跨行，而%包裹的扩展指令（如%FSLAX46Y46*%）内部用*分隔，末尾才用%收尾。如果你用CStdioFile::ReadString按行读，遇到%块跨行时就会把一条指令拆成两半，显示出来全是碎片。
常见做法是：先把整个文件按二进制读进CByteArray或std::string，然后自己写一个分词器，按*和%作为分隔符切分，而不是按换行符。这样得到的「逻辑行」才是 Gerber 解析器真正要处理的最小单元。分行显示时，再把逻辑行按原始换行位置还原成物理行，或者直接按逻辑行显示——取决于你是想「看原始文件」还是「看解析结果」。
2.2 MFC 里读文件的三种姿势与选型
在 VC 环境下，MFC 提供了CFile、CStdioFile、CArchive几条路。CStdioFile适合文本行读写，但遇到二进制或混合编码就力不从心；CFile最底层，读写字节流最稳；CArchive通常配合序列化，读 Gerber 这种非结构化文本反而绕。
我一般会这样选：用CFile以CFile::modeRead | CFile::typeBinary打开，一次性读入ULONGLONG长度，然后转成std::string做后续分词。这样既避开了 MFC 文本模式对\r\n的自动转换，也方便处理文件里可能出现的非 ASCII 字节（比如某些注释里的中文）。
// 用 CFile 二进制读取整个 Gerber 文件 CFile file; if (!file.Open(strPath, CFile::modeRead | CFile::typeBinary)) { AfxMessageBox(_T("文件打开失败")); return; } ULONGLONG len = file.GetLength(); std::string buffer; buffer.resize(static_cast<size_t>(len)); file.Read(&buffer[0], static_cast<UINT>(len)); file.Close(); // 按 * 和 % 切分逻辑行，保留原始换行信息 std::vector<std::string> logicalLines; std::string current; for (char ch : buffer) { if (ch == '*' || ch == '%') { current.push_back(ch); logicalLines.push_back(current); current.clear(); } else if (ch == '\r' || ch == '\n') { // 换行符单独记录，用于还原物理行 if (!current.empty()) { logicalLines.push_back(current); current.clear(); } logicalLines.push_back(std::string(1, ch)); } else { current.push_back(ch); } } if (!current.empty()) logicalLines.push_back(current);这段代码的关键点：*和%都作为逻辑行结束符，换行符单独存成一个元素，这样后续既可以按逻辑行显示，也可以按物理行还原。参数上，CFile::typeBinary必须加，否则 MFC 会在读到0x1A时提前截断。buffer.resize之后直接Read到&buffer[0]是 C++11 起保证连续存储的写法，比GetBuffer更干净。
2.3 分行显示时怎么处理坐标省略和模态指令
Gerber 的坐标格式由%FSLAX46Y46*%这类指令定义，X46表示整数 4 位、小数 6 位，但实际数据里经常省略前导零。比如X1000Y2000D01*在 4.6 格式下表示X=0.001000、Y=0.002000。如果你只是分行显示原始文本，那没问题；但如果要在显示时顺便解析出坐标值，就必须先读FS指令，再按格式补零。
另一个坑是模态指令：D01、D02、D03一旦出现，后续坐标行如果省略 D 码，就沿用上一个。分行显示时，我建议在每行前面加一个行号，并在解析结果里标注「继承的 D 码」，这样调试时一眼能看出状态机有没有跑偏。
// 简单的坐标解析示例：假设已读到 FS 指令，格式为 4.6 struct GerberState { int intDigits = 4; int decDigits = 6; int lastDCode = 0; double lastX = 0.0, lastY = 0.0; }; // 解析一行坐标数据（简化版） bool ParseCoordLine(const std::string& line, GerberState& state, CString& display) { // 查找 X 和 Y size_t xPos = line.find('X'); size_t yPos = line.find('Y'); size_t dPos = line.find('D'); double x = state.lastX, y = state.lastY; int dCode = state.lastDCode; auto parseNum = [&](size_t pos, int digits) -> double { if (pos == std::string::npos) return 0.0; size_t end = line.find_first_of("XYD*", pos + 1); std::string numStr = line.substr(pos + 1, end - pos - 1); // 补零到总位数 while (numStr.length() < static_cast<size_t>(digits)) numStr = "0" + numStr; double val = atof(numStr.c_str()); return val / pow(10, state.decDigits); }; if (xPos != std::string::npos) x = parseNum(xPos, state.intDigits + state.decDigits); if (yPos != std::string::npos) y = parseNum(yPos, state.intDigits + state.decDigits); if (dPos != std::string::npos) { dCode = atoi(line.substr(dPos + 1, 2).c_str()); state.lastDCode = dCode; } state.lastX = x; state.lastY = y; display.Format(_T("X=%.6f Y=%.6f D=%02d"), x, y, dCode); return true; }这里parseNum里的补零逻辑是核心：Gerber 允许省略前导零，也允许省略后导零，具体看FS指令里的L还是T。上面按「省略前导零」处理，实际项目里要根据FSLA还是FSTA切换。pow(10, decDigits)那一步如果decDigits是变量，记得用pow而不是整数除法，否则精度直接崩。
3. 在 VS MFC 里搭一个可用的 Gerber 分行查看器
3.1 工程创建与界面控件布局
在 VS 里新建一个 MFC 应用，选「基于对话框」还是「单文档」看需求。如果只是分行显示，对话框足够：拖一个CListCtrl做行显示，一个CButton做打开文件，一个CEdit做过滤关键字。CListCtrl设成Report风格，加两列：行号和内容。行号用InsertItem的nItem参数自动生成，内容用SetItemText填。
注意CListCtrl默认只显示第一列，要在OnInitDialog里调SetExtendedStyle(LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES)，否则选中整行时只有第一列高亮，看起来像半成品。列宽用SetColumnWidth设，内容列给个 800 像素，行号列 60 像素足够。
3.2 文件读取与分行填充的完整流程
把 2.2 的读取逻辑封装成一个LoadGerberFile函数，在按钮响应里调用。填充CListCtrl时，如果文件超过几千行，直接InsertItem会卡 UI。常见做法是先用SetRedraw(FALSE)关重绘，填完再SetRedraw(TRUE)+Invalidate。更稳的是用虚拟列表LVS_OWNERDATA，但那个要处理LVN_GETDISPINFO，代码量翻倍。对于 Gerber 这种通常几万行以内的文件，关重绘就够了。
void CGerberViewDlg::LoadGerberFile(const CString& strPath) { // 读取文件（复用 2.2 的 CFile 逻辑） std::vector<std::string> lines = ReadGerberLines(strPath); m_listCtrl.SetRedraw(FALSE); m_listCtrl.DeleteAllItems(); int nItem = 0; for (const auto& line : lines) { // 跳过纯换行符，或者按需显示 if (line == "\r" || line == "\n") continue; CString strLine(line.c_str()); m_listCtrl.InsertItem(nItem, _T("")); // 行号列稍后填 m_listCtrl.SetItemText(nItem, 0, CString(std::to_wstring(nItem + 1).c_str())); m_listCtrl.SetItemText(nItem, 1, strLine); nItem++; } m_listCtrl.SetRedraw(TRUE); m_listCtrl.Invalidate(); }ReadGerberLines里把 2.2 的分词逻辑包一层，返回std::vector<std::string>。注意CString构造时如果line里有非 ASCII 字节，直接CString(line.c_str())在 Unicode 工程下会乱码。稳妥做法是用CA2T或MultiByteToWideChar显式转换，编码按CP_ACP或CP_UTF8试。Gerber 文件一般是 ASCII，但注释里偶尔有中文，这一步不能省。
3.3 关键字过滤与高亮显示
分行显示之后，用户往往想快速定位%ADD或某个 D 码。在CEdit里输入关键字，遍历CListCtrl的每一行，匹配到的用SetItemText改颜色——但CListCtrl原生不支持单行变色，得用NM_CUSTOMDRAW消息。在OnCustomDraw里判断lplvcd->nmcd.dwItemSpec对应的行是否包含关键字，是就改clrText和clrTextBk。
// 在对话框类里加 ON_NOTIFY(NM_CUSTOMDRAW, IDC_LIST1, OnCustomDraw) void CGerberViewDlg::OnCustomDraw(NMHDR* pNMHDR, LRESULT* pResult) { LPNMLVCUSTOMDRAW lplvcd = reinterpret_cast<LPNMLVCUSTOMDRAW>(pNMHDR); *pResult = CDRF_DODEFAULT; if (lplvcd->nmcd.dwDrawStage == CDDS_PREPAINT) { *pResult = CDRF_NOTIFYITEMDRAW; } else if (lplvcd->nmcd.dwDrawStage == CDDS_ITEMPREPAINT) { int nItem = static_cast<int>(lplvcd->nmcd.dwItemSpec); CString strText = m_listCtrl.GetItemText(nItem, 1); if (!m_strFilter.IsEmpty() && strText.Find(m_strFilter) != -1) { lplvcd->clrTextBk = RGB(255, 255, 0); // 黄色高亮 } *pResult = CDRF_DODEFAULT; } }m_strFilter在CEdit的EN_CHANGE里更新，然后m_listCtrl.Invalidate()触发重绘。注意NM_CUSTOMDRAW里不要做耗时操作，否则滚动会卡。如果关键字很多，建议先在LoadGerberFile时把匹配行号存进std::set，OnCustomDraw里只查表，别每次Find。
4. 避坑与排查：Gerber 分行显示里最容易翻车的五件事
4.1 现象：读出来的行数比实际少一半
原因：CStdioFile::ReadString在文本模式下遇到0x1A（Ctrl+Z）会当 EOF 处理，而某些 Gerber 文件里恰好有这个字节。解决：改用CFile二进制模式读，或者CStdioFile打开时加CFile::typeBinary。已经用ReadString的，检查文件里有没有0x1A，有就换方案。
4.2 现象：%块被拆成多行，显示错乱
原因：按\n分行，但%FSLAX46Y46*%这类指令内部没有换行，末尾的%和下一行之间可能有\r\n，导致%单独成行。解决：按 2.2 的逻辑，用*和%作为逻辑行分隔符，换行符只作为显示时的参考。如果必须按物理行显示，在解析时把%块合并，显示时再按原始位置拆开。
4.3 现象：坐标解析出来全是 0 或者数量级不对
原因：FS指令里的L和T没区分。FSLA表示省略前导零，FSTA表示省略后导零。代码里统一按补前导零处理，遇到FSTA的文件就全错。解决：在读FS指令时记下L还是T，解析坐标时按对应规则补零。FSLAX46Y46*%里L后面的A是绝对坐标，I是增量坐标，也要区分。
4.4 现象：CListCtrl插入几万行后界面卡死
原因：每次InsertItem都触发重绘和消息循环，行数一多就指数级变慢。解决：SetRedraw(FALSE)包住整个填充过程，填完再SetRedraw(TRUE)+Invalidate。如果还卡，改用虚拟列表LVS_OWNERDATA，只在实际绘制时提供数据。
4.5 现象：中文注释显示成乱码
原因：Gerber 文件编码可能是 GBK 或 UTF-8，而 MFC 工程默认 Unicode，CString构造时按CP_ACP解释，遇到 UTF-8 就乱。解决：读文件后先检测 BOM，有 UTF-8 BOM 就按 UTF-8 转宽字符；没有 BOM 的，用MultiByteToWideChar分别试CP_UTF8和CP_ACP，看哪个能解出合法字符。稳妥点就在界面加个编码下拉框，让用户手动选。
5. 进阶：把分行结果导出成结构化 CSV 并做坐标校验
分行显示只是第一步，真正干活时往往要把解析结果导出去给别的工具用。我一般会在LoadGerberFile之后加一个「导出 CSV」按钮，把每行的行号、原始内容、解析出的 X/Y/D 码写进文件。这样既方便用 Excel 核对，也能拿 Python 做二次校验。
void CGerberViewDlg::ExportToCsv(const CString& strPath) { CStdioFile file; if (!file.Open(strPath, CFile::modeCreate | CFile::modeWrite | CFile::typeText)) { AfxMessageBox(_T("导出失败")); return; } file.WriteString(_T("行号,原始内容,X,Y,D码\n")); GerberState state; int nCount = m_listCtrl.GetItemCount(); for (int i = 0; i < nCount; i++) { CString strLine = m_listCtrl.GetItemText(i, 1); CString strDisplay; // 这里调用 2.3 的 ParseCoordLine，注意传 CT2A 转 std::string CT2A asciiLine(strLine); ParseCoordLine(std::string(asciiLine), state, strDisplay); CString strOut; strOut.Format(_T("%d,\"%s\",%s\n"), i + 1, strLine, strDisplay); file.WriteString(strOut); } file.Close(); }导出之后，用 Python 的pandas读 CSV，检查 X/Y 是否在板框范围内，D 码是否都在%ADD里定义过。这一步能抓出很多解析阶段的隐性错误——比如某个D码没定义，但分行显示时看不出来，一校验就露馅。
import pandas as pd df = pd.read_csv("gerber_export.csv") # 检查 D 码是否都在已知集合里 known_dcodes = {10, 11, 12} # 从 %ADD 指令里提取 unknown = df[~df['D码'].isin(known_dcodes)] if not unknown.empty: print("发现未定义 D 码：") print(unknown[['行号', '原始内容', 'D码']])从那以后，我每次写完 Gerber 解析模块，都强制走一遍「导出 CSV → Python 校验」的流程，比在 MFC 里肉眼盯强太多。希望帮到你。
本文还有配套的精品资源，点击获取
