简介：这是一份面向C#桌面开发初学者的NetDXF实战示例源码，围绕在WinForm中加载本地DXF文件并完成基础图形绘制展开，适合想了解CAD图形解析、GDI+绘制与控件交互的开发者参考。压缩包共44个文件，约628KB，包含10个cs源码、4个exe、2个dll、2个resx、3个config及sln/csproj等工程文件，另有缓存与调试产物，可完整还原VS项目结构。已有3287人学习，说明该案例在入门实践中具有一定参考价值。资源重点展示DXF文档加载、实体遍历以及Line、Circle等图元绘制思路，配合窗体控件和绘图面板的组织方式，便于读者理解文件选择、图形渲染与WinForm界面协作的完整流程，也可作为课程设计或小型CAD查看器原型的起步代码。

1. 从一份设备布置图说起：C# 里用 NetDXF 在 WinForm 加载并简单绘制 DXF 能做到什么

手里拿到一份设备布置图，对方只给 DXF，要求在 C# WinForm 里做个轻量预览：能打开、能缩放、能看到线和文字，不要求编辑。这个需求听起来像“随便画画”，真做起来却会卡在组码、单位、块参照和坐标轴上。基于 NetDXF 实现 WinForm 加载并简单绘制 DXF，走的是“用现成解析库把实体读成对象，再用 GDI+ 画到 Panel”的路线，适合做图纸预览、选型对照、标注核对这类内部工具，不适合替代完整 CAD 编辑器。

这套示例的价值不在“画出几条线”，而在把 DXF 实体模型到屏幕坐标的映射关系拆清楚。新手照着第 2 到第 4 章的代码能跑通一条最小链路；熟手更该关注第 5 章的排查项，尤其是加载成功却空白、Y 轴镜像、块参照偏移和大文件卡顿。下面从文件结构讲到画布变换，再到踩坑记录，按能复现的顺序展开。

2. NetDXF 的坐标账本：DXF 组码、实体模型和 WinForm 画布怎么对齐

2.1 DXF 文件结构里真正影响绘制的几层

DXF 不是一张“图片”，而是一套用组码描述实体和表的文本或二进制结构。用记事本打开一个 ASCII DXF，会看到SECTION、ENTITIES、TABLES、BLOCKS这些段。对“加载并简单绘制”来说，真正影响结果的不是所有组码，而是四层东西：实体段里的几何坐标、图层表里的颜色和开关状态、块表里的块定义与插入点、文件头里的单位和范围。很多人一上来就逐行解析组码，写到后面发现圆弧角度、多段线凸度、文字对齐方式全都没处理，预览结果自然和 CAD 里对不上。

实体段是绘制的主战场。直线记录起点和终点，圆记录圆心和半径，圆弧多两个起止角，轻量多段线记录顶点序列和凸度，文字记录插入点、字高、旋转角和内容。图层表决定实体属于哪个层，层可以是关闭、冻结、锁定状态；块表则把一组实体打包成块，再通过INSERT实体按插入点、缩放和旋转放到图纸里。预览工具不需要完整实现 CAD 的编辑语义，但至少要把实体坐标、图层颜色和块参照的插入变换读出来，否则画出来的东西只是“有线条”，不是“这张图”。

还有一个容易被忽略的点是单位。DXF 文件头里有$INSUNITS之类的变量，但不少导出工具并不写，或者写得不准确。单位不确定时，自动缩放不能假设 1 单位等于 1 毫米，只能按实体包围盒做自适应。我的习惯是先把所有实体读出来，算一个全局包围盒，再按画布大小做 Fit；单位只作为显示标注的参考，不参与几何变换。这样即使拿到一张以英寸或任意单位绘制的图，预览也不会因为单位猜错而缩成一个小点。

2.2 选 NetDXF 而不是直接解析组码的理由

