WooCommerce PDF 外掛常不支援中文？ - TAN-studio 香港網頁設計 - 香港HK WordPress, OpenCart, Shopify...

WooCommerce 的 PDF 發票外掛（如 WebToffee 的 WooCommerce PDF Invoices, Packing Slips, Delivery Notes & Shipping Labels）在處理中文時經常出現不支援或顯示問題，這是許多台灣、香港、中國商家都會遇到的痛點。

為什麼 WooCommerce PDF 外掛常不支援中文？

• 預設渲染引擎是 dompdf：WebToffee 免費版使用 dompdf 這個 PHP 庫來把 HTML 轉成 PDF。dompdf 對 Unicode（尤其是中日韓 CJK 文字）的支援非常有限，常導致中文變成方塊（□）、問號（?）、完全空白，或根本不顯示。
• 字型問題：即使有中文字，dompdf 預設字型（如 DejaVu Sans 或 Open Sans）不包含完整的中文字符集，無法正確渲染繁體/簡體中文。
• 其他常見情況：商品名稱、地址、備註、統一發票號碼等只要包含中文，就容易出問題；RTL（右到左）語言如阿拉伯文也會有類似困擾。

這不是外掛 bug，而是底層 PDF 引擎的限制。官方文件也明確指出：dompdf 只提供部分 Unicode 支援，建議改用 mPDF 來解決亞洲語言問題。

推薦解決方法（2026 年最新有效方案）

方法一：最簡單、最官方推薦 → 安裝免費 mPDF add-on（90% 以上案例直接解決）

WebToffee 官方提供免費的 mPDF add-on for PDF Invoices, Packing Slips, Delivery Notes & Shipping Labels，專門用來取代 dompdf，提供完整的 Unicode 與 RTL 支援，包括中文、日文、韓文等。

步驟：

1. 進入 WordPress 後台 → 外掛 → 新增外掛
2. 搜尋 “mPDF add-on for PDF Invoices” 或 “mPDF add-on for RTL and Unicode Support”（開發者：WebToffee，免費）
3. 安裝並啟用
4. 前往 WordPress 後台 → WooCommerce → Invoices/Packing → General Settings → Advanced（或直接搜尋「PDF library」）
5. 把 PDF library 從 dompdf 改成 mPDF
6. 勾選 Enable RTL support（雖然是中文，但啟用後對 Unicode 更有幫助）
7. 儲存設定
8. 重新產生一張訂單的 PDF 發票 / 裝箱單測試

效果：大多數使用者安裝後，中文立刻正常顯示（繁體、簡體都行），不再出現方塊或亂碼。官方文件（2025 年更新）也強烈推薦這個方式處理「language missing issues」。

注意：如果你的網站使用 WPML 多語言，記得確認訂單語言設定正確；mPDF 也支援 WPML。

方法二：如果 mPDF 後中文仍不夠完美 → 自訂中文字型（進階）

mPDF 雖然支援 Unicode，但預設字型有時對繁體中文顯示不夠美觀（例如字重、間距）。這時可以手動加入中文字型：

1. 下載開源中文字型（推薦 Google Noto Sans TC / Noto Serif TC，完整支援繁簡）：
   • 從 https://fonts.google.com/noto 下載 TTF 檔（Regular + Bold）
2. 在子主題建立資料夾（避免更新覆蓋）：
   text

   wp-content/themes/你的子主題/woocommerce/pdf/invoice/fonts/

   把字型檔放進去

3. 在外掛的 Custom CSS（或自訂模板的 style 區塊）加入：

@font-face {
    font-family: 'NotoSansTC';
    src: url('fonts/NotoSansTC-Regular.ttf') format('truetype');
    font-weight: normal;
}
@font-face {
    font-family: 'NotoSansTC';
    src: url('fonts/NotoSansTC-Bold.ttf') format('truetype');
    font-weight: bold;
}

body, table, td, th, p, div, .wpo-wcpdf * {
    font-family: 'NotoSansTC', 'Noto Serif TC', sans-serif !important;
    font-size: 12pt; /* 可調整大小 */
}

4. 儲存後重新產生 PDF。

小技巧：完整中文字型檔很大（20MB+），會讓 PDF 檔案變胖。建議用工具 subset 字型，只保留需要的中文字符（可搜「font subset tool online」）。

方法三：如果還是懶得搞，考慮換插件 – 在線支付 – 信用卡, Apple Pay, Google Pay

• 我們提供直接支援中文版本的WooCommerce PDF Invoice, Package, Delivery note 支援中文 插件，經過我們反覆測試及修正問題，可以話安裝了就馬上能用。