difft 命令

常用示例

说明

difft (Difftastic) is a structural diff tool that understands programming language syntax. Unlike line-based diff tools, it parses source code and compares the actual structure, showing meaningful changes while ignoring formatting differences. The tool builds abstract syntax trees (ASTs) for both versions of a file, then computes the minimal structural difference. This means it can recognize when code is moved or refactored without treating it as completely different, and it won't flag changes that are purely whitespace or formatting. Difftastic supports over 50 programming languages with dedicated parsers built using tree-sitter. For unsupported files, it falls back to a text-based diff. Language detection is automatic based on file extension, but can be overridden. The side-by-side display shows old and new versions in parallel columns with colors indicating additions (green), deletions (red), and modifications. The inline display shows changes in a more compact format. Git integration allows using difft as the external diff tool.

参数

--display _mode_

Output format: side-by-side, side-by-side-show-both, inline (default).

--language _lang_

Force a specific language parser (auto-detected by default).

--list-languages

Show all supported languages.

--skip-unchanged

Don't show unchanged parts of the file.

--context _n_

Number of context lines (default: 3).

--width _n_

Maximum display width (default: terminal width).

--color _when_

Color output: always, never, auto.

--background _type_

Background color: light, dark (default: dark).

--syntax-highlight _on|off_

Enable or disable syntax highlighting.

--tab-width _n_

Tab display width (default: 4).

--parse-error-limit _n_

Maximum number of parse errors before falling back to text diff.

--byte-limit _n_

Skip files larger than this size.

--graph-limit _n_

Maximum graph size for structural diff algorithm.

--exit-code

Set exit code to 1 if there are syntactic changes (useful in scripts).