go-cad

简体中文 | English

纯 Go 的 DWG/DXF 解析、渲染与写出库——R9～R2018 全版本、零 cgo、与 LibreDWG 逐键对齐。

go-cad 在位级解析 Autodesk DWG 图纸（R9～R2018），支持渲染 PNG/SVG、文本提取，并能按六代容器把解析结果回写为 DWG 文件。同时支持 DXF 双向转换与 LibreDWG 风格 JSON 输入。无 cgo、无外部二进制依赖，作为独立模块可嵌入任意 Go 服务。

解码正确性以 LibreDWG（参考实现）为金标准做逐键值级验证：37 个语料图纸、其中 34 个 strict 硬门禁，全部 100% 对齐。实现为独立纯 Go 表达，按 LibreDWG 规格逐位对齐修正。

• 🗂️ 全版本 DWG 读取：R9/R10/R11（pre-R13 独立路径）+ R13/R14/R2000/R2004/R2007/R2010/R2013/R2018
• ✍️ DWG 写出：六代容器（R2000→R2018），回读与 LibreDWG dwgread 双重验证
• 🖼️ PNG 渲染：真实 CJK 字形引擎（旋转/镜像/对齐/宽度因子），分辨率自动保证文字清晰
• 📐 SVG 输出：真矢量 + AI 友好元数据（图层分组/实体类型/句柄/图纸摘要）
• 🔪 智能拆图（独有能力）：自动识别模型空间图框（含非标加长幅）、提取图号与图名、逐幅出图；设计说明/图例表等无框内容区自动兜底切分；整图全览固定首张
• 📝 文本提取：单张 4MB 图纸提取 1.4 万条文本，GBK/UTF-16 码页解码，pre-R13 码页支持
• 🔄 DXF 双向：ASCII + 二进制读取、23+ 实体写出，经 LibreDWG dxf2dwg 金标准 59/59 验证
• 📥 JSON 输入：直接消费 LibreDWG 风格 gold JSON（41 种实体）
• 🧱 结构化正向写出：JSON/DXF/内存构造的 Document 均可直接写出 DWG（等价官方 dxf2dwg / dwgwrite -I json 核心能力）
• 🛡️ 工业级可靠性：147 个官方语料全量吞吐零 bug、千级变异模糊零 panic、出图自动清晰度保障（不达标自动提升分辨率重渲）
• 💻 CLI 内置：dwg2png 支持 DWG/DXF → PNG/SVG，含智能拆图模式；caddocling 输出结构化 manifest（图框+文本+图片清单），供 AI 管线与联犀 docling 消费
• 🤝 Docling 集成（联犀文档解析库原生支持 CAD 输入）：unitedrhino/docling 原生集成 go-cad，.dwg/.dxf/.dxfb 与 PDF/Word 等走同一条解析管线

工程图纸的中文支持是一等公民，不是事后补丁：

• TEXT/MTEXT/ATTRIB/ATTDEF 全实体类型的 GBK/UTF-16 码页解码（R13+）与 pre-R13 码页（R9～R11 头变量码页）
• 大字体（bigfont）场景与 \U+XXXX 转义处理
• 渲染使用 CJK 字形引擎，中文标注在 PNG/SVG 中清晰可读
• 真实验证：4 张中文工程图纸（含 505 个中文 TEXT 的 R2000 图纸）值级对齐 100%

以下均为 dwg2png 的真实渲染输出（样例取自公开语料中的中文工程图纸，未经任何人工修饰）：

V 型滤池泵房工艺图（R2018 容器）：剖面对象、彩色工艺管线、图例表格与标题栏一次成形。

内侧行走轮轴零件图：32 处线性/直径标注（φ14～φ25）的尺寸线、界线、箭头与公差文字完整呈现（标注匿名块几何），粗糙度符号引线正确指向；技术要求与标题栏逐字清晰——GBK/UTF-16 码页解码 + 内置 CJK 字形引擎，不依赖系统字体。

• ACIS 几何内核（3DSOLID/REGION 的 SAT/SAB 重建）——LibreDWG 也只存 blob，无参考可验证
• pre-R13 写出——LibreDWG 的 encode 同样不支持
• R2.x～R8 古董格式——超出 LibreDWG 支持范围
• 少数 spec 分支经两轮全网搜索无真实样本（光度 LIGHT、pre-R13 中文）——已按 spec 实现+合成自证
• 约 5% 的 DumpEntities 长尾表记录键（进行中，已验证键 15923/15923）

go get github.com/unitedrhino/go-cad

package main

import (
    "bytes"
    "os"

    "github.com/unitedrhino/go-cad"
)