直接解析 DXF 组码不是不行，但适合的场景很窄：格式固定、实体类型少、只读少量字段。一旦要处理块参照、图层颜色、圆弧方向、多段线凸度、文字样式，工作量会迅速膨胀。NetDXF 这类库的价值是把组码解析、实体对象模型、块表和图层表封装好，调用方拿到的是Line、Circle、Arc、LwPolyline、Text、Insert这样的对象，而不是一串(10, x)、(20, y)。对于 WinForm 预览工具，这能省掉大量底层解析代码，把精力放在坐标变换和绘制上。

选型时要把边界说清楚：NetDXF 是 DXF 读写库，不是渲染引擎。它负责把文件读成对象，不负责帮你处理双缓冲、缩放平移、线宽显示、字体替换。GDI+ 的Graphics也不是 CAD 内核，画大量实体时会卡，复杂线型、填充、裁剪、真彩色渐变都要自己取舍。预览场景下，我一般只画白名单实体，线宽统一为 1 像素，文字用系统字体替代，先保证“看得见、对得上、能缩放”，再谈还原度。这个取舍对内部工具足够，对高精度审图不够。

另一个理由是调试成本。自己解析组码时，遇到空白画面只能从文件头一路打印；用 NetDXF 时，可以先统计实体类型和数量，确认文件到底读到了什么。比如一张图里 90% 是INSERT，直接遍历Line当然画不出东西。先做实体分类统计，再决定绘制策略，这条排查路径比盲猜组码快得多。下面这段加载代码就是先把文件读成实体集合，再做类型汇总，后面所有绘制都围绕这个集合展开。

2.3 加载文件与读取实体：最小可运行代码

