什麼是 PROPERTIES 檔案?
`.properties` 檔案是 Java 與 Spring 生態系中最經典的鍵值(Key-Value)設定檔格式,廣泛應用於應用程式參數配置、資料庫連線池設定與 i18n 國際化文字字典。
隨著現代雲原生架構與微服務技術演進,YAML 與 JSON 成為更主流的設定格式。本工具支援 Properties ⇄ JSON ⇄ YAML 多向自由互轉,支援點號嵌套展平、Unicode 中文字元轉義與多行轉義解析,極大簡化了 Spring Boot 設定檔的重構與遷移工作。
核心功能特點
多向無縫轉換
支援 Properties ➔ JSON、JSON ➔ Properties、Properties ➔ YAML 等 4 種常用模式。
Unicode 自動編解碼
自動識別 \uXXXX 中文編碼,可自選是否生成標準 ASCII 轉義字元。
巢狀樹狀結構支援
支援將 server.port 點號結構智慧展開為巢狀 JSON/YAML 物件。
純前端隱私安全
所有設定檔均於瀏覽器記憶體本地解析,零伺服器上傳,保護資料庫密碼。
常見問題 (FAQ)
1. 這個轉換器會將資料上傳到伺服器嗎?
絕對不會。我們非常重視您的資料隱私。所有的解析和轉換過程均在您的瀏覽器本機記憶體中完成,您的配置資訊(如資料庫密碼、API 金鑰等)絕不會外洩。
2. 轉換器支援 Unicode 轉義 (\uXXXX) 嗎?
支援。在由 Properties 轉 JSON 時,工具會自動將 `\uXXXX` 解碼為真實漢字;在由 JSON/YAML 轉回 Properties 時,可勾選「Unicode 轉義」按鈕自動將非 ASCII 字元編碼以適應老舊 Java 系統。
3. Properties 中的註解 (# 或 !) 會被保留嗎?
由於標準 JSON 格式不支援註解行,在轉換為 JSON 時以 `#` 或 `!` 開頭的註解行會被略過。
4. 支援巢狀結構的 JSON 轉 Properties 嗎?
支援。巢狀物件會被自動展平(Flattening),使用點號 `.` 作為層級連接符(例如 `{"db": {"host": "localhost"}}` 會自動轉換為 `db.host=localhost`)。
5. 如何將扁平的點號鍵展開為巢狀 JSON 物件?
在 Properties ➔ JSON 模式下,勾選頂部的「展開點號為巢狀物件 (Tree)」選項,工具便會將 `server.port=8080` 解析為 `{ "server": { "port": "8080" } }` 樹狀物件。
6. 支援以反斜線結尾的多行 Properties 值嗎?
完全支援。依照 Java 規範,行尾單個反斜線 `\` 會被識別為換行續行符號,解析器會將多行合併為單一完整字串。
7. 支援 INI 設定檔格式嗎?
支援基礎鍵值解析。標準 INI 的 `key=value` 鍵值對可直接貼入轉換,`[section]` 段落名稱會被略過或作為普通鍵值識別。
8. 能一鍵下載轉換後的設定檔嗎?
可以。點擊右側上方的「下載」按鈕,即可根據當前轉換模式自動產生並下載 `.properties`、`.json` 或 `.yaml` 本地檔案。