AI 工作實務
ezdxf 教學:用 Python 產生 DXF 圖面、圖層與尺寸標註
用 Python ezdxf 依參數產生 DXF 概念圖:單位設定、圖層、圖塊、尺寸標註與 audit 檢查,說明 DXF 與 BIM 的分工、跨 CAD 軟體交付,以及程式製圖不能取代專業簽核的界線。

本文目錄
ezdxf 能做什麼?和 CAD 軟體怎麼分工4 個技術重點:讓 DXF 交出去不出錯安裝與版本確認第一個可執行範例:含圖層與標註的房間配置8 個實務情境:從配置草圖到 AI 製圖助理常見錯誤、原因與修正上線前驗收清單常見問題官方資料來源延伸閱讀與企業實作用 Python ezdxf 依參數產生 DXF 概念圖:單位設定、圖層、圖塊、尺寸標註與 audit 檢查,說明 DXF 與 BIM 的分工、跨 CAD 軟體交付,以及程式製圖不能取代專業簽核的界線。
同一款零件只差長寬與孔位,同一間會議室要比較五種桌椅配置,設計人員卻得一張一張重畫。ezdxf 是 Python 讀寫 DXF 檔的開源套件,可以把尺寸參數直接轉成 CAD 能開啟的圖面,讓重複的製圖工作變成程式。
這篇說明 ezdxf 的基本用法與驗收方式:單位設定、圖層、圖塊、標註,以及如何用 audit 與 CAD 軟體確認檔案可用。範例以 ezdxf 1.4.5 實測。需要強調的是,程式產生的圖面屬於概念圖或草圖,不能取代建築師、技師或工程師的專業審查。
重點回答:ezdxf 是讀寫 DXF 的 Python 套件,可依參數產生圖層、線條與標註,適合重複的概念配置圖。
ezdxf 能做什麼?和 CAD 軟體怎麼分工
| 工作 | ezdxf | CAD 軟體 | 專業人員 |
|---|---|---|---|
| 依參數批次產生幾何 | 擅長 | 需手動或寫外掛 | 定義參數範圍 |
| 讀取既有 DXF、統計圖元 | 擅長 | 可以 | — |
| 互動式修改與出圖排版 | 不適合 | 擅長 | — |
| 法規、結構與施工判斷 | 不能 | 不能 | 必須負責 |
| 匯出 PNG、PDF 預覽 | 可透過 drawing 外掛 | 可以 | 確認內容 |
DXF 是 AutoCAD 公開的資料交換格式,多數 CAD 軟體都能讀寫。ezdxf 讓 Python 程式直接操作這種格式,不需要安裝任何 CAD 軟體。
4 個技術重點:讓 DXF 交出去不出錯
單位要寫進檔案
DXF 裡的座標只是數字,4200 可能是 4200 毫米,也可能是 4200 公尺。用 doc.units = units.MM 設定圖面單位(對應 DXF 標頭的 $INSUNITS,毫米的值是 4),收件方匯入時才不會比例錯誤。
原點位置、座標軸方向與數值精度,也要在專案開始時約定好。
模型空間與圖紙空間分開
模型空間(modelspace)放實際尺寸的幾何,圖紙空間(paperspace)用來安排圖框、比例與出圖。在模型空間畫得出線條,不代表圖框、標註和列印比例都完成了。
圖層名稱要有標準
牆體、家具、尺寸、文字備註應該放在不同圖層,並約定顏色與線型。所有東西都畫在預設的 0 圖層,收件方幾乎無法修改或關閉特定元素。
用 setup=True 取得標準樣式
ezdxf.new('R2010', setup=True) 會預先建立常用的線型、文字樣式與標註樣式,例如 EZDXF 標註樣式。沒有這一步,加上尺寸標註時可能找不到需要的樣式。
安裝與版本確認
用 pip install ezdxf 安裝,執行 python -c "import ezdxf; print(ezdxf.__version__)" 確認版本。需要輸出 PNG 或 PDF 預覽時,另外安裝 matplotlib,就能使用 ezdxf draw 指令。
產生檔案時要指定 DXF 版本,例如 R2010。收件方使用較舊的 CAD 軟體時,先確認對方能開啟的版本。
第一個可執行範例:含圖層與標註的房間配置
以下程式在 ezdxf 1.4.5 實測,產生一個 6000×4200 毫米的房間外框、一個尺寸標註與一個重複使用的椅子圖塊,最後重新讀檔並執行結構檢查。
pip install ezdxfimport ezdxf
from ezdxf import units
doc = ezdxf.new("R2010", setup=True)
doc.units = units.MM
doc.layers.add("WALL", color=7)
doc.layers.add("DIM", color=1)
msp = doc.modelspace()
msp.add_lwpolyline([(0, 0), (6000, 0), (6000, 4200), (0, 4200)],
close=True, dxfattribs={"layer": "WALL"})
dim = msp.add_linear_dim(base=(0, -600), p1=(0, 0), p2=(6000, 0),
dimstyle="EZDXF", dxfattribs={"layer": "DIM"})
dim.render()
chair = doc.blocks.new("CHAIR")
chair.add_lwpolyline([(0, 0), (450, 0), (450, 450), (0, 450)], close=True)
msp.add_blockref("CHAIR", (2000, 1200))
doc.saveas("room.dxf")
check = ezdxf.readfile("room.dxf")
auditor = check.audit()
print("單位", check.units, "錯誤數", len(auditor.errors))執行結果為「單位 4、錯誤數 0」。若安裝了 matplotlib,可以用 ezdxf draw -o room.png room.dxf 輸出預覽圖,快速確認幾何位置。