using System; using System.Collections.Generic; using System.Linq; using netDxf; using netDxf.Entities; public sealed class DxfScene { public DxfDocument Document { get; private set; } public IReadOnlyList<EntityObject> Entities { get; private set; } public void Load(string filePath) { // 常见入口是静态 Load；不同 netDxf 版本的命名可能有差异，按实际包调整 Document = DxfDocument.Load(filePath); if (Document == null) throw new InvalidOperationException("DXF 读取失败，先确认文件不是加密或损坏版本"); // Entities.All 是实体总集合，块内实体不在这个集合里，需要单独展开 Entities = Document.Entities.All.ToList(); } public string[] SummarizeTypes() { return Entities .GroupBy(e => e.GetType().Name) .OrderByDescending(g => g.Count()) .Select(g => $"{g.Key}:{g.Count()}") .ToArray(); } }

这段代码做了三件事：加载文件、把实体总集合缓存下来、按类型统计数量。DxfDocument.Load是入口，返回值不要直接假设非空，文件损坏、版本不兼容、加密 DXF 都可能返回空或抛异常，外面要包一层提示。Entities.All拿到的是模型空间里的实体，块定义里的实体不会自动展开，所以统计结果里如果Insert很多、Line很少，就要意识到真正几何在块里，不能只画顶层实体。SummarizeTypes不是装饰，它是排查空白画面的第一把尺子：先看读到了什么，再谈画得对不对。

参数上，filePath建议用绝对路径，WinForm 里不要依赖当前工作目录；如果从文件对话框拿路径，先判断扩展名和文件是否存在。Entities用IReadOnlyList缓存，避免每次重绘都重新遍历Document.Entities.All，大文件下这个差异很明显。实体集合里可能包含Hatch、Dimension、Spline等预览阶段不处理的类型，统计时保留它们，绘制时用白名单过滤，不要一上来就删数据，否则后面想补功能还得重新加载。

注意：不同 netDxf 版本的实体集合命名、Load重载和颜色 API 会有差异，代码里的类型名按你实际引用的包调整；先跑通实体统计，再动绘制。

3. 在 WinForm 里把 DXF 画出来：从 DxfDocument 到 Graphics 的映射

3.1 画布准备：双缓冲 Panel 与坐标变换

WinForm 里直接往Form的Paint事件里画也能出图，但缩放和重绘一多就会闪。稳妥做法是做一个双缓冲Panel，把DoubleBuffered打开，再把所有绘制放在OnPaint里。DXF 坐标是 Y 向上，GDI+ 屏幕坐标是 Y 向下，所以不能直接把line.StartPoint.X丢给DrawLine，必须经过一次世界坐标到屏幕坐标的变换。我一般不用Graphics.Transform叠矩阵，而是自己维护Scale、OffsetX、OffsetY三个参数，公式简单，排查时一眼能看出问题。

using System.Drawing; using System.Windows.Forms; public sealed class DxfCanvas : Panel { public DxfCanvas() { DoubleBuffered = true; SetStyle(ControlStyles.AllPaintingInWmPaint | ControlStyles.UserPaint | ControlStyles.OptimizedDoubleBuffer, true); BackColor = Color.Black; } } public sealed class ViewTransform { public float Scale { get; set; } = 1f; public float OffsetX { get; set; } public float OffsetY { get; set; } public PointF WorldToScreen(double x, double y, int canvasHeight) { // Y 轴翻转：DXF 向上为正，屏幕向下为正 return new PointF( (float)(x * Scale + OffsetX), (float)(canvasHeight - (y * Scale + OffsetY))); } public PointF ScreenToWorld(float sx, float sy, int canvasHeight) { return new PointF( (float)((sx - OffsetX) / Scale), (float)((canvasHeight - sy - OffsetY) / Scale)); } }

DxfCanvas只做一件事：把双缓冲打开。ViewTransform负责双向换算，WorldToScreen里的canvasHeight - (...)就是 Y 轴翻转，ScreenToWorld是它的逆运算，后面鼠标滚轮以光标为中心缩放要靠它。Scale是“一个 DXF 单位对应多少像素”，OffsetX、OffsetY是平移量。三个参数不要混用：Scale只由缩放和 Fit 改，Offset只由平移和缩放锚点改。把这三者拆开，后面出现坐标偏移时才能快速判断是缩放算错还是平移算错。

注意：OffsetY的符号容易被写反。判断标准很简单：把图往上拖，屏幕上的图应该跟着往上走；如果反向，先改OffsetY的加减号，不要怀疑 DXF 数据。

3.2 常用实体绘制：Line、Circle、Arc、Polyline、Text

最小预览不需要支持所有实体，先把Line、Circle、Arc、LwPolyline、Text这五类画对，覆盖大多数二维布置图。绘制时统一走WorldToScreen，不要在一个分支里直接乘坐标、另一个分支里又加偏移。圆弧的角度转换要单独注意：DXF 的起止角通常按逆时针、以度为单位，GDI+ 的DrawArc起始角按顺时针、以 x 轴正方向为起点，所以需要取负并计算扫过角度。下面这段是核心绘制分支。

using System; using System.Drawing; using System.Linq; using netDxf.Entities; private void DrawEntity(Graphics g, EntityObject entity, int canvasHeight, ViewTransform view) { switch (entity) { case Line line: { var p1 = view.WorldToScreen(line.StartPoint.X, line.StartPoint.Y, canvasHeight); var p2 = view.WorldToScreen(line.EndPoint.X, line.EndPoint.Y, canvasHeight); g.DrawLine(Pens.LightGreen, p1, p2); break; } case Circle circle: { var c = view.WorldToScreen(circle.Center.X, circle.Center.Y, canvasHeight); var r = (float)(circle.Radius * view.Scale); g.DrawEllipse(Pens.LightGreen, c.X - r, c.Y - r, r * 2, r * 2); break; } case Arc arc: { // DXF 角度逆时针，GDI+ 顺时针；实际项目里建议拿一张带圆弧的样本图校准 var c = view.WorldToScreen(arc.Center.X, arc.Center.Y, canvasHeight); var r = (float)(arc.Radius * view.Scale); var start = (float)(-arc.EndAngle); var sweep = (float)(-(arc.EndAngle - arc.StartAngle)); g.DrawArc(Pens.LightGreen, c.X - r, c.Y - r, r * 2, r * 2, start, sweep); break; } case LwPolyline poly: { var points = poly.Vertexes .Select(v => view.WorldToScreen(v.Position.X, v.Position.Y, canvasHeight)) .ToArray(); if (points.Length > 1) g.DrawLines(Pens.LightGreen, points); break; } case Text text: { var p = view.WorldToScreen(text.Position.X, text.Position.Y, canvasHeight); var fontSize = Math.Max(8f, (float)(text.Height * view.Scale)); using var font = new Font("Microsoft YaHei", fontSize); g.DrawString(text.Value, font, Brushes.White, p); break; } } }

这段分支里，Line和LwPolyline是纯坐标映射，Circle把半径乘Scale后画椭圆，Arc在角度上做了取负和扫角计算，Text用系统字体替代 CAD 字体。text.Height * view.Scale可能小到看不清，所以加了Math.Max(8f, ...)的下限；这个下限会让文字在缩小时不消失，但会牺牲比例准确性，预览场景可以接受。LwPolyline只画顶点连线，没有处理凸度，遇到带圆弧的多段线会显示成折线，这是“简单绘制”的边界，不是 bug。

参数上，canvasHeight每次绘制传入，不要用panel.Height在方法里反复取，避免重绘过程中尺寸变化导致坐标不一致。view.Scale不建议小于 0.001 或大于 10000，否则float精度和 GDI+ 绘制都会出问题。文字字体名用系统中存在的字体，不要硬编码 CAD 专用字体；找不到字体会回退，回退后字宽变化，预览会“看起来有点歪”，这是正常现象。

3.3 缩放、平移与重绘：把鼠标事件接进坐标矩阵

预览工具好不好用，一半看缩放平移。滚轮缩放要以光标为中心，否则图会越缩越偏。做法是先把光标屏幕点转成世界点，改Scale，再反算OffsetX、OffsetY，让同一个世界点仍然落在光标下。平移则直接改OffsetX，OffsetY要按 Y 轴翻转关系取反。下面这段事件代码可以直接挂到DxfCanvas上。

private bool dragging; private Point lastMouse; private readonly ViewTransform view = new ViewTransform(); private void Canvas_MouseWheel(object sender, MouseEventArgs e) { var world = view.ScreenToWorld(e.X, e.Y, canvas.Height); var factor = e.Delta > 0 ? 1.1f : 1f / 1.1f; view.Scale *= factor; // 反算偏移，保证光标下的世界点不跑 view.OffsetX = e.X - (float)(world.X * view.Scale); view.OffsetY = canvas.Height - e.Y - (float)(world.Y * view.Scale); canvas.Invalidate(); } private void Canvas_MouseDown(object sender, MouseEventArgs e) { if (e.Button == MouseButtons.Left) { dragging = true; lastMouse = e.Location; canvas.Cursor = Cursors.SizeAll; } } private void Canvas_MouseMove(object sender, MouseEventArgs e) { if (!dragging) return; var dx = e.X - lastMouse.X; var dy = e.Y - lastMouse.Y; view.OffsetX += dx; view.OffsetY -= dy; // 屏幕 Y 向下，世界 Y 向上 lastMouse = e.Location; canvas.Invalidate(); } private void Canvas_MouseUp(object sender, MouseEventArgs e) { dragging = false; canvas.Cursor = Cursors.Default; }

滚轮这段的关键是“先转世界点，再改比例，再反算偏移”。如果先改Scale再转世界点，光标锚点就会漂。factor用 1.1 和 1/1.1 是一组常用步进，太大容易跳，太小滚半天没感觉。平移里OffsetY -= dy是 Y 轴翻转带来的符号差异，拖拽方向不对时先查这里。每次改完view调Invalidate，不要调Refresh，Refresh会强制同步重绘，大图下更容易卡。

自动 Fit 我一般放在加载完成后做一次：先遍历实体算全局包围盒，再用min(可用宽/包围盒宽, 可用高/包围盒高)算Scale，最后反推Offset。包围盒不要只算Line，圆要算圆心加减半径，文字至少算插入点，块参照要算插入点。第 6 章会给一个包围盒验证的小工具，先把第 3 章这条绘制链路跑通，再回头补精度。

4. 图层、颜色与线型：让预览接近 CAD 而不是一堆黑线

4.1 按图层组织绘制顺序和开关

DXF 的图层不只是分组，它还带颜色、线型、开关和冻结状态。预览工具至少要做到按图层取色和按图层隐藏，否则一张几十层的图全画成绿色，检查线路时根本分不清。NetDXF 读出来的实体有Layer属性，图层对象在Document.Layers里。我的做法是维护一个Dictionary<string, bool>记录图层可见性，绘制前先判断，绘制时按图层名取颜色。图层顺序不一定要严格还原 CAD 的显示顺序，但填充类实体要后画，线和文字要压在填充上面，否则文字会被盖住。

using System.Collections.Generic; using System.Drawing; using netDxf.Entities; using netDxf.Tables; private readonly Dictionary<string, bool> layerVisible = new Dictionary<string, bool>(StringComparer.OrdinalIgnoreCase); private bool IsVisible(EntityObject entity) { var name = entity.Layer?.Name ?? "0"; return !layerVisible.TryGetValue(name, out var visible) || visible; } private void BuildLayerSwitches(DxfDocument doc) { layerVisible.Clear(); foreach (Layer layer in doc.Layers) { // 默认全部可见；关闭层和冻结层可以先置 false，按项目需要调整 layerVisible[layer.Name] = layer.IsVisible; } }

BuildLayerSwitches在加载后调用一次，把图层名和可见状态缓存下来。IsVisible里用TryGetValue，没登记的图层默认可见，避免因为图层表读取不全导致整张图消失。StringComparer.OrdinalIgnoreCase是血泪经验：有些 DXF 里图层名大小写混用，WALL和Wall被当成两个层，颜色和开关全乱。按图层绘制时，先画填充和面，再画线，最后画文字；如果你们的图没有填充，顺序影响不大，但养成习惯后换图不用重新调。

图层开关做到这个程度就够预览用了，不需要实现锁定和打印样式。锁定层在预览里仍然可见，只是不能编辑；这个工具本来就不编辑，锁定状态可以忽略。冻结层和关闭层要区分：关闭层通常不显示，冻结层在重生成时跳过，预览里都可以按不可见处理。如果发现关掉的层还在画，先查实体Layer.Name是否为空，再查layerVisible的键是否被大小写弄丢。

4.2 颜色索引、真彩色和线宽的处理边界

DXF 颜色有三种常见情况：随层、ACI 索引色、真彩色。随层表示实体颜色跟图层走，索引色是 1 到 255 的 CAD 调色板，真彩色是 24 位 RGB。预览工具不需要完整还原 ACI 调色板，但至少要把常见的 1 到 7 号色映射对：1 红、2 黄、3 绿、4 青、5 蓝、6 洋红、7 白/黑。真彩色直接取 RGB。线宽在屏幕上按像素画，DXF 的线宽单位是毫米级，直接乘缩放会粗得没法看，我一般统一 1 像素，或者按图层线宽做 1 到 3 像素的映射。

private Pen CreatePen(EntityObject entity) { var color = Color.LightGreen; try { // 不同版本的颜色 API 名称略有差异，核心是先判断随层还是显式颜色 if (entity.Color != null) { var index = entity.Color.Index; // ACI 索引 color = index switch { 1 => Color.Red, 2 => Color.Yellow, 3 => Color.Lime, 4 => Color.Cyan, 5 => Color.Blue, 6 => Color.Magenta, 7 => Color.White, _ => Color.LightGreen }; } } catch { // 颜色读不到时回退，预览宁可颜色不准，也不要整张图不画 } return new Pen(color, 1f); }

这段CreatePen先把颜色回退成浅绿，再尝试读 ACI 索引。entity.Color.Index在不同版本里可能是AciValue或别的名字，按实际包改；核心逻辑是“读不到就回退”，不要因为一个实体颜色异常让整个Paint抛异常。Pen用完要释放，绘制循环里不要每条线都new Pen后不Dispose，大图下 GDI 句柄会涨。简单做法是按颜色缓存Pen，或者用using包住单次绘制。

线宽边界要说清楚：CAD 里 0.25mm 的线在屏幕上并不等于 0.25 像素，完整 CAD 会根据缩放级别做线宽显示策略。预览工具如果强行按毫米乘比例，缩小后线会细到看不见，放大后又会糊成一片。我的取舍是统一 1 像素，靠颜色区分图层；如果一定要显示粗线，按图层名或线宽值映射到 1、2、3 像素，不要直接乘Scale。文字颜色同理，不要用纯黑背景配深蓝文字，预览时看不清，换深色背景配亮色。

4.3 块参照与 Insert 的展开策略

块参照是预览翻车的重灾区。很多设备图把阀门、螺栓、标注做成块，再用INSERT插到不同位置。顶层实体集合里只有Insert，没有块内的Line和Circle，如果只遍历Entities.All，画面可能只剩几个插入点。正确做法是遇到Insert时递归展开insert.Block.Entities，并对块内实体做插入变换：先按Scale缩放，再按Rotation旋转，最后加Position平移。块可以嵌套，递归要有深度上限，防止循环引用把栈打爆。

private PointF TransformInsertPoint(Vector2 point, Insert insert) { var angle = insert.Rotation * Math.PI / 180.0; var x = point.X * insert.Scale.X; var y = point.Y * insert.Scale.Y; var rx = x * Math.Cos(angle) - y * Math.Sin(angle); var ry = x * Math.Sin(angle) + y * Math.Cos(angle); return new PointF( (float)(rx + insert.Position.X), (float)(ry + insert.Position.Y)); } private void DrawInsert(Graphics g, Insert insert, int height, ViewTransform view, int depth) { if (depth > 8) return; // 防止嵌套块循环 foreach (var child in insert.Block.Entities) { if (child is Insert nested) { DrawInsert(g, nested, height, view, depth + 1); continue; } // 简化预览：块内实体先按插入变换点，再走统一绘制 // 实际项目里建议把变换矩阵传到 DrawEntity，避免只变换一个点 } }

TransformInsertPoint演示了插入变换的顺序：缩放、旋转、平移。insert.Rotation是角度，转弧度再算；insert.Scale是三维向量，二维预览取 X、Y。DrawInsert里用depth > 8限制递归，正常图纸嵌套不会这么深，超过就说明块结构异常。真实绘制时不要只变换一个点，要把块内实体的所有坐标都过一遍同一个变换，否则直线端点会对不上。更稳的做法是构造一个Matrix，把块内实体统一变换后再画；代码量会大一些，但圆弧和文字旋转更容易一致。

块展开还要注意单位。块定义里的坐标是块坐标系，插入时按Scale缩放，如果块本身按毫米定义、插入时又按英寸缩放，预览会整体偏小。排查时先看insert.Scale是不是 1，再看块基点是不是在原点。有些块的基点在图形角落，插入后看起来“偏了一大截”，不是代码错，是块定义本身如此。预览工具可以不处理块裁剪和属性文字，但要把块内几何画出来，否则用户会以为文件没加载成功。

5. 避坑排查：加载空白、坐标偏移、卡顿和字体乱码

5.1 加载成功但画面空白：先查单位与范围

现象：文件对话框选了 DXF，代码没抛异常，实体统计也有几千条，画布就是全黑。原因通常不是加载失败，而是绘制范围没对上。最常见的是自动 Fit 用了错误的包围盒，比如只统计了Line，而图里大部分是Insert和LwPolyline，包围盒算出来是一个很小的区域，Scale被拉到很大，实际图形全在画布外。另一个原因是单位差异，图按 1 单位等于 1 米绘制，包围盒宽度 0.05，Scale算出来几万，浮点精度和 GDI+ 都扛不住。

解决：先打印实体类型统计和包围盒，不要急着调绘制代码。把minX、minY、maxX、maxY输出到日志，确认数值不是0,0,0,0，也不是1e-8级别。包围盒要把Circle的半径、Text的插入点、Insert的插入点都算进去。Fit 之后加一个保护：Scale限制在0.001到10000之间，超出就说明数据范围异常，先把图心平移到原点再画。还有一点，Paint事件里如果异常被吞掉，画面也会空白；在OnPaint外层加try/catch并把异常写到日志，不要静默失败。

注意：空白画面先看实体统计，再看包围盒，最后看Scale和Offset。顺序反了会浪费很多时间。

5.2 坐标偏移和镜像：Y 轴、UCS 与块基点

现象：图能画出来，但整体上下颠倒，或者所有设备跑到画布上方，拖拽方向也反。原因基本都是 Y 轴处理不一致。DXF 世界坐标 Y 向上，GDI+ 屏幕 Y 向下，WorldToScreen里必须做一次翻转；如果某个绘制分支直接用了原始 Y，那个分支就会镜像。块参照的插入变换如果先平移后旋转，也会让块内几何偏移，尤其是块基点不在原点时，偏移量会随旋转放大。

解决：所有实体绘制只走一个WorldToScreen，不要在每个case里自己写坐标公式。块变换统一按“缩放、旋转、平移”的顺序，和 CAD 的插入语义对齐。拖拽平移时记住OffsetY -= dy，滚轮缩放时用ScreenToWorld反算锚点。遇到 UCS 或命名视图导致的偏移，预览阶段可以先忽略，按世界坐标画；如果业务要求按 UCS 显示，再单独读文件头变量，不要把两套坐标混在一个Scale里。

5.3 大文件卡顿：实体过滤与重绘节流

现象：几万条实体的 DXF 一打开，拖拽像幻灯片，滚轮按下去要等两三秒才响应。原因不是 NetDXF 解析慢，而是每次Paint都全量遍历、全量new Pen、全量画文字。GDI+ 画几万条线本身就不适合实时交互，文字测量和字体创建更贵。再加上鼠标移动事件里每次都Invalidate，重绘频率远超屏幕刷新率，卡顿是必然的。

解决：先做实体白名单，只画预览需要的类型；再按图层可见性过滤，关闭层不画；最后做重绘节流，鼠标移动时用Timer延迟 30 到 50 毫秒再Invalidate。Pen按颜色缓存，不要每条线新建。文字可以限制数量，超过 2000 条时只画前 2000 条或者按缩放级别抽稀。下面这段白名单可以直接放在绘制入口。

private static readonly HashSet<Type> PreviewWhiteList = new HashSet<Type> { typeof(Line), typeof(Circle), typeof(Arc), typeof(LwPolyline), typeof(Text), typeof(Insert) }; private bool CanPreview(EntityObject entity) { return PreviewWhiteList.Contains(entity.GetType()) && IsVisible(entity); }

PreviewWhiteList用Type做键，比字符串比较快，也不怕类名改。CanPreview同时判断类型和图层可见性，绘制循环里先过滤再画，能省掉大量无用的坐标变换。白名单不是永久方案，后面要支持Spline或Hatch时往里加类型即可。如果加了白名单还是卡，用Stopwatch量一下Paint总耗时和实体数量，确认瓶颈在绘制还是在解析。

5.4 字体、线型和版本兼容：别让预览变成黑匣子

现象：文字变成方框，或者中文全部消失；线型全是实线，虚线显示不出来；换一个版本的 DXF 后直接加载失败。原因是 CAD 字体、SHX 字体和系统字体不是一套东西，GDI+ 找不到对应字体就回退，回退失败就画方框。线型依赖.lin定义和实体线型比例，预览工具没加载线型表，只能画实线。版本兼容则和 NetDXF 支持的 DXF 版本有关，太新的文件或带加密的文件可能读不了。

解决：文字统一用系统字体，中文用Microsoft YaHei或SimSun，不要直接拿 CAD 样式名当字体名。线型在预览阶段统一实线，接受这个边界，不要为了虚线去解析线型表。加载失败时把异常信息、文件大小、DXF 版本号打到日志，先确认文件不是空文件或损坏文件。版本兼容问题不要靠猜，拿一个能打开的最小样本做对照，逐步替换成目标文件，定位是哪个实体类型导致失败。

5.5 保存和导出回 DXF 时的常见翻车

现象：预览正常，点“另存为 DXF”后，用 CAD 打开发现图层丢了、颜色变了、文字位置偏了。原因通常是导出时只写了实体，没有写图层表和块表；或者颜色用了真彩色，但目标版本只支持 ACI 索引色；文字对齐方式在导出时被重置。预览工具如果只读不写，这一条可以跳过；一旦要回写，就必须把“读进来什么、写出去什么”对齐。

解决：导出前先复制原DxfDocument，不要在原文档上直接改，避免预览状态污染导出结果。图层、块、线型这些表要跟着实体一起保存。颜色优先用 ACI 索引色，真彩色作为补充。文字位置导出后用另一个查看器打开对照，不要只信自己的预览。回写功能不是“简单绘制”的必需项，先保证只读预览稳定，再考虑导出。

6. 进阶验证：把预览结果和 DXF 实体验证做成一套小工具

6.1 实体包围盒与自动缩放的验证

包围盒算错是空白和偏移的源头，我一般单独写一个验证方法：遍历所有可预览实体，输出总包围盒、实体数量、最大实体和最小实体。圆按圆心加减半径算，文字按插入点算，块参照按插入点算。算完和 Fit 后的Scale、Offset一起打印，出现异常时一眼能看出是数据范围问题还是变换问题。

public RectangleF EstimateBounds(IEnumerable<EntityObject> entities) { float minX = float.MaxValue, minY = float.MaxValue; float maxX = float.MinValue, maxY = float.MinValue; foreach (var e in entities) { switch (e) { case Line line: minX = Math.Min(minX, (float)line.StartPoint.X); minY = Math.Min(minY, (float)line.StartPoint.Y); maxX = Math.Max(maxX, (float)line.EndPoint.X); maxY = Math.Max(maxY, (float)line.EndPoint.Y); break; case Circle circle: minX = Math.Min(minX, (float)(circle.Center.X - circle.Radius)); minY = Math.Min(minY, (float)(circle.Center.Y - circle.Radius)); maxX = Math.Max(maxX, (float)(circle.Center.X + circle.Radius)); maxY = Math.Max(maxY, (float)(circle.Center.Y + circle.Radius)); break; } } return RectangleF.FromLTRB(minX, minY, maxX, maxY); }

这段只覆盖了两种实体，实际项目按白名单补Arc、LwPolyline、Text、Insert。RectangleF.FromLTRB在没有任何实体时会得到异常值，调用前先判断实体数量。包围盒验证通过后再做 Fit，顺序不要反。

6.2 用快照对比发现绘制偏差

同一张图每次打开都截一张Bitmap，存成固定尺寸，用像素差对比两次绘制结果，能发现“某次改动后整体偏移 2 像素”这类问题。做法是在Paint结束后把画布内容画到Bitmap，不弹窗，直接写临时目录。对比时只看差异像素比例，不看具体颜色，比例突然升高就回查最近的坐标变换改动。这个办法很土，但比肉眼盯图可靠。

6.3 一个可复用的小技巧：绘制前先做实体白名单

从那以后我每次接 DXF 预览需求，都会先写白名单和包围盒日志，再动Paint。先确认文件里有什么、范围多大、哪些实体不画，最后才调坐标变换。这样即使遇到一张全是块参照的图，也能在十分钟内定位是块没展开还是 Fit 算错，而不是在Paint里一行行加断点。希望帮到你。

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