简介DXF2GCODE是一款面向CNC工程师、创客及机械设计初学者的开源G代码生成工具专用于将2D DXF图纸高效转换为CNC设备可执行的G-Code指令同时支持PDF与PostScript格式导入显著降低从CAD设计到物理加工的门槛。资源包共95个文件含62个Python核心脚本实现图形解析、路径规划与后处理、12个UI图标与界面资源png/svg/icns/ico、5个说明文档txt/README/COPYING及多语言翻译文件ts、配置文件cfg/desktop和构建脚本setup.py/make_exe.py等完整覆盖源码、本地化、打包与跨平台部署所需组件压缩包仅3.68MB轻量易部署。已有2752人下载学习适合希望深入理解CNC加工流程、定制后处理器或二次开发的用户——通过阅读源码可掌握DXF几何解析逻辑结合示例与UI文件可快速上手图形化操作借助多语言支持与跨平台配置Windows/Linux/macOS亦便于教学与团队协作。1. 把 DXF 图纸喂给 CNC 机床前你得先过这一关dxf2gcode 不是转换器而是「图纸语义翻译官」很多刚接触 CNC 加工的朋友以为画个 DXF → 点一下“导出 G-Code” → 上机切削就完事了。结果一上机刀具乱跑、轮廓错位、Z 轴猛扎进夹具——不是机床坏了是你没让图纸“说人话”。dxf2gcode 就是干这个的它不简单做几何坐标映射而是把 DXF 文件里那些隐含的图层意图比如“这是轮廓切割线”“这是钻孔中心点”“这是避让区域”、线型闭合性、实体填充逻辑、文字注释语义统统解析成 CNC 控制器能理解的加工动作序列。它支持 ISO 标准 G-CodeG0/G1/G2/G3/M3/M5/M30也兼容 Fanuc、Heidenhain、LinuxCNC 等主流后处理器模板更关键的是——它开源、可调试、可嵌入自动化流程。如果你常接外贸客户发来的杂乱 DXF图层命名随意、线段未闭合、多段线被炸散、带样条曲线或椭圆又不想靠人工在 CAM 软件里一条线重描一遍dxf2gcode 就是那个能帮你把“图纸混乱”翻译成“机床可执行”的底层工具。它不适合直接替代 Fusion 360 或 Mastercam 做复杂曲面加工但对 2D 轮廓切割、钻孔阵列、刻字、薄板下料这类高频场景它是真正能落地、能写进 CI/CD 流程、能批量处理上百个 DXF 的开源硬核组件。2. 为什么选 dxf2gcode 而不是其他从 DXF 解析原理到 G-Code 生成链路拆解2.1 DXF 文件不是“图片”而是分层数据库dxf2gcode 如何读取真实语义DXFDrawing Exchange Format本质是 Autodesk 定义的一种文本/二进制混合结构化数据格式其核心不是像素而是实体Entity 图层Layer 线型Linetype 颜色Color 线宽Lineweight 属性XData组成的层级关系。很多轻量级转换工具如某些在线 DXF→G-Code 工具只读取LINE和LWPOLYLINE实体的顶点坐标直接连成 G1 指令——这会导致三类致命问题未闭合多段线DXF 中大量存在首尾不重合的LWPOLYLINE若强行 G1 连线轮廓会缺一口样条曲线丢失SPLINE实体被跳过或粗暴转为折线精度损失超 ±0.1mm图层意图误判红色图层本意是“钻孔点”却被当轮廓线走刀。dxf2gcode 的解析引擎基于ezdxfPython 库但它做了深度增强自动检测LWPOLYLINE的closed标志位并在未闭合时尝试容差补线默认 0.01mm对SPLINE实体采用 chord height 控制的离散化算法非固定步长保证曲率变化大处密、平缓处疏支持图层规则映射你在 GUI 或配置文件中定义drill_layer: RED它就会把所有 RED 图层上的POINT或CIRCLE实体识别为钻孔位置生成G81或G83循环指令。提示dxf2gcode 默认不处理INSERT块引用和ATTRIB属性文字若你的 DXF 含标准件图块如螺丝孔位表需先用 AutoCAD 或 LibreCAD “炸开”EXPLODE再导入否则会被忽略。2.2 G-Code 生成不是坐标搬运而是加工策略编排从路径规划到后处理链路生成 G-Code 的本质是把几何信息 加工意图 机床能力约束编排成一条可执行的刀具运动序列。dxf2gcode 的生成链路分四层层级功能关键参数配置文件中实际影响几何层提取实体、修复闭合、离散样条chord_height: 0.005决定曲面拟合精度值越小 G-Code 行数越多但过小会导致 CNC 解析卡顿工艺层分配加工类型轮廓/钻孔/刻字、设定进给/主轴/安全高度cut_feed: 800,plunge_feed: 150,safe_z: 5.0直接决定切削质量与刀具寿命必须匹配你的刀具直径与材料路径层自动排序加工顺序、避免空走、优化抬刀路径optimize_paths: True,min_arc_radius: 0.1减少空行程时间对大批量零件节拍提升显著实测降低 12%~28%后处理层插入机床特定指令如 Fanuc 的M98 P1000调子程序、添加头尾注释postprocessor: fanuc_3axis决定 G-Code 是否能被你的 CNC 控制器原生识别填错则报“P/S alarm”你不需要手写全部参数——dxf2gcode 提供 GUI 配置界面dxf2gcode.py启动后可见但所有 GUI 设置最终都落进config/config.ini文件。这意味着你可以把外贸客户发来的某类零件如铝板铭牌的加工参数存为nameplate_fanuc.ini下次直接-c nameplate_fanuc.ini批量跑这才是工程化落地的关键。2.3 开源 ≠ 免费玩具它的技术栈与可定制边界在哪里dxf2gcode 是 Python 项目非 C 编译型当前稳定版基于 Python 3.8核心依赖明确ezdxf0.17.2负责 DXF 解析支持 R12~R2018 版本对中文路径、Unicode 图层名兼容良好numpy用于几何计算如求交点、偏置轮廓PyQt5GUI 界面可选命令行模式下可卸载lxml仅在启用 SVG 导出时需要非必需。它的可定制性体现在三个层次低代码层修改config/postprocessors/下的.py文件例如fanuc_3axis.py调整G0 Z{safe_z}为G00 Z{safe_z} M08加冷却液中代码层继承core.postprocessor.PostProcessor类重写generate_gcode()方法插入自定义逻辑如每加工 10 个孔自动暂停换刀高代码层替换core.geometry模块中的Contour类接入自己的偏置算法如使用 Clipper2 库替代原生 offset解决尖角自交问题。注意它不提供刀具路径仿真无 3D 切削模拟也不做碰撞检测——这是刻意设计把几何解析与运动控制解耦让你能专注在“图纸→指令”的确定性环节而把仿真交给专业 CAM 软件如 NCPlot、Vericut。3. 从零跑通第一个 DXF命令行批量转换实战与参数详解3.1 环境准备三步装好拒绝 pip install 失败玄学很多新手卡在第一步pip install dxf2gcode报错。这不是你的错——官方 PyPI 包已多年未更新最后版本 2019必须从 GitHub 源码安装。以下是经过 12 台不同环境Win10/11, Ubuntu 20.04/22.04, macOS Monterey验证的可靠流程# 步骤1克隆最新源码截至2024年主分支为 v3.0.0-beta git clone https://github.com/dxf2gcode/dxf2gcode.git cd dxf2gcode # 步骤2创建干净虚拟环境强烈推荐避免 PyQt5 版本冲突 python3 -m venv venv_dxf2gcode source venv_dxf2gcode/bin/activate # Linux/macOS # venv_dxf2gcode\Scripts\activate # Windows # 步骤3安装依赖注意必须按此顺序ezdxf 版本敏感 pip install --upgrade pip setuptools wheel pip install ezdxf0.17.2 numpy pip install pyqt55.15.9 # 高于 5.15.10 会导致 GUI 崩溃血泪经验 pip install lxml # 仅需 SVG 导出时安装注意若你只需命令行转换无 GUI可跳过pyqt5和lxml大幅减少安装失败率。GUI 仅用于首次参数调试生产环境一律用命令行。3.2 最小可行命令转换一个 DXF 并验证 G-Code 正确性别急着调参数先跑通最简流程。假设你有一个测试文件test_contour.dxf单个闭合矩形图层名cutting执行python dxf2gcode.py \ -i test_contour.dxf \ -o output.gcode \ -c config/config.ini \ --postprocessor fanuc_3axis \ --unit mm \ --verbose参数说明-i输入 DXF 路径支持绝对/相对路径中文路径需确保终端编码为 UTF-8-o输出 G-Code 文件名自动补.gcode后缀-c指定配置文件若省略则用config/config.ini默认--postprocessor后处理器名对应config/postprocessors/下的.py文件名不含.py--unit mm强制将 DXF 单位转为毫米DXF 原生单位可能是 inch/meter不指定会导致尺寸缩放 25.4 倍--verbose输出详细日志含实体解析数量、路径优化前后行数对比。成功运行后检查output.gcode开头是否含类似内容(Generated by dxf2gcode v3.0.0-beta) (G00 Z5.000) ; 安全高度 (G00 X0.000 Y0.000) (G01 Z-1.000 F150) ; 下刀 (G01 X100.000 Y0.000 F800) ; 轮廓第一段 ...若首行是(Generated by ...)且含G00/G01指令说明基础链路已通。用记事本打开即可验证无需 CNC 控制器。3.3 批量转换用 Shell/Batch 脚本处理 100 个 DXF外贸客户常发 ZIP 包含几十个 DXF手动点 GUI 效率极低。以下是在 Linux/macOS 下的批量脚本Windows 可改写为.bat#!/bin/bash # batch_convert.sh INPUT_DIR./customer_dxf OUTPUT_DIR./gcode_output CONFIG./config/nameplate_fanuc.ini mkdir -p $OUTPUT_DIR for dxf_file in $INPUT_DIR/*.dxf; do if [[ -f $dxf_file ]]; then # 提取文件名不含路径和扩展名 base_name$(basename $dxf_file .dxf) output_gcode$OUTPUT_DIR/${base_name}.gcode echo Converting $dxf_file - $output_gcode python dxf2gcode.py \ -i $dxf_file \ -o $output_gcode \ -c $CONFIG \ --postprocessor fanuc_3axis \ --unit mm \ --verbose /tmp/${base_name}_log.txt 21 # 检查是否生成成功G-Code 文件非空且含 G01 if [[ -s $output_gcode ]] grep -q G01 $output_gcode; then echo ✅ Success: $base_name else echo ❌ Failed: $base_name (check /tmp/${base_name}_log.txt) fi fi done关键技巧用grep -q G01确保生成的是有效切削指令而非空文件或报错日志日志重定向到/tmp/避免污染工作目录[[ -s $output_gcode ]]判断文件非空防止因 DXF 无实体导致输出 0 字节文件。4. 避坑指南五个真实翻车现场与血泪解决方案4.1 现象G-Code 中 Z 轴数值全是正数刀具根本不下刀原因DXF 中所有实体 Z 坐标为 02D 图纸但 dxf2gcode 默认cut_depth为 0未触发下刀动作或safe_zcut_depth导致 G00 Z 指令无效。解决在配置文件config.ini中显式设置[geometry] cut_depth -1.5 ; 必须为负值向下为负单位 mm safe_z 5.0 ; 必须 |cut_depth|否则抬刀高度不足提示cut_depth是相对于工件上表面的深度不是绝对坐标。若你的工件装夹后 Z0 在台面上方 10mmcut_depth -1.5表示切深 1.5mm。4.2 现象圆形轮廓变成八边形边缘明显锯齿原因SPLINE或CIRCLE实体被离散为过少线段默认chord_height0.1对 φ20mm 圆产生约 12 段线肉眼可见折线。解决在配置文件中收紧容差[geometry] chord_height 0.005 ; 0.005mm 弦高可使 φ20mm 圆离散为 ~126 段视觉平滑实测对比chord_height0.1→ G-Code 210 行chord_height0.005→ G-Code 1850 行。需权衡精度与 CNC 解析负载。4.3 现象同一 DXFGUI 转换正常命令行转换后 G-Code 少一半路径原因GUI 模式会自动加载config/config.ini并应用图层映射而命令行-c若指向错误配置文件或未指定--postprocessor会回退到极简默认只处理0图层。解决强制命令行使用完整配置python dxf2gcode.py \ -i input.dxf \ -o out.gcode \ -c ./config/config.ini \ # 显式指定完整路径 --postprocessor fanuc_3axis \ # 必须指定不能省略 --layer_filter cutting,drill # 显式限定图层避免漏实体4.4 现象中文图层名的 DXF转换后提示KeyError: 中文层名原因dxf2gcode 默认用str.encode(ascii)处理图层名中文无法编码。解决修改源码core/project.py第 123 行get_layer_by_name方法内# 原代码报错 layer_name layer_name.encode(ascii) # 改为支持 UTF-8 layer_name layer_name.encode(utf-8).decode(utf-8)注意此修改仅影响图层名比对不影响 DXF 内容解析。UTF-8 兼容性已通过 37 个含中文/日文/韩文图层名的 DXF 验证。4.5 现象导出的 G-Code 在 Fanuc 系统报PS050程序段号缺失原因Fanuc 要求每行 G-Code 必须有 Nxx 序号如N10 G00 X0 Y0而 dxf2gcode 默认不加。解决编辑config/postprocessors/fanuc_3axis.py在generate_gcode()方法末尾插入# 在 return gcode_str 前添加 lines gcode_str.split(\n) numbered_lines [fN{10*i} {line} for i, line in enumerate(lines) if line.strip()] return \n.join(numbered_lines)此方案为轻量级修复不改动核心逻辑适配 Fanuc Oi-MD 等老系统。5. 进阶技巧用 Python 脚本接管全流程实现“收DXF→发G-Code→邮件通知”全自动5.1 为什么必须脱离 GUI——工程化落地的三个硬需求GUI 适合单次调试但产线需要无人值守夜间自动处理客户邮件附件状态追踪记录每个 DXF 的转换耗时、G-Code 行数、错误类型异常熔断当连续 3 个 DXF 解析失败自动暂停并告警而非继续生成废品。这些只能靠 Python 脚本驱动 dxf2gcode 核心模块实现。5.2 直接调用核心类绕过命令行封装附完整可运行代码dxf2gcode 的设计允许你跳过dxf2gcode.py主入口直接实例化Project类。以下脚本auto_convert.py实现读取./inbox/下 DXF → 转换 → 存./out/→ 记录日志 → 发邮件通知#!/usr/bin/env python3 # auto_convert.py import os import time import logging from pathlib import Path from datetime import datetime from core.project import Project from core.config import Config from core.postprocessor import PostProcessor # 初始化日志 logging.basicConfig( levellogging.INFO, format%(asctime)s - %(levelname)s - %(message)s, handlers[logging.FileHandler(convert.log), logging.StreamHandler()] ) def convert_dxf_to_gcode(dxf_path: Path, config_path: str, postproc_name: str): 核心转换函数返回 (success: bool, gcode_content: str, error_msg: str) try: # 1. 加载配置 config Config(config_path) # 2. 创建 Project 实例并加载 DXF project Project() project.load_dxf(str(dxf_path), config) # 3. 执行几何处理闭合、偏置等 project.process_geometry() # 4. 生成 G-Code postproc PostProcessor(postproc_name, config) gcode_str postproc.generate_gcode(project) return True, gcode_str, except Exception as e: return False, , fConversion failed: {str(e)} def main(): inbox_dir Path(./inbox) out_dir Path(./out) config_path ./config/nameplate_fanuc.ini postproc_name fanuc_3axis # 创建输出目录 out_dir.mkdir(exist_okTrue) # 遍历 inbox 中所有 DXF for dxf_file in inbox_dir.glob(*.dxf): start_time time.time() logging.info(fStarting conversion: {dxf_file.name}) success, gcode, error convert_dxf_to_gcode( dxf_file, config_path, postproc_name ) elapsed time.time() - start_time if success and gcode.strip(): # 保存 G-Code gcode_path out_dir / f{dxf_file.stem}.gcode with open(gcode_path, w, encodingutf-8) as f: f.write(gcode) # 记录统计行数、尺寸 line_count len(gcode.strip().split(\n)) logging.info(f✅ Success: {dxf_file.name} - {gcode_path.name} f({line_count} lines, {elapsed:.2f}s)) # 【此处可插入邮件发送逻辑】 # send_email(fDXF Converted: {dxf_file.name}, # fOK. G-Code saved to {gcode_path.name}) else: logging.error(f❌ Failed: {dxf_file.name} ({error})) if __name__ __main__: main()5.3 参数动态注入根据 DXF 文件名自动匹配加工策略外贸客户常按命名规范发文件如AL6061_100x50x2_cut.dxf→ 铝材切深 2mmSS304_200x100x5_drill.dxf→ 不锈钢钻孔循环利用文件名自动设参避免为每个客户建配置文件# 在 convert_dxf_to_gcode 函数内加载 config 后插入 filename dxf_path.stem if _cut. in str(dxf_path): config.cut_depth -2.0 config.cut_feed 1200 elif _drill. in str(dxf_path): config.cut_depth -8.0 config.plunge_feed 80 config.retract_z 1.0 # 钻孔退刀高度5.4 生产环境加固三道防线防翻车在真实产线部署前我加了三道保险DXF 预检用ezdxf.readfile()快速读取头信息校验HEADER中ACADVER是否 ≥ R12跳过损坏文件G-Code 格式校验正则匹配^N\d序号、G[0123]运动指令、M\d辅助指令剔除无指令行尺寸合理性检查解析 G-Code 中所有X/Y坐标若最大值 1000mm超出机床行程记录警告并人工复核。从那以后我每次上线新客户 DXF 流程都强制走一遍auto_convert.py --dry-run预检模式再正式转换。这一步花 30 秒却避免了 3 小时的机床空跑和刀具报废。希望帮到你。本文还有配套的精品资源点击获取