python-docx 撞名一次搞懂: 為什麼 from docx import Document 是函式，但 from docx.document import Document 是類別？

by 儲蓄保險王 · 2026-01-08

在 python-docx 裡有兩個東西都叫 Document，但它們角色不同：

from docx import Document
這個 Document 通常是「入口函式（factory function）」：
用來 建立空白文件 或 讀取 docx。
from docx.document import Document
這個 Document 才是「真正的類別（class/type）」：
用來做 isinstance() 判斷、type hint。

因此才會出現常見錯誤：把函式拿去當 isinstance() 的第二參數。

最推薦的寫法：用別名把角色分清楚

from docx import Document as load_doc
from docx.document import Document as DocxDocument

# 讀/建文件：用 load_doc
doc = load_doc()

# 判斷型別：用 DocxDocument
print(type(doc))
print(isinstance(doc, DocxDocument))  # True

from docx import Document as load_doc
from docx.document import Document as DocxDocument

# 讀/建文件：用 load_doc
doc = load_doc()

# 判斷型別：用 DocxDocument
print(type(doc))
print(isinstance(doc, DocxDocument))  # True

可以在 Jupyter 直接驗證（會印出函式 vs 類別）

from docx import Document
from docx.document import Document as DocxDocument

print("Document =", Document)
print("type(Document) =", type(Document))

doc = Document()
print("type(doc) =", type(doc))
print("isinstance(doc, DocxDocument) =", isinstance(doc, DocxDocument))

from docx import Document
from docx.document import Document as DocxDocument

print("Document =", Document)
print("type(Document) =", type(Document))

doc = Document()
print("type(doc) =", type(doc))
print("isinstance(doc, DocxDocument) =", isinstance(doc, DocxDocument))