简介：《C#编写的Gerber查看器》是一款面向电子工程师与PCB设计师的轻量级CAM查看工具，基于C#语言实现Gerber文件的读取、解析与可视化，适用于PCB制造前的图形预览与层信息核对，可辅助用户快速检查设计数据，减少制造阶段因图档错误导致的返工。Gerber作为PCB制造通用格式，包含各层导电路径、孔位、丝印等关键信息，对正确解析要求较高。资源包共35个文件，压缩后仅76KB，以cs源码为核心，同时包含界面资源、应用配置与可直接运行的执行程序，结构紧凑完整。工程标记为GMDO_V4.0，采用Visual Studio解决方案组织，涵盖主窗体、解析器与图形显示模块，从文件逐行读入、指令解析到画布渲染的完整链路均有清晰呈现，学习者可快速掌握文本指令的解析思路，构建对象模型并借助图形框架完成展示。目前已有3640人学习下载，对于希望深入Gerber文件格式或从事PCB/CAM工具开发的读者，这套带完整源码和工程配置的项目实例具有直接的参考价值与二次开发基础。
1. 这个C# Gerber查看器：一个能直接拉起来看PCB图的小工具
某个周五下午，你拿到一块刚投板的样片，想确认顶层铜和钻孔是否对得上，结果打开工作站上的专业CAM工具，弹出授权到期提示，运维又休假了。这时候一个两兆不到、用C#写的Gerber查看器，反而成了全组最后一根救命稻草。它做的事情非常朴素：把Gerber 文件读进来，按铜箔、阻焊、丝印、钻孔分成图层，显示成能缩放、能测距的二维图形，并允许你点任意一段走线查看所属D码和光圈尺寸。项目本身不是一个玩具Demo，而是把Gerber读入源码、图层组织、矢量渲染、鼠标交互完整跑通的工程代码。适合三类人：PCB工程师当应急看图工具，CAM软件二次开发者做解析参考，还有想弄懂Gerber格式的C#新手。
2. 整体架构与模块划分：解析、模型、渲染三层分离
2.1 技术选型：为什么是C#和WinForms
Gerber查看器在本质上不是图形编辑器，它是一个“解析 + 几何计算 + 2D绘制”的流水线。C#在这条链路里相当顺手：List<T>管理百万级图元不痛苦，System.Drawing提供了成熟的画刷、路径和矩阵变换，垃圾回收把内存释放的黑匣子也包掉了。项目采用的是WinForms而不是WPF，原因很实际：PCB业界大量工具都跑在Windows上，GDI+的绘制模型比WPF的硬件加速更容易预测性能，并且WinForms对低配办公电脑兼容更好，打开几百兆的大板子时不容易掉帧。
如果你拿到这份源码准备迁移到Linux，要注意System.Drawing.Common在非Windows平台需要安装libgdiplus，否则画板会白屏。这个项目目前的实现绑定了Windows GDI+，跨平台是可选改造方向，但不是一个开箱即用的特性。
2.2 目录结构与工程组织
拿到源码后，第一件事是看解决方案结构。项目采用标准的三层拆分：解析库不依赖UI，UI只做绘制，测试工程独立。
GerberViewer.sln ├─ src/ │ ├─ Gerber.Core/ # 解析与数据模型 │ │ ├─ GerberParser.cs # Gerber文本解析器 │ │ ├─ ApertureTable.cs # 光圈表 │ │ ├─ GerberLayer.cs # 图层模型 │ │ ├─ Geometry/ │ │ │ ├─ GerberPrimitive.cs # 图元基类 │ │ │ ├─ GerberArc.cs # 圆弧图元 │ │ │ └─ GerberLine.cs # 直线图元 │ │ └─ Utils/CoordinateParser.cs# 坐标精度换算 │ ├─ Gerber.Viewer/ # WinForms界面 │ │ ├─ MainForm.cs # 主窗口 │ │ ├─ Renderers/GerberRenderer.cs │ │ ├─ Controls/GerberCanvas.cs # 自定义画板 │ │ └─ App.config │ └─ Gerber.Tests/ # 单元测试 │ ├─ ParserTests.cs │ └─ GeometryTests.cs ├─ samples/ # 示例Gerber文件 └─ README.mdGerber.Core是整个项目的核心，不引用任何UI类，这样二次开发时可以把解析器直接嵌进Web API或命令行工具。Gerber.Viewer里的GerberCanvas继承自Control，负责重绘、鼠标事件和缓存。看到这个结构，你应该就知道改哪个文件了：想改解析逻辑去Gerber.Core，想调颜色找GerberRenderer.cs，想改交互事件就看GerberCanvas.cs。
2.3 核心数据模型：GerberLayer、Aperture和Primitive
Gerber格式的图元只有三大类：直线、圆弧、闪光（Flash，即直接放置一个光圈形状）。项目的数据模型就围绕它们设计。
public class GerberLayer { public string Name { get; set; } public LayerType Type { get; set; } public List<GerberPrimitive> Primitives { get; } = new List<GerberPrimitive>(); public double MinX { get; set; } public double MinY { get; set; } public double MaxX { get; set; } public double MaxY { get; set; } } public enum LayerType { Copper, SolderMask, Silkscreen, Drill }GerberLayer的包围盒是渲染模块用来计算初始缩放比例的，解析器每加入一个图元就会刷新MinX/MinY/MaxX/MaxY。值得注意的是这里没有把层分成“顶层”“底层”这样的物理概念，而是让文件加载器根据文件名后缀匹配，例如.GTL映射为顶层铜箔、.GTS映射为顶层阻焊。如果你需要支持自定义层名，可以在MainForm里维护一张映射表。
光圈（Aperture）是Gerber世界的“笔”，D码对应不同形状。数据模型如下：
public class Aperture { public int Code { get; set; } public ApertureKind Kind { get; set; } public double SizeX { get; set; } public double SizeY { get; set; } public double HoleDiameter { get; set; } } public enum ApertureKind { Circle, Rectangle, Oval, Custom }ApertureTable内部是一个SortedDictionary<int, Aperture>，解析器遇到D码时就到这里查光圈。后面第3章会详细讲这个表是怎么从%AD指令构建的。
3. 核心模块拆解：Gerber读入源码的关键状态机
3.1 RS-274X指令解析：从文本行到图元对象
Gerber文件本质上是一串行指令，每一行或每几行构成一个“数据块”。解析器的难点不在正则表达式，而在状态保持：当前插补模式（直线还是圆弧）、当前D码、当前坐标、当前单位精度，这些状态下一次绘图会用到。项目的GerberParser.cs采用了一个递归下降的思路，但外层是逐行扫描。核心循环如下：
public List<GerberPrimitive> Parse(TextReader reader) { var primitives = new List<GerberPrimitive>(); var apertures = new ApertureTable(); double currentX = 0, currentY = 0; int currentDCode = 0; InterpolationMode interpolation = InterpolationMode.Linear; string line; while ((line = reader.ReadLine()) != null) { var clean = StripComment(line); // 去掉G04注释 foreach (var token in SplitTokens(clean)) { if (token.StartsWith("%AD")) // 光圈定义 { var aperture = ApertureParser.Parse(token); apertures.Set(aperture); } else if (token.StartsWith("D")) { currentDCode = ApertureParser.ParseDCode(token); interpolation = UpdateInterpolation(token); } else if (token.StartsWith("X") || token.StartsWith("Y")) { // 这里是坐标指令，逻辑稍后在 3.3 单独拆解 } } } return primitives; }这个循环有两点设计值得记住。第一，SplitTokens不是简单按空格切分，而是把Gerber特有的星号分隔符*当作断句边界。第二，UpdateInterpolation函数会根据G01/G02/G03切换直线/圆弧模式，但它必须只影响后续的D01动作，不能立刻生成图元。如果你在阅读源码时找不到“生成图元的调用”，原因就在这：Gerber的绘图指令是“先给坐标，再给D码”，所以生成动作发生在遇到D01/D02/D03那一分支里。
3.2 光圈表是如何建立和匹配的
光圈定义指令长这样：%AD D10 C,0.254*%，含义是D10、圆形、直径0.254毫米。也有的文件用矩形：%AD D12 R,0.5X0.2*%。ApertureParser.Parse会把这段文本拆成类型和参数。
public static Aperture Parse(string token) { var body = token.Replace("%AD", "").Replace("*%", ""); var codePart = body.Substring(0, body.IndexOf(' ')); // 可能直接是D10 int code = int.Parse(codePart.TrimStart('D')); var shapePart = body.Substring(body.IndexOf(' ') + 1); var parts = shapePart.Split(','); var kind = parts[0] switch { "C" => ApertureKind.Circle, "R" => ApertureKind.Rectangle, "O" => ApertureKind.Oval, _ => ApertureKind.Custom }; var aperture = new Aperture { Code = code, Kind = kind }; if (parts.Length > 1 && kind == ApertureKind.Circle) aperture.SizeX = double.Parse(parts[1]); if (parts.Length > 2) aperture.SizeY = double.Parse(parts[2]); return aperture; }这段代码没有处理HMS（热转印散热孔）那种复杂修饰，但对绝大多数PCB生产文件已经够用。你可能会遇到一个坑：同一个D10在文件中被定义了两次，比如前一层定义为圆形，后一层需要改成矩形。Gerber规范允许这种重定义，所以我在ApertureTable.Set里不做查重，直接覆盖，但会在调试输出打一条警告。这样做的原因是很多CAD软件确实会复用D码号，但图形含义不同，覆盖比报错更符合实际生产。
3.3 直线、闪光与圆弧：坐标换算的完整逻辑
Gerber坐标是整数字符串，比如X1000Y2000，它到底表示1mm还是10mm，取决于文件头的s%FSLAX24Y24*%。这里的“X24”表示整数2位、小数4位，所以1000就是0.1mm。CoordinateParser就干这个活：
public static double ParseCoordinate(string value, int intDigits, int decimalDigits) { long raw = long.Parse(value); double divisor = Math.Pow(10, decimalDigits); return raw / divisor; }注意这里一定要用long而不是int。Gerber坐标的绝对值可以到五位数，乘以10的4次方后可能超过int上限，用int解析会让你看到诡异的图形反转，这点在第5章的避坑清单里还会专门讲。
生成图元时，项目把D01（曝光）、D02（移动）、D03（闪光）三种情况分开：
var point = new PointD(currentX, currentY); // 经过换算的坐标 switch (dCode) { case 2: lastX = currentX; lastY = currentY; break; case 3: primitives.Add(new GerberFlash { Center = point, ApertureCode = currentDCode }); break; case 1: if (interpolation == InterpolationMode.Linear) { primitives.Add(new GerberLine { Start = new PointD(lastX, lastY), End = point }); } else if (interpolation == InterpolationMode.CwArc || interpolation == InterpolationMode.CcwArc) { primitives.Add(BuildArc(lastX, lastY, currentX, currentY, iOffset, jOffset, interpolation)); } lastX = currentX; lastY = currentY; break; }D02只移动笔，不产生图形；D03是闪光，直接放一个光圈；D01线性模式画直线，圆弧模式需要额外读取I和J偏移。I和J在指令里通常和坐标写在一起，比如X20Y10I5J0*，它表示圆弧中心相对起点偏了5和0毫米。
圆弧构建是最容易写错的函数。我摘一段项目中正常的实现：
public static GerberArc BuildArc( double startX, double startY, double endX, double endY, double i, double j, InterpolationMode mode) { double centerX = startX + i; double centerY = startY + j; double radius = Math.Sqrt(i * i + j * j); double startAngle = Math.Atan2(startY - centerY, startX - centerX); double endAngle = Math.Atan2(endY - centerY, endX - centerX); bool clockwise = mode == InterpolationMode.CwArc; double sweep; if (clockwise) { sweep = startAngle - endAngle; if (sweep < 0) sweep += 2 * Math.PI; } else { sweep = endAngle - startAngle; if (sweep < 0) sweep += 2 * Math.PI; } return new GerberArc { Center = new PointD(centerX, centerY), Radius = radius, StartAngle = startAngle, SweepAngle = sweep }; }参数的关键在startAngle和endAngle都是弧度制，而GDI+的DrawArc用的是角度制，渲染之前还要做一次RadiansToDegrees。很多人在这一步翻车，直接把Math.PI当成180传入，图形就会变成一个诡异的螺旋。
4. 渲染与交互：GDI+双缓冲与缩放的实现细节
4.1 图层渲染顺序与颜色配置
PCB查看器要按真实生产顺序叠图层：底铜、负片层、阻焊、丝印。项目在GerberRenderer.cs里维护了一个LayerRenderOrder数组，不同层对应预设颜色：
private static readonly Dictionary<LayerType, Color> LayerColors = new() { [LayerType.Copper] = Color.FromArgb(200, 255, 140, 0), [LayerType.SolderMask] = Color.FromArgb(80, 0, 255, 0), [LayerType.Silkscreen] = Color.FromArgb(255, 255, 255, 255), [LayerType.Drill] = Color.FromArgb(180, 0, 0, 0) };铜箔用半透明橙色，阻焊用半透明绿色，这样多层叠加时你能看出铜箔是否被阻焊覆盖。这个半透明叠加本身对显卡没有压力，因为GDI+渲染时是按多边形填充，不会出现像素级混合爆炸。真正影响性能的是抗锯齿，我们会在第5章细说。
颜色配置建议放在一个ColorProfile配置类里，而不是硬编码。你可以在MainForm上加一个ColorDialog，让PCB工程师自定义铜箔颜色，很多人习惯绿油背景，也有人喜欢蓝色阻焊，硬编码会被人吐槽。
4.2 坐标变换与缩放平移
渲染的核心是把世界坐标（毫米）映射到屏幕坐标（像素）。GerberCanvas里定义一个Matrix transform，每次重绘前根据缩放比例和平移量重建。
private Matrix BuildTransform() { var matrix = new Matrix(); matrix.Scale(_scale, _scale, MatrixOrder.Append); matrix.Translate( Width / 2 - _viewCenter.X * _scale, Height / 2 - _viewCenter.Y * _scale, MatrixOrder.Append); return matrix; }这段代码的关键是：先缩放，再平移。平移量是viewCenter乘以scale后的结果，意思是世界坐标系下的视图中心点经过缩放后，要落在屏幕中心。如果你把顺序写反，缩放的时候图形会沿左上角边界飞出，这是一个很常见的坐标变换陷阱。
GerberCanvas重写OnPaint时，把所有图元转换成GraphicsPath，然后用transform整体变换：
protected override void OnPaint(PaintEventArgs e) { e.Graphics.Clear(BackgroundColor); e.Graphics.SmoothingMode = _isPanning ? SmoothingMode.HighSpeed : SmoothingMode.AntiAlias; using (var transform = BuildTransform()) { foreach (var layer in _layers) { using (var path = new GraphicsPath()) { foreach (var primitive in layer.Primitives) { primitive.AddToPath(path); } path.Transform(transform); e.Graphics.FillPath(new SolidBrush(LayerColors[layer.Type]), path); } } } }这已经是经过性能权衡的写法。GraphicsPath创建和销毁有成本，所以项目在图层没变化时会把上一次生成的Path缓存起来，只有缩放水平或图层切换时才重建。如果你直接把每个图元DrawLine，十万条走线会卡到无法移动窗口。
4.3 鼠标交互、测量与信息显示
鼠标交互分三件事：左键测量、中键或右键平移、滚轮缩放。缩放最值得注意的实现细节是“以鼠标位置为中心”。
protected override void OnMouseWheel(MouseEventArgs e) { double oldScale = _scale; _scale *= (e.Delta > 0) ? 1.1 : 0.9; // 让鼠标指向的世界坐标点缩放后仍然在鼠标位置 var worldBefore = ScreenToWorld(e.Location); _viewCenter = worldBefore; _scale = oldScale; var worldAfter = ScreenToWorld(e.Location); _viewCenter = worldBefore - (worldAfter - _viewCenter); }这里ScreenToWorld要用当前的transform反算。如果缩放时没有校正_viewCenter，你的画面会以左上角为中心缩放，当图形有几平方厘米大时，稍微放大一下目标就走出了视野。PCB工程师看板子几乎全靠这个细节，不然用起来非常劝退。
测量模式通过状态栏显示结果。记录鼠标左键按下的世界坐标，拖动时实时计算与当前点的距离：
double distance = Math.Sqrt( Math.Pow((worldPoint.X - _measureStart.X), 2) + Math.Pow((worldPoint.Y - _measureStart.Y), 2)); toolStripStatusLabel.Text = $"距离: {distance:F3} mm";如果你需要测量两焊盘中心距，这个功能已经够用。而如果后续想加网测量、角度测量，可以直接在现有MeasureTool类里扩展。
5. 避坑指南：Gerber解析与渲染中最常见的5个问题
5.1 整数坐标溢出导致图形镜像翻转
现象：打开一块尺寸较大的板子，局部图形对称性完全错乱，位置离谱，甚至有些线段跑到负坐标区域。
原因：Gerber坐标用整数存储，比如FSLAX24Y24表示小数4位，一个200mm的板子，坐标值可能是2000000，超过了int上限的两百万？实际上int能存21亿，不会溢出。真正的溢出点是乘精度的时候：如果直接int.Parse再除以10000没问题，但如果你在解析时用int保存累计偏移，多次累加后可能溢出。项目曾经把坐标解析写成int coord = int.Parse(...)，对超大工件确实会出现符号翻转。
解决：所有坐标变量统一使用long，最后除以10的N次方时再转double。另外PointD类中的X和Y必须用double而不是float，否则精度到小数后3位就丢了，贴片厂会出现焊盘错位。
5.2 圆弧方向与IJ中心点理解错误
现象：圆弧画成了半圆之外的形状，或者弧向和实际走线相反。
原因：Gerber的G02表示顺时针，G03表示逆时针，但这个“顺时针”是站在Gerber坐标系的视角。有些EDA工具在导出时使用负坐标系统，导致顺时针弧看起来是逆时针。另外，IJ中心偏移是相对起点的，不是相对原点的，很多人直接当绝对坐标算，弧就完全偏离。
解决：给BuildArc写单元测试，用已知文件对照：一个从(0,0)到(10,0)的圆弧，I=5,J=0，顺时针时应该画出上凸还是下凸？先跑测试确认方向，再决定startAngle和sweepAngle的正负。我在项目中加入了一组来自Samples的标准圆弧样例，每次解析结果都会和参考图比对。
5.3 光圈重复定义与D码错乱
现象：某些层显示出来非常粗，或者图元全部变成了圆形闪光，而实际应该是矩形走线。
原因：Gerber允许在不同层次阶段重新定义同一个D码。如果你的解析器在发现重复D10时报错退出，会导致后续所有图元匹配到旧定义；如果直接后定义覆盖，但前一层还没绘制完，就会让前一层变样。
解决：对每个GerberLayer创建独立的ApertureTable实例，不要在整个文件共享一个表。我一开始为了省内存把光圈表放在Parser级，结果多层文件乱成一锅粥。后来改成每层一个表，问题立刻消失。文件内切换到新层时，要重置光圈表状态。
5.4 抗锯齿导致大数据量卡顿
现象：10万条走线时，鼠标缩放反应慢到无法操作，CPU占用100%。
原因：SmoothingMode.AntiAlias在GDI+里是CPU运算，每次Paint都会对多边形边缘做多次采样，图元总数一多就直接卡死。
解决：采用“平移时降级，缩放结束后重绘”策略。_isPanning标志位在MouseDown设置为true，MouseUp设为false，OnPaint里根据标志位选择HighSpeed或AntiAlias。还有一个优化是把静态图层预渲染成一张大Bitmap，缩放时直接DrawImage，只有缩放比例变化超过阈值才重新生成Bitmap。
5.5 英制/公制单位混用
现象：同一个文件，一部分图形尺寸正确，另一部分放大了25.4倍或缩小了1/25.4。
原因：Gerber头部的FSLAX24Y24中没有单位标志，单位写在MOIN或MOMM两条指令里。如果读数时忽略单位，把英制文件当公制解析，所有孔位都差25.4倍。
解决：解析器必须维护一个UnitType状态，在遇到MOIN和MOMM时切换。遇到没有单位声明的旧式Gerber，项目会在界面右下角弹一个提示，让用户手动选择英寸或毫米，而不要静默假设。这个提示虽然打扰人，但避免了板子报废的风险。
6. 二次开发：把查看器升级成CAM校验小工具
6.1 增加DRC间距检查
看Gerber只能“看”，不能自动发现问题。你可以利用Gerber.Core里的图元数据循环所有铜层，计算相邻图元之间的最小间距。常见做法是把图元包围盒插入四叉树或统一网格，然后只检查邻近格子里的图元对，避免O(n^2)的笛卡尔积。实现时可以复用GerberRenderer里的坐标变换，把世界坐标转成像素坐标做粗测，再用真实距离精测。这个功能一旦加上，这个工具就从一个“查看器”变成了“CAM前校验器”，实用性立刻不一样。
6.2 导出高清图片和SVG
给PCB工程师截图汇报时，屏幕分辨率经常不够清晰。你可以在GerberRenderer.cs里加一个RenderToBitmap方法，传入目标DPI和毫米宽度，创建一个高分辨率Bitmap然后逐个层绘制。SVG导出更简单：Gerber图元本身就是矢量的，把每个图元写成<path>标签即可。关键点是圆弧要离散化成多段贝塞尔曲线，否则某些SVG渲染器不认单弧命令。
6.3 命令行参数与自动化测试集成
把UI剥离后，Gerber.Core已经是个纯库。你可以定义一个Program.cs入口，支持命令行参数：-f input.GTL -o output.png -scale 2。这样就能在CI流水线里自动把每一版Gerber渲染成图片，和上一版做像素对比，检测意外改动。我后来在项目里加了一个Gerber.Cli工程，把Parser的日志级别接入Console.WriteLine，调试时直接跑命令行就能看到每一条光圈重定义警告。
从那以后，我每次拿到一份新Gerber文件，都会先用命令行工具转成PNG，再和EDA里的原图比对一遍，确认单位和精度都没问题，然后才敢把文件发给板厂。这个方法避免了至少两回“单位错位但肉眼没发现”的重大翻车。希望这个项目的源码结构，也能帮你少走这些夜路。
本文还有配套的精品资源，点击获取
