native2ascii 工具使用指南：Properties 文件編碼轉換必備

什麼是 native2ascii？

native2ascii 是 JDK 自帶工具 (JAVA_HOME/bin/native2ascii)，用於**本地編碼 (如 UTF-8、GBK) 與 ASCII (Unicode 轉義 \uXXXX) 互轉**。主要解決 Java Properties 配置文件僅支援 ISO-8859-1 (Latin-1) 的歷史限制。

常用參數

典型使用場景

1. 開發階段：中文 Properties → ASCII (提交版控)

native2ascii -encoding UTF-8 messages_zh.properties messages.properties
# 輸出: key=\u4f60\u597d

2. 除錯/閱讀階段：ASCII → 中文 (人類可讀)

native2ascii -reverse -encoding UTF-8 messages.properties messages_zh.properties
# 輸出: key=你好

3. 管道流式處理

cat messages_zh.properties | native2ascii -encoding UTF-8 > messages.properties

為什麼 Properties 強制 ASCII？

• Java 早期設計假設配置文件僅含 Latin-1 字符
• 為跨平台一致性，規範要求非 ASCII 必須用 \uXXXX 轉義
• 現代 IDE (IntelliJ/Eclipse) 會自動雙向轉換，**通常無需手動呼叫**

Maven/Gradle 整合自動化

<!-- Maven resources plugin 可配置 encoding，避免手動轉換 -->
<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-resources-plugin</artifactId>
  <configuration>
    <encoding>UTF-8</encoding>
  </configuration>
</plugin>

常見問題

• 執行報錯「找不到命令」：確認 JAVA_HOME/bin 在 PATH 中
• 轉換後中文亂碼：檢查 -encoding 是否與源文件實際編碼一致
• YAML/JSON 也需轉換嗎？：不需要，它們原生支援 UTF-8