2023年4月19日
diff-hlはファイルの差分をグラフィカルに表示してくれるパッケージです。
emacsのgitクライアントはmagitが最も有名です。magitはgitのコミットからプッシュまでのgitの操作が主体です。一方でdiff-hlはファイルの差分の表示がメインになります。ファイルの変更を確認したり、差分のハンクを移動したり、変更内容を確認できます。
こちらが完成済みのdiff-hlコードです。
(use-package diff-hl
:ensure t
:init
(global-diff-hl-mode)
(add-hook 'dired-mode-hook 'diff-hl-dired-mode)
(unless (window-system) (diff-hl-margin-mode))
:custom-face
(diff-hl-change ((t (:background "#8adf80"))))
(diff-hl-delete ((t (:background "#ff8f88"))))
(diff-hl-insert ((t (:background "#bfc9ff"))))
:config
(add-hook 'magit-pre-refresh-hook 'diff-hl-magit-pre-refresh)
(add-hook 'magit-post-refresh-hook 'diff-hl-magit-post-refresh))
設定の解説
global-diff-hl-mode
はグローバルでdiff-hlを利用する宣言です。
(add-hook 'dired-mode-hook 'diff-hl-dired-mode)
はemacsのdirモードで差分を表示します。C-x C-f
でファイルを開く代わりにディレクトリを開くと、このように差分が強調表示されます。![article image](https://prod-files-secure.s3.us-west-2.amazonaws.com/a3d79190-572a-4604-a045-8b27c534a5b2/68e54e81-dd52-424a-97b9-3a509d336004/dir.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAT73L2G45HZZMZUHI%2F20240727%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20240727T083058Z&X-Amz-Expires=3600&X-Amz-Signature=6344b80db334be8d1159ab25c0bb7c8a1ba4525b1b9c982fbc1227dd375c145b&X-Amz-SignedHeaders=host&x-id=GetObject)
(unless (window-system) (diff-hl-margin-mode))
はCUIモードでemacを使っている場合、左にマージンを用意してそこに差分情報を表示します。GUIの場合はEmacsのフレームに描画されるのでこの設定は必要ないので省いています。![article image](https://prod-files-secure.s3.us-west-2.amazonaws.com/a3d79190-572a-4604-a045-8b27c534a5b2/b06810f8-04a7-4068-8518-f2577997eb0e/highlight.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAT73L2G45HZZMZUHI%2F20240727%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20240727T083058Z&X-Amz-Expires=3600&X-Amz-Signature=ad1811f652a6ae236d65ce05edc40623dd031989ea2e742f9a23f043172f6b26&X-Amz-SignedHeaders=host&x-id=GetObject)
カスタムフェイスは好きな色を使って良いと思います。デフォルトの色は多少禍々しかったので、modus-themsのカラーをセットしています。
(diff-hl-change ((t (:background "#8adf80"))))
(diff-hl-delete ((t (:background "#ff8f88"))))
(diff-hl-insert ((t (:background "#bfc9ff"))))
diff-hlハンク移動
diff-hlはファイルの差分を移動できます。デフォルトで割り振られているキーバインドはやや難解ですが使えなくもありません。
"command diff-hl-next-hunk" C-x v ]
は差分のハンクを前に進みます。![article image](https://prod-files-secure.s3.us-west-2.amazonaws.com/a3d79190-572a-4604-a045-8b27c534a5b2/549b6ec3-bc4b-4415-bfa9-df455217ffa7/ahead.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAT73L2G45HZZMZUHI%2F20240727%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20240727T083058Z&X-Amz-Expires=3600&X-Amz-Signature=62a3582eb61b9df95fbdc752341804df92fa360dfcda04d4315219fbf54a1df5&X-Amz-SignedHeaders=host&x-id=GetObject)
"diff-hl-previous-hunk" C-x v [
はハンクを上に戻ります。![article image](https://prod-files-secure.s3.us-west-2.amazonaws.com/a3d79190-572a-4604-a045-8b27c534a5b2/e472746b-7d2f-49ee-8e87-db26367b8a81/behind.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAT73L2G45HZZMZUHI%2F20240727%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20240727T083058Z&X-Amz-Expires=3600&X-Amz-Signature=5b57e5364c495a941e9f006420ba5d45ed6514a96fb3e50bc51c1591184c7063&X-Amz-SignedHeaders=host&x-id=GetObject)
ハンクの変更状態を見る
ファイルを編集してしまうと、前の状態は
git diff
を実行しないと確認できません。
例えば、下の画像では、なんらかのhtmlが削除されていますが、何が削除されたか分かりません。![article image](https://prod-files-secure.s3.us-west-2.amazonaws.com/a3d79190-572a-4604-a045-8b27c534a5b2/7555c113-7df3-4173-a414-2ae7d67c6448/remove.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAT73L2G45HZZMZUHI%2F20240727%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20240727T083058Z&X-Amz-Expires=3600&X-Amz-Signature=a72d4258bc04b451239353300e463161f9ea91b1ec5839702709683edf7dad3a&X-Amz-SignedHeaders=host&x-id=GetObject)
目的のハンクでコマンドを実行することで編集前の状態を表示することができます。
カーソルをハンクのあたりに移動させて
"diff-hl-show-hunk" C-x v *
を実行します。![article image](https://prod-files-secure.s3.us-west-2.amazonaws.com/a3d79190-572a-4604-a045-8b27c534a5b2/cb07af00-056a-444a-ab52-c7690ff7cda8/show.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAT73L2G45HZZMZUHI%2F20240727%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20240727T083058Z&X-Amz-Expires=3600&X-Amz-Signature=13edcc1d069d8c513cbd6604d6ba99be6c8cac015242a853cffe9805b07be820&X-Amz-SignedHeaders=host&x-id=GetObject)
変更前の状態が表示されます。右下にdiff-hlが提供するキーが表示されています。
- 「n」と「p」は別のハンクに移動します
- 「c」は変更前のコードをkill-ringに保存します。
- 「r」は変更前ハンクを適応させます。
- 「q」はshow-hunk-modeを終了させます。
まとめ
magitとdiff-hlをうまく使うことで、emacsでのgit体験がずっと良くなるので試してみてください。
![profile image](/prof.jpg)
Ted
大学でコンセンサスアルゴリズムを研究。卒業後ベンチャー企業に入社してフルスタックでWebサービスを開発。現在は大手IT企業に転職し、プログラミングを行っている。AIにプログラマーの仕事を奪って欲しいと願っている。