Dockerコンテナ内でGitを使っている際に、日本語コミットメッセージが文字化けする問題に相対した際の解決方法をまとめました。以下の手順を実行することで解決できます。

問題の現象

解決手順

まず、Dockerコンテナ内のロケールを確認します。

echo $LANG

正常な状態では、次のように en_US.UTF-8 や ja_JP.UTF-8 が返されます。

その他の値が返された場合は、以下のようにロケールをUTF-8に設定しましょう。

export LANG=C.UTF-8

これで一時的にロケールがUTF-8に設定されます。

この状態で、日本語コミットメッセージを再度試してください。

git commit --allow-empty -m "テスト用の日本語メッセージ"
git log

これで文字化けが解決されていることを確認しましょう。

Dockerコンテナを再起動しても設定が保存されるようにするため、次の手順で .bashrc に追記します。

.bashrc に追記

echo 'export LANG=C.UTF-8' >> ~/.bashrc

これで、次回コンテナを再起動しても文字化けが発生しなくなります。

Gitコミット時にNanoが開いた際、日本語が文字化けする場合は、Nano自身でUTF-8を正しく扱えていないことが原因です。下記手順で解決できます。

Nanoが古いバージョンの場合、UTF-8のサポートが不完全なため、アップデートが必要です。

apt update && apt install -y nano

Nanoでの問題が解決しない場合、Gitのデフォルトエディタを vim や code に変更することで解決できます。

git config --global core.editor "code --wait"

Dockerコンテナ内で日本語コミットメッセージが文字化けする問題は、ロケールの設定やエディタの変更で解決できます。同様の問題に相対している方の参考になれば幸いです。