2つのテキストを比較

何を同じ行とみなすか

比較は、行そのものではなくキーに対して行われます。各行は、オンになっている無視のオプションに従ってキーに変換され、差分はキーどうしで計算されます。そして表示されるのは常に元のテキストです。 そのため「大文字・小文字を区別しない」をオンにすると、どの行が一致するかは変わりますが、表示される内容は1文字も変わりません。空白に関するオプションは2つあり、その違いはラベルから想像するより大きなものです。一方は行の両端を削るだけで、もう一方はまず連続するスペースやタブを1つのスペースにまとめてから両端を削ります。どちらも空白を完全に取り除くわけではありません。また、まとめる対象は文字どおりのスペースとタブだけなので、行の途中にある全角スペースやノーブレークスペースはそのまま残り、違いとして扱われます。

空行を無視するオプションには、誰も触れない副作用があります。空行は比較を始める前に取り除かれるため、結果の横に表示される行番号は残った行だけを数えたものになり、ファイル上の行番号と一致しなくなります。オプションがオフなら完全に一致します。変更された行の中での単語単位のハイライトは、大文字・小文字を区別しない設定にだけ従い、それ以外には影響されません。空白のオプションはここには及ばないため、別の理由で変更された行の中にある空白の違いは、変更として色付けされます。

コピーできる結果は、読むうえで重要な点ではすべてunified diffそのものです。2つのファイルヘッダー、マイナス行、プラス行、各変更の前後3行のコンテキストが含まれます。ただし、頼る前に知っておきたい例外が1つあります。ハンクのマーカーに行範囲が含まれていないため、バグ報告、コードレビューのコメント、メール向けであり、patchコマンドやgit applyコマンドでは受け付けられません。読むためではなく適用するためのものが必要なら、gitで作成してください。

ほかの目的には

構造化された形式は行単位ではうまく比較できず、その失敗は目立たないどころか一目瞭然です。キーの順番が違うだけの2つのJSON文書や、列が1つ移動しただけの2つのCSVは、何も分からない変更の山として返ってきます。そうしたものは構造を理解するツールで比較しましょう。先に両方のJSONファイルのキーを並べ替えてから結果を比べるか、daffを使ってください。daffはCSVを行と列として比較し、すべての行が変わったではなく、列が移動したと教えてくれます。

2つのディレクトリや、リポジトリの履歴上の2つの時点を比べるのは、このページではなくgitの役目です。また、段落の改行位置が変わった文章では、行単位の表示はそもそも粒度が合っていません。git diff --word-diffなら改行の位置を無視して、移動した単語だけを表示します。文書が再整形されたときに本当に必要なのは、この比較です。