PO 翻譯檔上傳後若仍顯示英文,先檢查語系、檔名與儲存路徑。問題可能出在檔名、語系或儲存位置,暫時不必重新翻譯。
使用 Loco Translate 管理外掛翻譯時,PO/MO 檔名必須符合外掛的文字網域(text domain)與語系代碼。如果瀏覽器下載後自動把檔名改成 (1)、(2),直接拿去當正式語言檔,就可能無法按預期載入。
檔名正確後,還要確認載入條件。Loco Translate 官方目前也特別提醒:檔案存在哪裡會影響是否容易被 WordPress 或外掛更新覆蓋;JavaScript 介面的翻譯還可能需要 JSON 語言檔。
Loco Translate 的 PO 檔名為什麼重要?
WordPress 外掛翻譯常見命名方式是:
text-domain-locale.po text-domain-locale.mo
以 WooCommerce 的台灣繁體中文為例,常見檔名是:
woocommerce-zh_TW.po woocommerce-zh_TW.mo
woocommerce 是文字網域,zh_TW 是台灣繁體中文 locale。這兩部分必須跟外掛實際的翻譯載入方式一致。
各外掛的語言檔載入設定可能不同。除了檔名,也應核對 Loco Translate 的 bundle、text domain、locale 和檔案位置。
最常見錯誤:下載後變成 (1)、(2)
如果下載資料夾已經有同名檔案,瀏覽器常會自動改成:
woocommerce-zh_TW(1).po woocommerce-zh_TW(2).po
這只是瀏覽器避免覆蓋舊檔的命名方式,不代表它是 WordPress 預期的正式語言檔名。
如果這份檔案原本就應該是 woocommerce-zh_TW.po,上傳/部署前就應該先把 (1)、(2) 移除,恢復正確名稱。
不要把正式語言檔改成 fixed、new、修正版
在自己電腦做版本備份時,你可以用資料夾區分版本;但真正要放進 WordPress 翻譯路徑的檔案,不要隨意改成:
woocommerce-zh_TW-fixed.po woocommerce-zh_TW-new.po woocommerce-zh_TW-修正版.po
比較好的整理方式是:
WooCommerce 中文化/2026-09-09/woocommerce-zh_TW.po
也就是用資料夾管理版本,正式檔名維持 WordPress/外掛需要的格式。
比檔名更容易踩雷:翻譯檔存錯位置
Loco Translate 建立翻譯時,通常會看到 Author、System、Custom 等位置。這不只是整理方式不同,也關係到更新後翻譯會不會被蓋掉。
| 位置 | 風險 |
|---|---|
| Author/外掛自己的目錄 | 外掛更新可能直接覆蓋,通常不適合放自己的修改。 |
| System/WordPress 語言目錄 | WordPress 自動語言更新可能覆蓋。 |
| Custom | Loco 官方推薦用來保存自己的覆寫翻譯,較不容易被一般更新洗掉。 |
Loco Translate 的 Custom 位置目前位於:
wp-content/languages/loco/
如果你是在「修官方翻譯、改成台灣用語」這類自訂用途,Custom 通常比直接改外掛目錄安全。Loco 官方也明確建議避免直接編輯 Author 與 System 位置的檔案。
PO、MO、JSON 分別做什麼?
| 檔案 | 用途 |
|---|---|
| PO | 可編輯的翻譯來源,包含原文、譯文與相關資訊。 |
| MO | WordPress 傳統 PHP/Gettext 翻譯使用的編譯格式。 |
| JSON | WordPress JavaScript 國際化機制使用;許多現代外掛後台介面會用到。 |
Loco Translate 目前在儲存 PO 檔時,若 PO 裡有有效的 JavaScript 來源參照,可以依 WordPress 命名規則產生對應 JSON 翻譯檔。
所以「PO、MO 都有,為什麼還有英文?」不一定是翻譯壞掉,也可能是:
- 該文字來自 JavaScript,需要對應 JSON。
- PO 檔缺少正確的 JavaScript 來源參照。
- 新版外掛新增了尚未同步的字串。
- 實際載入的是另一個 text domain 或 locale。
- 自訂翻譯被官方/系統語言檔覆蓋。
Loco Translate 上傳 PO 檔後沒生效,照這 7 步檢查
- 確認語系。台灣繁體中文通常是
zh_TW。 - 確認 text domain。不要拿另一個外掛或錯誤網域的 PO 檔套用。
- 確認檔名。移除瀏覽器自動加上的
(1)、(2)等文字。 - 確認儲存位置。自己的覆寫翻譯優先使用 Loco Custom。
- 儲存後確認 MO/JSON 是否產生。
- 外掛更新後執行 Sync 前先看變更。新版可能新增或移除字串。
- 清除快取再測試。若網站有頁面快取、物件快取或瀏覽器快取,舊畫面可能暫時保留。
Loco Translate 的 Sync 可以按嗎?
可以,但要先理解它的用途。Sync 是把目前翻譯檔和外掛/佈景主題的翻譯模板重新同步,讓新版本新增的原文字串進來、移除已不存在的來源字串。
若有大量自訂翻譯,同步前先備份,並確認 Loco 使用的模板是否正確。同步本身不是「把所有中文刪掉」,但錯誤模板或錯誤操作仍可能讓翻譯檔變得混亂。
Elementor 中文化也會遇到同樣問題嗎?
會。尤其 Elementor 後台大量使用 JavaScript,只檢查 PO/MO 並不一定足夠。
如果你正在處理 Elementor 繁體中文,可直接看Elementor 中文化完整教學。目前更建議先更新 WordPress/Elementor 官方翻譯,真的有缺漏再用 Loco Custom 覆寫。
先確認正確命名:text domain+locale 少一個都可能失效
WordPress 外掛語言檔最常見的正式命名方式是:
text-domain-zh_TW.po text-domain-zh_TW.mo
其中:
- text domain:外掛在程式裡使用的翻譯網域。
- zh_TW:台灣繁體中文的 locale。
- PO:人可以閱讀、編輯的翻譯來源。
- MO:WordPress 傳統 Gettext 載入使用的編譯檔。
WordPress 官方 Plugin Handbook 目前仍以 my-plugin-{locale}.po、my-plugin-{locale}.mo 這種方式說明外掛翻譯命名。也就是說,如果外掛 text domain 是 solid-affiliate,台灣繁中檔案就應依它的實際載入規則使用 solid-affiliate-zh_TW 這類名稱。
確認檔名時,除了 zh_TW,也要檢查前面的 text domain。如果前半段 text domain 根本不是這個外掛實際使用的網域,一樣可能不載入。
為什麼瀏覽器加上的 (1)、(2) 特別容易害你誤判?
假設你下載了同一份翻譯三次,Mac 或瀏覽器可能自動留下:
solid-affiliate-zh_TW.po solid-affiliate-zh_TW(1).po solid-affiliate-zh_TW(2).po
後兩個檔名只是你電腦用來避免覆蓋同名檔案的版本標記,WordPress 並不知道 (1) 代表「新版」。
如果要把第二份檔案作為正式語言檔,應先確認它真的是你要的最新版,再把檔名恢復為外掛預期的正式名稱。需要保留歷史版本時,用資料夾或備份系統管理,而不是把版本號塞進正式語言檔名。
Author、System、Custom 差在哪?自己的翻譯優先放 Custom
Loco Translate 官方把 WordPress 會在更新過程中改寫的目錄視為不安全位置。包括外掛本身的語言目錄,以及 WordPress 管理的 wp-content/languages/plugins 等位置。
| 位置 | 比較適合做什麼 | 主要風險 |
|---|---|---|
| Author | 外掛作者隨套件提供的翻譯 | 外掛更新可能覆蓋 |
| System | WordPress 語言包 | 語言包更新可能覆蓋 |
| Custom | 自己長期維護的覆寫翻譯 | 相對不容易被一般更新洗掉 |
Loco 的 Custom 目錄通常位在 wp-content/languages/loco。如果你的目的是把官方翻譯改成更自然的台灣用語,或補一部分官方尚未翻譯的字串,把自己的差異留在 Custom,日後會比較好維護。
自訂翻譯應保留額外備份,避免只放在可能被更新覆蓋的外掛目錄。外掛一更新,最容易發生的不是翻譯「突然失效」,而是檔案真的被新版套件取代。
PO 上傳後要不要自己再做 MO?通常讓 Loco 儲存即可
PO 是可編輯來源,WordPress 傳統上真正載入的是編譯後 MO。使用 Loco Translate 正常儲存 PO 時,它可以同步產生對應的 MO,不需要每次另外打開其他軟體手動轉檔。
因此上傳後沒生效,可以檢查:
- PO 是否真的儲存在正確語系。
- 儲存後對應 MO 是否存在。
- 檔案路徑是否是這個外掛實際載入的位置。
- 伺服器是否有寫入權限問題。
若 Loco 顯示無法寫入,應先檢查目錄權限,避免不斷重試儲存。官方文件說明,這類情況往往是 WordPress/PHP 對該目錄沒有寫入權限,需要從主機端確認。
有 PO、MO 還是英文?JavaScript 介面可能需要 JSON
現代 WordPress 外掛很多後台畫面是 JavaScript 驅動。這些字串不一定只靠傳統 MO 載入,而可能使用 WordPress 的 JavaScript 語言包。
Loco Translate 目前支援從 PO 編譯 JSON;WordPress 官方 WP-CLI 也提供 wp i18n make-json,用 PO 產生 JavaScript 使用的 JSON 語言檔。
所以如果遇到:
- PHP 頁面已經是中文。
- 只有編輯器、彈窗或動態設定仍是英文。
- 同一外掛部分介面中文、部分英文。
此時可檢查未翻譯內容是否來自 JavaScript,而非一直重傳 MO 檔。
看到 .l10n.php 不用刪:新版 WordPress 可能正常使用它
新版 WordPress 已支援較高效能的 .l10n.php 翻譯格式。Loco Translate 的檔案系統文件目前也明確列出,它能處理 PO、POT、MO、JSON 與 l10n.php 等翻譯檔。
因此語言目錄裡同時看到:
plugin-zh_TW.po plugin-zh_TW.mo plugin-zh_TW-xxxx.json plugin-zh_TW.l10n.php
不代表翻譯重複或壞掉。一般站長不需要手動修改 .l10n.php;仍以 PO 作為主要翻譯來源,再由 WordPress/Loco 的正常流程產生需要的格式即可。
Loco Sync 正確用法:同步後先檢查,再 Save
外掛更新後新增了新字串,舊 PO 不會憑空知道。這時可以使用 Sync,讓目前 PO 和最新 POT/來源字串重新同步。
Sync 後常見三種結果:
- 新增字串:新版外掛新增加的原文。
- 移除字串:程式已經不再使用的舊原文。
- Fuzzy:原文有變化,但 Loco 判斷可能和舊字串相近。
Loco 官方目前的設定文件也保留 Fuzzy matching tolerance,代表 Sync 本來就會處理「舊字串和新字串相似但不完全相同」的情況。
按 Sync 並不代表要立刻 Save。先看新增、移除與 Fuzzy 是否合理,確認後才儲存,會比完全不敢同步安全,也比盲目同步後直接覆蓋更穩。
外掛更新後翻譯消失,用這個順序排查最快
- 確認 WordPress 網站/使用者語言仍是
zh_TW。 - 確認翻譯檔還存在,不是被外掛更新覆蓋。
- 確認檔名沒有多出
(1)、日期或「fixed」等文字。 - 確認 text domain 和外掛實際使用的一致。
- 確認自己的覆寫是否放在 Custom。
- 執行 Sync,查看新版是否增加字串。
- 確認 MO、JSON 是否正常產生。
- 清除 WordPress、CDN、瀏覽器與必要的物件快取。
- 用無痕視窗或重新登入後台再測。
依這個順序檢查,可以先排除檔名和語系問題,再查 JavaScript 與檔案權限,減少重做翻譯的風險。
「翻譯完成 100%」不代表最新版本一定 100% 中文
Loco 顯示 100%,只代表目前這份 PO 裡已存在的字串都有譯文。
它不保證:
- 這份 PO 已和最新版外掛完成 Sync。
- JavaScript JSON 已正確產生。
- 外掛 Pro 與 Free 使用的是同一個 text domain。
- 第三方附加元件也已翻譯。
- 你目前看到的英文真的來自這個語言檔。
所以「100% 但畫面有英文」時,先看來源字串是否最新,通常比在 PO 裡搜尋空白譯文更有效。
上傳 PO 檔前,先做這張 8 項檢查表
- 確認檔案來源可信且版本正確。
- 確認 text domain。
- 確認 locale 為
zh_TW。 - 移除瀏覽器自動加上的
(1)、(2)。 - 備份網站原本翻譯。
- 自己的覆寫優先放 Custom。
- 儲存後確認 MO/JSON 是否需要與是否產生。
- 清快取後到實際介面驗收,不只看 Loco 百分比。
只要這八項先確認,絕大多數「PO 明明上傳了卻沒中文」都能更快縮小問題範圍。
看到「譯文與譯文範本不相符,請執行同步」要怎麼辦?
這個提示通常表示:你目前這份 PO 的原文字串清單,和外掛最新版 POT/來源字串已經不完全一致。
常見原因包括:
- 外掛更新後新增了新功能與新字串。
- 舊版某些英文原文已修改。
- 部分字串已從程式移除。
- 你上傳的是較舊版本產生的 PO。
這時候可以執行 Sync,但不要把 Sync 理解成「一鍵修好所有翻譯」。比較安全的流程是:
- 先備份目前 PO。
- 執行 Sync。
- 查看新增字串。
- 查看被標記 Fuzzy 的舊譯文。
- 確認有沒有重要字串被移除。
- 補完或修正譯文後,再 Save。
如果同步後顯示翻譯完成率從 100% 降低,通常只是代表新版多了尚未翻譯的字串,不代表舊翻譯全部壞掉。
反過來,如果你永遠不 Sync,PO 就可能一直停留在舊外掛版本。即使畫面顯示 100%,新版介面新增的英文仍然不會出現在這份 PO 裡。
常見問題 FAQ
PO 檔變成 (1).po 可以直接上傳嗎?
若原本正式檔名不含 (1),建議先恢復正確名稱。瀏覽器加上的序號只是避免覆蓋本機同名檔,不是 WordPress locale 命名的一部分。
台灣繁體中文的語系代碼是什麼?
WordPress 常用的台灣繁體中文 locale 是 zh_TW。
自訂翻譯應該放 System 還是 Custom?
依 Loco Translate 官方目前建議,自己維護的覆寫翻譯優先放 Custom,因為 System 可能被 WordPress 的語言更新覆蓋。
有 PO、MO 為什麼還有英文?
現代 WordPress 外掛可能還使用 JavaScript JSON 翻譯;也可能是新字串尚未同步、text domain 不一致、locale 不對或翻譯檔沒有被實際載入。
Loco Translate Sync 會把我原本的翻譯全部刪掉嗎?
正常 Sync 的目的,是把 PO 和最新來源字串同步,不是清空所有譯文。同步後仍應先檢查新增、移除與 Fuzzy 字串,再決定是否 Save;重要自訂翻譯同步前也建議先備份。
結語:中文化沒生效,不要只盯著譯文
使用 Loco Translate 時,翻譯內容只是其中一層。檔名、text domain、locale、儲存位置、MO/JSON 與更新流程都會影響最後有沒有正確顯示。
如果下載後看到 (1)、(2),先恢復正確檔名;如果是自己修改台灣用語,優先放到 Custom 位置;如果介面仍有英文,再檢查 JSON 與新版字串。
把這幾個層級依序排除,會比一直重複上傳同一份 PO 檔有效得多。
參考資料
Loco Translate|Filesystem access|更新/查證日期:2026 年 10 月 6 日
Loco Translate|Plugin settings:Sync、MO/JSON 編譯與備份設定|更新日期:2026 年 9 月 30 日
WordPress Developer Resources|Localization – Plugin Handbook|查證日期:2026 年 10 月 6 日
WordPress Developer Resources|wp i18n make-json|查證日期:2026 年 10 月 6 日

