Loco Translate PO 檔上傳沒生效?檔名、zh_TW、MO/JSON 完整排錯

Loco Translate PO 檔排錯:PO 檔上傳後沒有生效,不一定是翻譯內容錯誤。WordPress 會同時依文字網域(text domain)、語系代碼(locale)、檔名、儲存位置與載入方式判斷翻譯;JavaScript 介面還可能需要 JSON。排錯時要先確認這些條件,再決定是否重做翻譯。

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 自動語言更新可能覆蓋。
CustomLoco 官方推薦用來保存自己的覆寫翻譯,較不容易被一般更新洗掉。

Loco Translate 的 Custom 位置目前位於:

wp-content/languages/loco/

如果你是在「修官方翻譯、改成台灣用語」這類自訂用途,Custom 通常比直接改外掛目錄安全。Loco 官方也明確建議避免直接編輯 Author 與 System 位置的檔案。

PO、MO、JSON 分別做什麼?

檔案用途
PO可編輯的翻譯來源,包含原文、譯文與相關資訊。
MOWordPress 傳統 PHP/Gettext 翻譯使用的編譯格式。
JSONWordPress JavaScript 國際化機制使用;許多現代外掛後台介面會用到。

Loco Translate 目前在儲存 PO 檔時,若 PO 裡有有效的 JavaScript 來源參照,可以依 WordPress 命名規則產生對應 JSON 翻譯檔。

所以「PO、MO 都有,為什麼還有英文?」不一定是翻譯壞掉,也可能是:

  • 該文字來自 JavaScript,需要對應 JSON。
  • PO 檔缺少正確的 JavaScript 來源參照。
  • 新版外掛新增了尚未同步的字串。
  • 實際載入的是另一個 text domain 或 locale。
  • 自訂翻譯被官方/系統語言檔覆蓋。

Loco Translate 上傳 PO 檔後沒生效,照這 7 步檢查

  1. 確認語系。台灣繁體中文通常是 zh_TW。
  2. 確認 text domain。不要拿另一個外掛或錯誤網域的 PO 檔套用。
  3. 確認檔名。移除瀏覽器自動加上的 (1)、(2) 等文字。
  4. 確認儲存位置。自己的覆寫翻譯優先使用 Loco Custom。
  5. 儲存後確認 MO/JSON 是否產生。
  6. 外掛更新後執行 Sync 前先看變更。新版可能新增或移除字串。
  7. 清除快取再測試。若網站有頁面快取、物件快取或瀏覽器快取,舊畫面可能暫時保留。

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外掛作者隨套件提供的翻譯外掛更新可能覆蓋
SystemWordPress 語言包語言包更新可能覆蓋
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 是否合理,確認後才儲存,會比完全不敢同步安全,也比盲目同步後直接覆蓋更穩。

外掛更新後翻譯消失,用這個順序排查最快

  1. 確認 WordPress 網站/使用者語言仍是 zh_TW。
  2. 確認翻譯檔還存在,不是被外掛更新覆蓋。
  3. 確認檔名沒有多出 (1)、日期或「fixed」等文字。
  4. 確認 text domain 和外掛實際使用的一致。
  5. 確認自己的覆寫是否放在 Custom。
  6. 執行 Sync,查看新版是否增加字串。
  7. 確認 MO、JSON 是否正常產生。
  8. 清除 WordPress、CDN、瀏覽器與必要的物件快取。
  9. 用無痕視窗或重新登入後台再測。

依這個順序檢查,可以先排除檔名和語系問題,再查 JavaScript 與檔案權限,減少重做翻譯的風險。

「翻譯完成 100%」不代表最新版本一定 100% 中文

Loco 顯示 100%,只代表目前這份 PO 裡已存在的字串都有譯文。

它不保證:

  • 這份 PO 已和最新版外掛完成 Sync。
  • JavaScript JSON 已正確產生。
  • 外掛 Pro 與 Free 使用的是同一個 text domain。
  • 第三方附加元件也已翻譯。
  • 你目前看到的英文真的來自這個語言檔。

所以「100% 但畫面有英文」時,先看來源字串是否最新,通常比在 PO 裡搜尋空白譯文更有效。

上傳 PO 檔前,先做這張 8 項檢查表

  1. 確認檔案來源可信且版本正確。
  2. 確認 text domain。
  3. 確認 locale 為 zh_TW。
  4. 移除瀏覽器自動加上的 (1)、(2)。
  5. 備份網站原本翻譯。
  6. 自己的覆寫優先放 Custom。
  7. 儲存後確認 MO/JSON 是否需要與是否產生。
  8. 清快取後到實際介面驗收,不只看 Loco 百分比。

只要這八項先確認,絕大多數「PO 明明上傳了卻沒中文」都能更快縮小問題範圍。

看到「譯文與譯文範本不相符,請執行同步」要怎麼辦?

這個提示通常表示:你目前這份 PO 的原文字串清單,和外掛最新版 POT/來源字串已經不完全一致。

常見原因包括:

  • 外掛更新後新增了新功能與新字串。
  • 舊版某些英文原文已修改。
  • 部分字串已從程式移除。
  • 你上傳的是較舊版本產生的 PO。

這時候可以執行 Sync,但不要把 Sync 理解成「一鍵修好所有翻譯」。比較安全的流程是:

  1. 先備份目前 PO。
  2. 執行 Sync。
  3. 查看新增字串。
  4. 查看被標記 Fuzzy 的舊譯文。
  5. 確認有沒有重要字串被移除。
  6. 補完或修正譯文後,再 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 日

元氣站長
元氣站長

經營網路事業,賺取持續收入!
網路賺錢修煉,成就理想人生!