Android 將文字內容儲存為 Word (.docx) 檔案：Apache POI 完整實作教學

方案選擇

Android 無內建 Word 產生 API，業界標準做法是使用 Apache POI（支援 .docx / .xlsx / .pptx）。

Gradle 依賴設定

dependencies {
    implementation 'org.apache.poi:poi:5.3.0'
    implementation 'org.apache.poi:poi-ooxml:5.3.0'
    // Android 需額外排除重複類別
    implementation 'org.apache.xmlbeans:xmlbeans:5.1.1'
}

核心程式碼範例

public File createDocx(Context ctx, String title, String content) throws IOException {
    XWPFDocument doc = new XWPFDocument();
    XWPFParagraph p = doc.createParagraph();
    p.setAlignment(ParagraphAlignment.CENTER);
    XWPFRun run = p.createRun();
    run.setText(title);
    run.setBold(true);
    run.setFontSize(18);

    p = doc.createParagraph();
    run = p.createRun();
    run.setText(content);
    run.setFontSize(12);

    File file = new File(ctx.getExternalFilesDir(null), "export.docx");
    try (FileOutputStream fos = new FileOutputStream(file)) {
        doc.write(fos);
    }
    doc.close();
    return file;
}

注意事項

• POI 體積較大（~10 MB），APK 會膨脹；若只需簡單報表，可考慮 HTML 轉 Word 或伺服端產生。
• Android 10+ 需使用 MediaStore 或 FileProvider 分享檔案。
• 中文字型需嵌入或指定系統字型，否則可能顯示方塊字。

替代方案速查