DiffVault文字工具

比對 · 格式化 · 驗證 — 在瀏覽器離線完成

不必把文字送到任何地方,就能比對、整理與驗證

貼上兩份文字、一份 JSON 文件、YAML 檔、CSV 表格或 SQL 查詢。DiffVault 會標出新增、刪除與變更的行,並進一步指出變更的字元,也能輸出標準 unified 補丁。同一個頁面可將 JSON 縮排或壓縮、正規化 YAML、依欄排序或轉換 CSV 分隔符、重新排版 SQL,並以 JSON Schema 驗證、回報問題的確切行與列。沒有帳號、沒有上傳、沒有伺服器呼叫,一切都在這個分頁中完成。

模式 文字 · JSON · YAML · CSV · SQL比對 行 + 字元層級網路 工具本身 0 次請求

比對

  • 0新增
  • 0刪除
  • 0變更

在兩側貼上文字,或載入範例,即可看到比對結果。

功能

一頁就有的功能

不需伺服器,這個工具能做到的六件事。

比對

行與字元層級比對

新增、刪除與變更的行會同時標在兩側,變更的行再以字元層級強調,長句中的一個詞修改也能一眼看出。

檢視

左右對照或整合檢視

可在兩欄對齊檢視與附 @@ 標頭的整合串流之間切換,兩種檢視都出自同一份比對結果,數字不會互相矛盾。

JSON

語意式 JSON 比對

開啟語意模式後,兩份文件都會被解析,鍵值排序後重新序列化,屬性順序或縮排不同不再造成假差異。

格式

格式化與壓縮

JSON 支援 2 或 4 空格縮排與壓縮;YAML 以 2 空格重新縮排並整理冒號、清單符號與註解;CSV 可依欄排序並在逗號、定位字元、分號、直線之間轉換;SQL 則將關鍵字改為大寫並依子句換行。

驗證

附行、列位置的錯誤

JSON 語法錯誤會指出確切位置。加上 JSON Schema 可檢查必填欄位、型別、數值範圍、字串長度、樣式與陣列長度;CSV 則逐列比對欄數是否與標頭一致。

輸出

補丁下載與複製

可將比對結果下載為含標準 hunk 標頭的 .diff 補丁,或與格式化結果一起用一次點擊複製到剪貼簿。

使用方式

免設定的四個步驟

工具只有一個頁面,以下每個步驟都在你的裝置上完成。

01

選擇模式

挑選文字、JSON、YAML、CSV 或 SQL。模式只改變選項與範例,不會動到輸入內容。

02

貼上兩個版本

左邊是原始版本,右邊是變更後的版本,也可以先載入範例看看效果。

03

比對並調整

行層級標記會立即出現。若格式差異不是重點,可開啟忽略空白、忽略大小寫或語意式 JSON。

04

帶走結果

複製或下載整合補丁,或把同一份文字移到格式化與驗證分頁繼續處理。

支援範圍

各模式理解什麼

只有一套比對引擎,各模式再加上符合格式的額外功能。

模式比對格式化 / 壓縮驗證
文字行與字元差異、空白與大小寫選項——
JSON鍵值排序後的語意比對,或原文比對縮排 2、縮排 4、壓縮語法錯誤的行與列,JSON Schema:必填、型別、範圍、長度、樣式、enum、items
YAML可忽略縮排差異的行比對重新以 2 空格縮排,整理冒號、清單符號與註解—
CSV列與儲存格比對依欄排序(遞增、遞減),分隔符轉換:逗號、定位字元、分號、直線逐列比對欄數與標頭,未關閉的引號
SQL語句比對關鍵字大寫、依子句換行與縮排—

格式化與驗證刻意保守:只整理呈現方式並回報能確認的問題,不會改寫字串常值或註解。

運作原理

比對結果是怎麼產生的

先對行求最長共同子序列,再比對變更行內部的詞元,兩個階段。

第一階段先去掉前後完全相同的部分,再對行求最長共同子序列,得出未變、刪除與新增三種狀態。刪除行後面緊接新增行時會合成一個變更,修改不會散落到好幾行。

第二階段看進變更行的內部:找出兩行的共同前綴與後綴,再比對剩下的詞與空白,只標出真正移動的字元。這就是長句中只改一個詞時,只有那個詞被強調的原因。

忽略空白與忽略大小寫只改變比對用的鍵值,不會改變畫面上顯示的文字。語意式 JSON 模式會解析兩側,並以鍵值排序的形式重新序列化,讓鍵的順序與縮排不再列入比較。

行比對 最長共同子序列字元比對 前綴、後綴 + 詞元 LCS補丁 unified hunk、前後 3 行內容限制 極大輸入改用位置對齊,並在畫面說明

常見問題

問題與解答

我貼上的文字會傳到伺服器嗎?

不會。比對、格式化與驗證都由這個頁面的 JavaScript 執行,工具中沒有 fetch、XHR 或 beacon 呼叫,可在瀏覽器的網路面板確認。只有頁面開頭的廣告指令碼是從外部載入。

可以語意式比對 JSON 嗎?

開啟語意模式即可。兩份文件都會被解析、鍵值排序後以標準形式比對。若其中一側不是有效 JSON,工具會說明,並改以純文字比對,不會擅自猜測。

.diff 下載內容是什麼?

是 unified 補丁:--- 與 +++ 標頭、@@ -起始,數量 +起始,數量 @@ 形式的 hunk,以及前後 3 行內容。純文字格式,任何編輯器都能開啟,也能用常見的 patch 工具套用。開啟語意 JSON 時,補丁是以鍵值排序後的標準形式產生,請套用在那份內容而非原始檔案上。

驗證的位置有多精確?

JSON 語法錯誤直接採用剖析器回報的行與列。結構描述錯誤會指向出問題數值的鍵位置,並同時顯示如 $.customer.age 的路徑,即使欄位稍有偏移也不會漏掉問題。

有輸入大小限制嗎?

沒有伺服器端限制,實際上限取決於裝置記憶體。行配對超過約四百萬組時會改用較簡單的位置對齊,只顯示前 4,000 行,並在畫面說明。

產生的補丁可以直接提交嗎?

補丁是標準 unified diff 文字,可用常見工具套用。但 a/original 與 b/changed 只是預留標籤,請先對好路徑、確認套用結果再提交。驗證是實用檢查,不是正式認證。

誠實的限制

這個工具不做的事

不是 YAML 或 SQL 剖析器

YAML 正規化只重新縮排與整理文字,不解析錨點、標籤或多文件串流。SQL 格式化是把關鍵字與子句結構排得易讀,並非理解方言的剖析,特殊語法的間距可能不理想。

結構描述只支援實用子集

會檢查 required、type、properties、items、enum、minimum、maximum、排他邊界、字串長度與 pattern。$ref、條件式結構描述、allOf/anyOf/oneOf 與自訂 format 不支援。

沒有檔案上傳或資料夾存取

文字以貼上或輸入提供。這讓工具能離線運作,也代表極大的檔案更適合用桌面比對工具處理。

驗證不是保證

在此通過的文件,仍可能被規則更嚴格的 API 拒絕,格式化也無法修好無效的輸入。請務必保留原始檔案。

輸出遵循的標準

  • Unified diff — --- / +++ 標頭、@@ hunk、前後 3 行內容
  • JSON — RFC 8259 語法,以及上述 JSON Schema 關鍵字
  • CSV — 逗號、引號與換行的 RFC 4180 引用規則
  • 隱私 — 不上傳、免帳號、無分析,設定只存在 localStorage