8 個實務情境:從配置草圖到 AI 製圖助理
以下情境是為說明參數化製圖而設計的教學範例,並非真實工程案例,也不構成設計或施工建議。
情境 1:會議室配置草圖
把房間長寬、桌子尺寸與位置寫成以毫米為單位的參數,程式產生配置圖並檢查家具沒有超出房間範圍。
這類圖面適合用來討論方案,圖上要清楚標示「概念設計,不供施工」。消防與無障礙動線仍須由專業人員確認。
情境 2:零件外框與孔位
一系列零件只差長寬與孔距,可以寫成一個函式輸出外框與孔中心(add_circle)。每個尺寸都能由輸入參數反推。
座標正確不代表可以直接加工。孔位公差、基準面與加工要求,要和製造工程師確認。
情境 3:多種戶型比較
比較不同戶型時,所有圖面要使用相同的單位、圖層與座標基準。毫米與公尺混用時,面積比較會差上百萬倍。
在檔案標頭設定單位,並在檔名或附表記錄版本,方便日後對照。
情境 4:大量配置變體
同一個場域要比較 20 種設備組合時,每個 DXF 都要保存當時的參數快照與檔案雜湊,以變體編號命名。
只看圖檔名稱,事後很難回推當時的設備尺寸與位置。參數檔和圖檔一起保存,才能重現。
情境 5:CAD 與 BIM 的分工
DXF 主要保存幾何與圖層,BIM 模型還包含構件屬性、材料與彼此的關係。需要材料數量或維護資訊時,不能把 DXF 當成完整的 BIM 模型。
先列出需要交換的欄位,確認哪些資料 DXF 帶不過去,再決定要搭配哪種交換格式。
情境 6:門窗圖塊重複使用
標準門窗符號用 doc.blocks.new() 定義成圖塊,再用 add_blockref() 插入多次。修改圖塊定義時,所有引用位置會一起更新。
圖塊也需要版本管理,建立核准過的圖塊庫,避免各專案各自畫一套尺寸不同的符號。
情境 7:交給不同 CAD 軟體的承包商
承包商可能使用 AutoCAD、BricsCAD 或其他軟體。交付前先用 audit() 檢查結構,再用收件方使用的軟體實際開啟,抽看文字、字型、標註與圖層。
中文文字在 DXF 中依賴收件方電腦上的字型,缺字型時會顯示成問號或方框。
情境 8:AI Agent 協助製圖
使用者用自然語言描述需求,例如「六人會議室放一張長桌」。AI Agent 要先把需求轉成有單位的參數表,交由人確認,再呼叫 ezdxf 產圖。
尺寸、用途或現場條件不明時,應該回頭詢問或標示待確認。法規要求的數值,不能由模型自行假設。
常見錯誤、原因與修正
| 現象 | 常見原因 | 修正方式 |
|---|---|---|
| 匯入後尺寸差 1000 倍 | 未設定或誤設單位 | 設定 doc.units,並與收件方確認 |
| 標註樣式找不到 | 建立文件時未 setup | 使用 ezdxf.new(…, setup=True) |
| 標註不顯示 | 建立後沒有 render() | 對標註物件呼叫 render() |
| 中文顯示為問號 | 收件方缺少字型 | 約定文字樣式與字型,交付前實際開啟 |
| 舊版 CAD 打不開 | DXF 版本太新 | 依收件方需求指定 R2010 等版本 |
上線前驗收清單
- 參數表寫明單位、原點與容許誤差。
- 圖層名稱、顏色與線型符合專案標準。
- 重新讀檔並執行 audit,沒有結構錯誤。
- 已用收件方的 CAD 軟體開啟,抽查文字、標註與圖層。
- 圖面標示用途(概念圖或草圖),並經負責的專業人員審查。
常見問題
ezdxf 可以取代 AutoCAD 嗎?
不行。ezdxf 是處理 DXF 檔的程式庫,沒有互動式繪圖介面,也不負責出圖排版與設計審查。
ezdxf 能讀寫 DWG 嗎?
ezdxf 主要處理 DXF。DWG 需要先用其他轉換工具(例如 ODA File Converter)轉成 DXF,ezdxf 的 odafc 外掛可協助呼叫該工具。
產生的 DXF 可以直接拿去施工嗎?
不能。程式產生的圖面要經過合格專業人員審查、補齊圖框與標註並簽核,才可能成為施工圖。
AI 可以自動畫 CAD 圖嗎?
在需求已轉成結構化參數、工具權限受控的前提下,AI 可以呼叫 ezdxf 產生幾何;設計責任與簽核仍屬於專業人員。
官方資料來源
圖片為原創示意圖。
延伸閱讀與企業實作
- 從 CAD 到 PCB 再到實體樣機:AI 能做硬體,製造驗收才是分水嶺
- 圖面改到第 6 版,現場還在用第 4 版?設計變更如何留下可追責的通知鏈
- JSON 是什麼?從資料格式到 API、AI Agent 與企業自動化的完整實戰指南
設計、製造或營建團隊若有大量「只改尺寸」的重複製圖,可以帶幾張現行圖面與參數表,和天地人一起評估哪些圖適合參數化產生、需要哪些圖層標準與專業簽核關卡。製造業團隊也可以參考天地人 AI 製造學程,系統性規劃 AI 在設計與生產端的應用。
本文由 TARAISG(TIANDIREN AI SOLUTION GROUP)使用 AI 模型產生正文、整理來源並設計實務工具。方法依據與限制列於文末;案例為明確標示的教學假設。未有具名紀錄時,不宣稱經人工或專家審核。
查看內容製作與更正說明