Drupal 6/7/8/9/10 簡體中文語言包安裝全流程指南（含無模組離線導入法）

Drupal 簡體中文語言包安裝全流程指南

Drupal 核心採用「介面翻譯」機制，語言包為 .po 格式（Gettext 可攜對象）。本文覆蓋 Drupal 6 至 10 全版本，提供後台在線導入、離線手動導入、Drush 命令行、Composer 管理四種方式，並解決 Windows 環境、權限不足、緩存失效等常見坑點。

官方語言包下載源

• 統一入口：https://localize.drupal.org/translate/downloads
• 按版本篩選：選擇對應 Drupal 核心版本（6.x、7.x、8.x、9.x、10.x）
• 下載 Chinese, Simplified (zh-hans) 的 .po 文件

方法一：後台 UI 導入（通用標準流程）

1. 啟用 Locale 模組：
   • Drupal 6/7：Admin → Site building → Modules (admin/build/modules) 勾選 Locale
   • Drupal 8/9/10：Admin → Extend (/admin/modules) 勾選 Interface Translation（核心內建）
2. 添加語言：
   • 路徑：Admin → Configuration → Regional and language → Languages (/admin/config/regional/language)
   • 點擊 Add language，選擇 Chinese, Simplified (zh-hans)，保存
3. 導入翻譯：
   • 同頁面點擊 Import 標籤（或訪問 /admin/config/regional/translate/import）
   • 「Language file」選擇下載的 .po 文件
   • 「Import into」選擇 Chinese, Simplified
   • 點擊 Import，等待進度條完成
4. 設為預設語言：
   • 語言列表中將「Chinese, Simplified」行的 Default 勾選，保存
5. 清除緩存：
   • Drupal 6/7：Admin → Configuration → Performance → Clear all caches
   • Drupal 8+：Admin → Configuration → Development → Performance → Clear all caches 或 drush cr

方法二：Drush 命令行批量導入（適合自動化部署）

# 下載並導入簡體中文（以 Drupal 9/10 為例）
drush language-add zh-hans
drush language-import zh-hans /path/to/drupal-10.0.zh-hans.po
drush config-set system.site default_langcode zh-hans -y
drush cr

方法三：離線手動導入（無後台權限/斷網環境）

將 .po 文件放入對應目錄，Drupal 會自動掃描導入：

放置後訪問任意後台頁面觸發自動導入，或執行 drush locale-update。

方法四：Composer 管理語言包（現代項目推薦）

# 在 composer.json 專案中添加
"require": {
    "drupal/console": "~1.0",
    "drupal/language": "^1.0"  # 語言包管理工具
}
# 或直接下載官方打包語言文件
composer require drupal/zh-hans:^10.0  # 針對 Drupal 10

Windows 環境特別注意事項

• 路徑分隔符：Drush/Composer 命令使用正斜杠 /，PowerShell 下亦兼容
• 文件編碼：確保 .po 文件為 UTF-8 無 BOM，Notepad++ 另存時選「UTF-8」而非「UTF-8-BOM」
• 權限問題：sites/default/files 需 IIS_IUSRS / IUSR 寫入權限，否則導入失敗無報錯
• PHP 版本：Drupal 9+ 需 PHP 7.3+，Windows 建議用非線程安全（NTS）版 + PHP-FPM

進階：自定義翻譯與模組級語言包

• Potx 模組（drush dl potx）：掃描代碼生成 .pot 模板，導出自定義 .po，實現模組級、主題級翻譯管理
• Localization Client（drush dl l10n_client）：前端直接點擊文字編輯翻譯，所見即所得
• 翻譯更新自動化：drush language-update 定期同步社區最新翻譯

常見問題排查表

總結

Drupal 多語言核心機制穩定，Locale/Interface Translation 模組 + 官方 .po 文件 + 清緩存 是萬能公式。現代項目建議採用 Composer 管理 + Drush 自動化，將語言包納入版本控制，實現「基礎設施即代碼」。Windows 環境重點關注編碼、權限、路徑三大塊，即可無痛完成漢化。