使用 Loco Translate 上傳外掛中文化 PO 檔時,檔名不要更改
在 WordPress 裡做外掛中文化時,很多人會使用 Loco Translate 來管理翻譯檔。Loco Translate 可以讓我們在後台編輯 PO 檔、產生 MO 檔,也可以用來上傳或匯入外掛的翻譯檔。
不過使用 Loco Translate 上傳 PO 檔時,有一個很重要的小細節:PO 檔的檔名不可以隨便更改。
有時候翻譯內容明明已經修好,台灣用語也調整好了,可是上傳到 Loco Translate 之後,網站卻沒有正確套用翻譯。這時候不一定是翻譯內容有問題,也可能只是檔名被改掉了。
為什麼用 Loco Translate 上傳 PO 檔時,檔名很重要?
WordPress 外掛中文化檔案通常會依照「外掛文字網域」和「語系代碼」命名。Loco Translate 在辨識語言檔時,也會根據這些資訊來判斷這個翻譯檔要套用在哪個外掛、哪個語言。
以 WooCommerce 的台灣繁體中文 PO 檔為例,正確檔名應該是:
woocommerce-zh_TW.po
對應的 MO 檔則應該是:
woocommerce-zh_TW.mo
這個檔名不是只是方便辨識而已,它會影響 WordPress 和 Loco Translate 是否能正確對應這份外掛中文化檔案。
最常見的問題:下載後檔名變成 (1) 或 (2)
使用 Loco Translate 上傳 PO 檔前,很多人會先從網路下載修正版中文化檔案。這時候常見的問題是,原本檔名應該是:
woocommerce-zh_TW.po
可是下載到電腦後,卻變成:
woocommerce-zh_TW(1).po woocommerce-zh_TW(2).po
這通常不是 PO 檔內容壞掉,而是因為你的電腦下載資料夾裡已經有同名檔案,瀏覽器為了避免覆蓋舊檔,就自動在檔名後面加上 (1) 或 (2)。
但是這種檔名不適合直接上傳到 Loco Translate。因為檔名已經不是外掛原本應該使用的語言檔名稱,可能會造成翻譯沒有正確套用。
上傳到 Loco Translate 前,一定要先改回正確檔名
如果你下載後看到檔名變成:
woocommerce-zh_TW(2).po
請不要直接上傳到 Loco Translate。正確做法是先把檔名改回:
woocommerce-zh_TW.po
如果你同時有 MO 檔,也要確認 MO 檔名稱正確,例如:
woocommerce-zh_TW.mo
簡單來說,翻譯內容可以修正,但檔案名稱要維持原本格式。
不要把檔名改成 corrected、fixed 或新版
有些人在整理外掛中文化檔案時,會為了方便辨識,把檔名改成:
woocommerce-zh_TW-corrected.po woocommerce-zh_TW-fixed.po woocommerce-zh_TW-new.po woocommerce-zh_TW-修正版.po
這樣在自己電腦裡備份可以理解,但如果要上傳到 Loco Translate 使用,就不建議這樣做。
Loco Translate 要讀取的是外掛對應的正確語言檔名稱。檔名多了一段文字,就可能變成無法正確對應的檔案。
PO 檔和 MO 檔都要注意
外掛中文化常見會有兩種檔案:PO 檔和 MO 檔。
PO 檔是可以編輯的翻譯檔,裡面會有原文和翻譯文字。MO 檔則是 WordPress 實際讀取的編譯檔。
使用 Loco Translate 編輯翻譯後,通常會產生或更新對應的 MO 檔。如果你是手動上傳翻譯檔,也要注意 PO 和 MO 的檔名都要正確。
以 WooCommerce 為例,正確應該是:
woocommerce-zh_TW.po woocommerce-zh_TW.mo
不要變成:
woocommerce-zh_TW(1).po woocommerce-zh_TW(1).mo
檔名錯誤可能造成翻譯沒有生效
如果使用 Loco Translate 上傳 PO 檔後,發現外掛後台還是英文,或部分翻譯沒有套用,可以先檢查檔名是否正確。
檔名錯誤時,可能會出現這些情況:
- 外掛中文化沒有生效。
- 後台還是顯示英文。
- Loco Translate 找不到正確的語言檔。
- 翻譯已經修改,但網站畫面沒有變化。
- 以為 PO 檔壞掉,其實只是檔名被改了。
所以遇到外掛中文化沒有生效時,不要只檢查翻譯內容,也要先看檔名有沒有被瀏覽器自動加上 (1)、(2)。
比較保險的下載與上傳方式
為了避免上傳到 Loco Translate 時檔名出錯,建議可以這樣做:
- 下載 PO 檔前,先清理下載資料夾裡的舊語言檔。
- 下載後先確認檔名是否正確。
- 如果檔名多了
(1)或(2),先手動改回原本名稱。 - 再進入 WordPress 後台的 Loco Translate 上傳或匯入 PO 檔。
- 上傳後儲存翻譯,確認 MO 檔也有正確產生。
如果瀏覽器一直自動改檔名,也可以使用「另存連結為」的方式下載,並手動指定正確檔名。
外掛中文化檔案可以放資料夾分類,但不要改檔名
如果你會整理很多外掛中文化檔案,可以用資料夾分類,例如:
WooCommerce 中文化檔案 Elementor Pro 中文化檔案 FluentCRM 中文化檔案
這樣管理沒有問題。
但資料夾裡面的 PO / MO 檔名稱,還是要維持外掛原本需要的檔名格式。也就是說,可以改資料夾名稱,但不要改語言檔本身的檔名。
結論:用 Loco Translate 上傳 PO 檔前,先確認檔名
使用 Loco Translate 做外掛中文化時,除了翻譯內容要正確,檔名也很重要。
請記得一個原則:
翻譯內容可以修正,但 PO 檔和 MO 檔的檔名不要更改。
如果下載後檔名變成 (1)、(2),請先手動改回正確名稱,再上傳到 Loco Translate。這個動作很小,但可以避免很多外掛中文化無法生效的問題。