func main() {
    data, _ := os.ReadFile("drawing.dwg")

    doc, err := cad.Parse(data) // 也有 ParseDXF、ParseJSON
    if err != nil { panic(err) }

    texts := doc.Texts() // 4MB 图纸提取 1.4 万条文本

    png, err := cad.RenderPNG(doc, cad.RenderOptions{Width: 4096})

    var buf bytes.Buffer
    err = cad.WriteDwg(doc, &buf) // 六代容器写出，按版本自动分派

    svg, err := cad.RenderSVG(doc, cad.RenderOptions{Width: 4096})
    _ = png; _ = svg
}

go run ./cmd/dwg2png drawing.dwg -o out.png            # PNG（2048）
go run ./cmd/dwg2png drawing.dwg -o out.svg            # SVG（矢量，无限缩放）
go run ./cmd/dwg2png drawing.dwg -sheets -o s.png      # 智能拆图：
                                                       # 按图框逐张出图（宽度自适应），
                                                       # 无框内容区（设计说明/图例表）兜底切分，
                                                       # 首张固定整图全览
go run ./cmd/caddocling drawing.dwg -o out             # 结构化 manifest（图框+文本+图片清单），
                                                       # 供 AI 管线与联犀 docling 消费

go run ./example

零参数即跑全链路（解析→文本→渲染→DWG 回写→再解析校验→DXF 双向→JSON 导出），产物 PNG/DWG/DXF 落当前目录；-f 指定任意样本、-o 改输出目录、-width 改渲染宽度。源码见 example/main.go，6 步每步都是库公开 API 的最小用法。

同组织的纯 Go 文档解析库 unitedrhino/docling（PDF/Word/PPT/Excel/HTML/Markdown/EML/图片/CAD 图纸等 13 种格式统一解析为 Docling 协议，联犀物联网平台知识库同款引擎）已原生集成 go-cad：.dwg/.dxf/.dxfb 可直接作为输入格式——每张图框一页（图名标题 + 渲染图 + 图纸文本），与 PDF/Word 等文档一起进入统一的 Markdown/JSON/content_list 输出与切片管线。

data, _ := os.ReadFile("图纸.dwg")

doc, err := docling.ParseByExt("图纸.dwg", data) // 按扩展名自动分派，CAD 每图框一页
if err != nil { panic(err) }

md := doc.ToMarkdown() // 图名标题 + 图纸文本，与 PDF/Word 同一协议

完整能力（其他输入格式、content_list、RAG 分块、大模型增强钩子）见 unitedrhino/docling。

每个版本都在真实生产图纸上验证，而非仅合成数据：

• 4.3MB 智能化深化设计图（108,850 对象）：250 万实体键值与 LibreDWG gold 对照 100%；8192px 渲染中文标注清晰可读；回写后无损再解析
• 消防/弱电施工图：9+9 张图框智能拆分，图号与图名（如 RD(XF)-05-地下一层消防平面图）从标题栏自动提取；彩色线型图例表 16 行完整还原
• 室外总平面图：离群实体修复，渲染内容完整可见
• 147 个 LibreDWG 官方语料：全消费链路（解析→渲染→写出→再解析），以 dwgread 仲裁——0 bug
• 模糊测试：1000+ 变异体 + 随机输入，零 panic（开发期发现并修复 4 个）

外部对照资源（LibreDWG gold JSON）经环境变量门控；内置 testdata 套件在任何环境完整运行。

纯解析吞吐为 LibreDWG dwgread（C 实现，全链路口径）的 2.3～6.4 倍：

4.3MB / 10.8 万对象图纸：解析 691ms、PNG@2048 4.1s、DWG 回写 785ms、26 张 SVG 拆图数秒。

依赖方向单向：bitstream → objrec → container → entity/object → drawing → render/writer， 全部实现位于 internal/，外部仅经 cad.go 门面消费。

见与 LibreDWG 的对比——简版：ACIS 几何内核（仅存 blob，同官方）、pre-R13 写出（官方同样不支持）、R2.x～R8 古董格式、极少数无真实样本的 spec 分支（合成自证）、约 5% 长尾表记录键。

• 值级对齐金标准：LibreDWG dwgread -O JSON 与 dxf2dwg

PR 欢迎提交，go test ./... 必须通过——套件内置值级对齐门禁，保证解码始终诚实。

欢迎通过任意方式参与共建:

• 提 Issue / PR:本仓库
• ⭐ 欢迎 Star 我们的物联网平台 unitedrhino/things——联犀,AI · 物联网 · SaaS 开发底座:快速接入设备,用你熟悉的 AI(Skills / CLI)接入与调试设备,结合设备数据与业务工具构建自己的 AI 应用,再扩展为面向客户的 SaaS、行业应用与智能终端;基础版永久免费,支持私有部署。官网:unitedrhino.com
• 扫码关注公众号「云物通科技」,获取版本更新与 CAD 解析实践分享,一起共建:

Apache-2.0，详见 LICENSE。