Difftastic

產品說明

Difftastic 是一款革命性的命令列 (CLI) 差異比對工具，專為程式開發者設計。與傳統 diff 工具基於「行 (Line-based)」的文字比對邏輯不同，Difftastic 能夠「理解」程式碼的語法結構。

它利用 Tree-sitter 解析器將程式碼轉換為語法樹 (Syntax Tree)，然後針對結構進行比對。這意味著它可以分辨出哪些是真正的邏輯修改，哪些僅僅是格式上的調整（例如：換行、縮排或加上括號）。對於重構 (Refactoring) 或多人協作時常遇到的格式衝突，Difftastic 能大幅減少視覺雜訊，讓開發者專注於真正重要的程式碼變更。

核心特色：

• 語法感知 (Structural Diffing)：能識別函數、變數、巢狀結構的修改，而非機械式地標記整行增刪。
• 忽略格式雜訊：自動忽略不影響邏輯的空白、換行或縮排改變。
• 廣泛語言支援：內建支援超過 30 種主流程式語言（包括 Rust, Python, JavaScript, Java, C++, Go 等）。
• Git 整合：可輕鬆設定為 Git 的預設外部 diff 工具，提升 git diff 的閱讀體驗。
• 智慧顯示：支援並排 (Side-by-side) 與行內 (Inline) 兩種顯示模式，並具備語法高亮功能。

常用指令

Difftastic 的執行檔名稱通常為 difft。它可以獨立使用，也常被整合進 Git 流程中。

基礎比對操作

# 比對兩個檔案的差異 (自動偵測語言)
difft file_v1.rs file_v2.rs

# 指定顯示模式為「並排顯示」 (Side-by-side)
difft --display=side-by-side file_v1.py file_v2.py

# 強制指定語言解析 (例如將 .txt 視為 JSON 解析)
difft --language=json config.txt config_new.txt

Git 整合 (推薦用法)

將 Difftastic 設為 Git 的外部 diff 工具，能讓你在執行 git diff 時直接享受結構化比對的效果。

# 暫時性使用 (僅本次指令)
GIT_EXTERNAL_DIFF=difft git diff

# 永久性設定 (修改 .gitconfig)
git config --global diff.external difft

# 或者，透過 alias 建立專屬指令 (例如 git dft)
git config --global alias.dft "diff --ext-diff=difft"

使用小技巧：
如果你發現 Difftastic 在處理某些超大檔案時速度較慢，可以加上 --skip-syntax-highlighting 參數來提升效能，或者回頭使用傳統的 diff 工具來處理該特定檔案。

操作介面

下圖模擬了 Difftastic 在終端機中的顯示效果。請注意，它不會因為你只是多加了一個換行就把整個 function 標示為紅色刪除/綠色新增，而是精準地指出內部邏輯的變化。