NPOI 的 XWPFDocument 僅支持 Office Open XML 格式(.docx,本質是 ZIP 包含 XML)。對於舊版二進制格式 .doc,需使用 HWPFDocument,但功能極其有限(僅文本提取),不支持複雜排版、圖片、表格操作。
.doc 讀寫轉換。HWPF 同樣受限。soffice --headless --convert-to docx input.doc 統一轉為 .docx 再用 NPOI 處理,功能最全。.docx,不依賴第三方。新系統統一要求上傳 .docx,或上傳時自動調用 LibreOffice 轉換,避免維雙重解析邏輯。