Python 使用 ezdxf 读写 DXF 文件指南

✅ entity.dxftype() 返回实体类型字符串，是判断实体种类的关键方法。

五、操作图层（Layers）

图层是 CAD 组织图形的核心机制。ezdxf 允许你创建、修改和分配图层：

# 创建新图层
doc.layers.new(name="WALLS", dxfattribs={'color': 1}) # 颜色 1=红色

# 在指定图层上添加实体
msp.add_line((0, 0), (100, 0), dxfattribs={'layer': 'WALLS'})

# 修改图层属性
layer = doc.layers.get("WALLS")
layer.color = 3 # 改为绿色

六、添加文字与标注

# 添加单行文字
msp.add_text(
    "Hello, CAD!",
    dxfattribs={
        'insert': (10, 20), # 插入点
        'height': 2.5,      # 字高
        'layer': 'ANNOTATION'
    }
)

# 添加多行文字（MTEXT）
msp.add_mtext("这是\n多行文本", dxfattribs={'insert': (10, 30), 'char_height': 2})

七、使用块（Blocks）提高复用性

块类似于'模板'，适合重复图形（如门窗符号、设备图标）：

# 创建一个名为 "DOOR" 的块
block = doc.blocks.new(name='DOOR')
block.add_line((0, 0), (0, 2)) # 门框
block.add_arc(center=(0, 0), radius=2, start_angle=0, end_angle=90) # 门扇弧线

# 在模型空间插入该块（可多次插入，位置/缩放/旋转可变）
msp.add_blockref(
    name='DOOR',
    insert=(5, 5), # 插入位置
    dxfattribs={'xscale': 1, 'yscale': 1, 'rotation': 0}
)

八、实用技巧与注意事项

1. 版本兼容性

• 使用 ezdxf.new(dxfversion='R12') 可生成更老的 DXF 版本（兼容性更好）。
• 但 R12 不支持某些高级实体（如 LWPOLYLINE），建议优先使用 R2000 或 R2010。

2. 坐标系统

• DXF 使用笛卡尔坐标系（X 向右，Y 向上），与屏幕坐标一致。
• 所有坐标均为 (x, y) 或 (x, y, z) 元组。

3. 性能优化

• 处理大型 DXF 文件时，避免频繁调用 save()，应在最后一次性保存。
• 可使用 doc.entitydb.purge() 清理未引用的实体（谨慎使用）。

4. 可视化调试（可选）

虽然 ezdxf 本身不提供绘图功能，但可结合 matplotlib 快速预览：

import matplotlib.pyplot as plt
from ezdxf.addons.drawing import RenderContext, Frontend
from ezdxf.addons.drawing.matplotlib import MatplotlibBackend

doc = ezdxf.readfile("example.dxf")
msp = doc.modelspace()
fig = plt.figure()
ax = fig.add_axes([0, 0, 1, 1])
ctx = RenderContext(doc)
out = MatplotlibBackend(ax)
Frontend(ctx, out).draw_layout(msp)
plt.show()

需安装 matplotlib 和 ezdxf[draw]（pip install ezdxf[draw]）。

九、典型应用场景

• 自动化出图：根据数据库生成标准 CAD 图纸。
• BIM 数据提取：从建筑模型导出的 DXF 中解析墙体、门窗位置。
• 激光切割/数控编程：生成符合设备要求的 DXF 路径。
• GIS 数据转换：将 Shapefile 或 GeoJSON 转为 DXF 供 CAD 使用。

结语

ezdxf 以简洁的 API 和强大的功能，让 Python 成为处理 DXF 文件的高效工具。无论你是工程师、开发者还是科研人员，只要涉及 CAD 数据自动化，ezdxf 都值得纳入你的技术栈。