gettext · po · mo · engine · tutorial
如何翻譯遊戲的 .po 和 .mo 檔案(gettext)
.po 是可編輯的原始檔,.mo 才是遊戲實際載入的已編譯目錄,這就是僅修改 .po 卻毫無效果的原因。RuneTranslate 同時讀取兩者,保護 %s 和 {count} 預留位置,依你的語言調整複數形式,並寫回一個可用的 .mo。
如果你開啟一個遊戲資料夾,發現裡面有個裝滿 .po 與 .mo 檔案的 locale 目錄,那麼這個遊戲是用 gettext 做在地化的。而 RuneTranslate 現在可以把它從頭到尾翻譯完,從建立專案一路到匯出可玩的版本。
本文會說明這兩種檔案到底是什麼、為什麼你改了看得懂的那一個,遊戲裡通常毫無變化,以及該怎麼正確地翻譯它們。
.po 與 .mo:幾乎人人都會踩的差別
它們是同一份語言檔的兩種形態:
- `.po`:Portable Object。可以用任何編輯器開啟的純文字檔。每筆記錄包含
msgid(原文)與msgstr(譯文)。譯者實際編輯的就是這個檔案。 - `.mo`:Machine Object。同樣內容的已編譯二進位版本,結構讓遊戲能瞬間查到某個字串。執行中的遊戲讀取的就是它。
最後這一點,常讓人白白浪費一個下午。你可以把 .po 的每一行都翻完、儲存、啟動遊戲,卻看不到任何變化,因為遊戲根本不會開啟 .po。它載入的是旁邊那個 .mo,裡面還是舊的文字。通常你得用 GNU gettext 工具裡的 msgfmt,把前者編譯成後者。RuneTranslate 兩個都會寫出,所以不需要額外的編譯步驟。
gettext 遊戲的資料夾長什麼樣子
標準結構是一個依語言代碼劃分的 locale 目錄:
MyGame/game.exeMyGame/locale/en/LC_MESSAGES/mygame.moMyGame/locale/fr/LC_MESSAGES/mygame.moMyGame/locale/de/LC_MESSAGES/mygame.mo
LC_MESSAGES 資料夾是慣例的一部分,不是打錯字;mygame 則是文字網域,也就是遊戲載入字串時所請求的名稱。不少遊戲改用更扁平的結構,例如 lang/fr.po,一樣可以運作。
哪些遊戲在用 gettext?
gettext 源自 Unix 世界,後來成為 C、Python 以及所有以 GTK 為基礎的軟體做在地化的預設方式。落到遊戲上,就是:
- Python 與 pygame 遊戲
- Solarus、SDL 及其他 C/C++ 引擎
- 透過 Poedit、Weblate 或 Crowdin 做在地化的遊戲,它們都原生支援 PO
- 部分 Godot 專案,可以把 PO 當作翻譯來源
它在歐美獨立遊戲中遠比日式遊戲常見,像 Kirikiri 和 RPG Maker 這類日系引擎,都把文字存放在各自的格式裡。
用 RuneTranslate 翻譯 gettext 遊戲
- 把 RuneTranslate 指向遊戲資料夾。 也就是含有
locale/、lang/或i18n/的那一個。辨識依據是檔案的實際位元組而非副檔名,所以實際上是 3D 場景的.mo會被忽略,不會產生壞掉的專案。 - 查看概要。 在你確認建立專案之前,會看到語言檔數量、已編譯
.mo與原始.po的比例、遊戲已內建哪些語言,以及字串總數。 - 選擇語言與翻譯服務。 可選免費的 Google 或 DeepL,或你自己的 DeepL、OpenAI、Claude、DeepSeek 金鑰,詳見翻譯服務比較。
- 校對後匯出。 你會得到一份譯文已就位的完整遊戲副本。
悄悄毀掉 gettext 翻譯的兩件事
預留位置。 msgid 是格式字串,不是寫死的成品文字。Hello, %s! 會在執行階段把玩家名字代入。機器翻譯常常會刪掉 %s、在它旁邊加空格,或者遇到 Python 的具名形式 %(player)s 時,連裡面的單字也翻掉。後果不只是外觀問題:少一個 %s,後面所有參數都會整個錯位,多數引擎會直接當機。RuneTranslate 會在文字送往翻譯服務之前,先把找到的每個預留位置(%s、%d、%(player)s、{count}、{0})遮蔽起來,翻完再還原。
複數形式。 英文有兩種(「1 coin」/「5 coins」),日文和土耳其文只有一種,俄文和波蘭文有三種。語言檔會在檔頭宣告自己用幾種;一旦這個數字與語言對不上,gettext 就會越過清單的末端,然後無聲無息地退回未翻譯的原文。RuneTranslate 會依你的目標語言重新調整這些形式,並相應改寫檔頭。
為什麼匯出會把語言檔寫兩次
匯出既會產生一個標準的新語言目錄 locale/<你的语言>/LC_MESSAGES/,也會產生遊戲原本就在載入的那個語言檔的更新版本。
真正讓譯文顯示出來的是後者。遊戲如何決定要載入哪種語言,從資料夾裡看不出來:它可能讀取作業系統語言、某個設定檔、啟動器參數,或乾脆寫死在程式碼裡。替一個只會請求英文的遊戲加上繁體中文語言檔,你拿到的會是一個看起來毫無變化的版本。直接覆寫它確實會載入的那個語言檔,就省去了這層猜測。兩者都只發生在匯出的副本中,你原本的遊戲資料夾不會被修改。
你尚未翻譯的條目會保留遊戲原有的譯文,所以做到一半的專案絕不會清空開發者自己的在地化內容。
它做不到的事
只有已經存在於語言檔中的文字才能被翻譯。如果開發者把某個字串直接寫死在程式碼裡,沒有經過 gettext,那它既不在 .po 也不在 .mo 裡,任何 PO 工具都找不到它。這是格式本身的限制,不是工具的限制。
RuneTranslate 也會把 msgid 視為原文,這正是 gettext 自己的慣例。少數專案讓 msgid 保持英文,真正的來源語言放在 msgstr 裡;這類專案會從英文開始翻譯。
最後,如果遊戲跑在 RuneTranslate 直接支援的引擎上,像是 Godot、Unity、Ren’Py,那就交給該引擎處理,這樣遊戲其餘的文字也能一併取得。Godot 遊戲的 .po 語言檔是例外:Godot 這條路徑會讀取它的 CSV 翻譯表,但暫時還不讀取 .po。
分享之前
啟動匯出的版本,讀上幾個畫面。選單和按鈕是最快的檢查點,因為語言檔裡的文字大多出現在那裡。如果哪裡不對,例如遊戲沒被辨識出來、匯出的版本打不開,或文字仍是原本的語言,請透過應用程式的說明選單或 Discord 回報。下載 RuneTranslate,開啟你的第一個語言檔。
準備好試用 RuneTranslate 了嗎?
免費方案即可解鎖全部引擎 + 除 RuneLingua 外的全部翻譯供應商。Supporter($3.99/mo)解鎖全速翻譯。
下載 Windows、Mac 和 Linux 版
