批處理腳本國際化解決方案：輕量級多語言架構設計與實戰落地

Windows 批處理腳本雖屬輕量級自動化利器，卻長期缺乏體系化的多語言支援。本文基於面向對象「分離變與不變」原則，設計並實現一套純腳本、零依賴、可復用的批處理國際化框架，涵蓋語言檢測、資源抽象、鍵值存儲、動態加載全鏈路。

架構設計：三層解耦模型

+------------------------+
|    程序內核層           |  業務邏輯，零語言硬編碼
|  (Batch Core Logic)    |  依賴抽象層 API：getMessage(key)
+-----------+------------+
            | 依賴倒置
+-----------v------------+
|    多語言抽象層         |  語言解析器、鍵值映射、存儲適配
|  (Message Abstraction) |  實現：getMessageFactory.bat
+-----------+------------+
            | 動態加載
+-----------v------------+
|    多語言外殼層         |  具體語言文件、Key=Value 存儲
|  (Message Resources)   |  格式：message_zh-CN.txt, message_en-US.txt
+------------------------+

核心組件實現

1. 系統語言檢測 getLocale.bat

@echo off
rem 讀取註冊表用戶語言設置
for /f "skip=4 tokens=3" %%i in ('reg query "HKCU\Control Panel\International" /v "sLanguage"') do (
    set reg_localevar=%%i
)
rem 映射為標準語言代碼
call Keys_v2.bat %reg_localevar%, nlvmapping.txt, %~1

語言映射表 nlvmapping.txt

DEU=de
ENU=en-US
ESN=es
FRA=fr
ITA=it
JPN=ja
KOR=ko
PTB=pt-BR
CHS=zh-CN
CHT=zh-TW

2. 統一入口工廠 getMessageFactory.bat

@echo off
set varimp=""
call Keys_v2.bat getMessage, sysconfig.txt, varimp
if not "%varimp%"=="" goto executeMessage

rem 兜底：當前目錄尋找第一個 *getMessage.bat
for %%i in (*getMessage.bat) do (
    set varimp=%%i
    goto executeMessage
)

:executeMessage
call %varimp% %~1 %~2

3. 系統語言路由 sysgetMessage.bat

@echo off
set key0=%~1
set varlocale=""
call getLocale.bat varlocale

set varimp=""
call Keys_v2.bat getMessageImp, sysconfig.txt, varimp
if not "%varimp%"=="" goto executeMessageImp

for %%i in (*getMessageImp.bat) do (
    set varimp=%%i
    goto executeMessageImp
)

:executeMessageImp
call %varimp% %key0% %varlocale% %~2

4. 文件存儲適配器 filegetMessageImp.bat

@echo off
set key=%~1
set varlocale=%~2
set filename=message_%varlocale%.txt

rem 回退機制：找不到對應語言用英文
if not exist %filename% set filename=message_en-US.txt

call Keys_v2.bat %key%, %filename%, %~3

5. 通用鍵值解析器 Keys_v2.bat

@echo off
set key=%~1
set file=%~2

for /F "eol=; tokens=1,* delims==" %%i in (%file%) do (
    if "%%i"=="%key%" (
        set "%~3=%%j"
        goto :eof
    )
)

語言資源文件規範

message_zh-CN.txt

System_detect_begin=系統檢測開始
System_detect_GraphUI_normal=系統檢測圖形界面是否正常
System_detect_over=系統檢測完畢
Failed=操作失敗，請聯繫管理員
Success=操作成功
Continue=繼續
Quit=退出

message_en-US.txt

System_detect_begin=System detection started
System_detect_GraphUI_normal=Checking if graphical UI is normal
System_detect_over=System detection completed
Failed=Operation failed, please contact administrator
Success=Operation successful
Continue=Continue
Quit=Quit

業務腳本接入示例

接入前（硬編碼）

echo "系統檢測開始"
...
echo "系統檢測圖形界面是否正常"
...
echo "系統檢測完畢"

接入後（抽象層依賴）

set msg=""
call getMessageFactory.bat "System_detect_begin", msg
echo %msg%

...

set msg=""
call getMessageFactory.bat "System_detect_GraphUI_normal", msg
echo %msg%

...

set msg=""
call getMessageFactory.bat "System_detect_over", msg
echo %msg%

系統配置 sysconfig.txt

getMessage=sysgetMessage.bat
getMessageImp=filegetMessageImp.bat

快速構建多語言批處理系統清單

1. 建立基準語言文件 message_en-US.txt
2. 業務腳本全面改造：提取字面量 → 分配 Key → 調用 getMessageFactory → 寫入基準文件
3. 配置 sysconfig.txt 指定實現策略
4. 翻譯生成各語言文件 message_zh-CN.txt、message_ja.txt 等
5. 測試驗證：修改系統語言或臨時設置 varlocale 變量

方案優勢與局限

總結

這套方案在不引入 Python/PowerShell/Java 等外部運行時的前提下，為批處理腳本注入了企業級國際化能力。其核心價值在於：用最樸素的批處理語法，實踐了現代軟件工程的分層、抽象、工廠、策略等經典模式。對於維護大量legacy批處理系統、跨國部署自動化腳本的團隊，具有極高的實際落地價值。