git init した直後の git add で「warning: in the working copy of ‘…’, LF will be replaced by CRLF」が全ファイルに出る。原因は Git for Windows の gitconfig の core.autocrlf=true

結論

Git for Windows の本体側の設定(C:\Program Files\Git\etc\gitconfig)に core.autocrlf=true が入っていたのが原因でした。そのリポジトリだけ core.autocrlf false にして、git rm -r --cached . で登録し直したら警告は出なくなりました。

これまで git で管理していなかった Markdown のフォルダを、その場で git init してコミットしようとしたときの話です。自分では改行の設定をした覚えがないのに、全ファイルに警告が並びました。

症状

Git Bash で次のように初回のコミットをしました。

cd "<フォルダ>"
git init -q
git add -A
git commit -q -m "初回"

git add -A のところで、ファイルごとに次の警告が出ます。

warning: in the working copy of '00_使い方.md', LF will be replaced by CRLF the next time Git touches it
warning: in the working copy of 'AI検索・LLM流入への対応.md', LF will be replaced by CRLF the next time Git touches it
warning: in the working copy of 'WEBページ表示・装飾ガイド.md', LF will be replaced by CRLF the next time Git touches it
...

中身はどれも LF の改行で書いたファイルです。警告の言い方のとおり、次に git がこのファイルに触ったとき(チェックアウトなど)、作業フォルダ側の改行が CRLF に書き換わる、という意味です。

環境

項目 内容
OS Windows 11
git Git for Windows(Git Bash から実行)
対象 新しく git init したフォルダ(Markdown が十数ファイル、改行は LF)
自分の設定 パソコン全体(--global)の改行の設定はしていない

原因

まず、core.autocrlf がどこで決まっているかを --show-origin で調べました。

git config --show-origin core.autocrlf
file:C:/Program Files/Git/…/gitconfig   true

自分の ~/.gitconfig ではなく、Git for Windows 本体の gitconfig(system の設定)に true が入っていました。core.autocrlf=true のときは、チェックアウトで作業フォルダの改行を CRLF にします。そのため、LF で書いたファイルを add すると「次に触ったら CRLF にする」と警告されていました。

自分で設定した覚えがなくても、system の設定は全リポジトリに効きます。git config core.autocrlf だけでは値しか出ないので、出どころを見るには --show-origin が早いです。

解決手順

LF のまま置いておきたいフォルダだったので、そのリポジトリだけ設定を変えました(--global や system の設定は触っていません)。

  1. リポジトリの中で core.autocrlf を false にする。
git config core.autocrlf false
  1. 今の設定で add し直すため、index からいったん全部外す(作業フォルダのファイルは消えません)。
git rm -r -q --cached .
  1. もう一度 add してコミットする。
git add -A
git commit -q -m "初回"
  1. 確かめる。
git log --oneline
git ls-files | wc -l
git status --short

今回は、add で警告が出なくなり、git status --short も何も出ませんでした。ファイルの数(git ls-files | wc -l)も、フォルダの中身と合っていました。

ついでに、日本語のファイル名が \344\270... のような8進数で出ないよう、同じリポジトリに git config core.quotepath false も入れています。

再発防止・気づき

  • Windows で新しく git init したら、最初の git add の前に git config --show-origin core.autocrlf を見ておくと、警告の山に驚かずに済みます。
  • 設定は --global に入れず、リポジトリごとに入れました。CRLF にしたいリポジトリが他にあっても影響しません。
  • 同じタイミングで、コミットする人の名前とメールアドレスもパソコン全体には設定されていませんでした。新しいリポジトリでは git config user.name と git config user.email も先に確かめておくと、つまずきが減ります。

関連

この記事を書いた人

realine

Windows の PC で、MT5(MQL5)の EA・インジケーターの開発、WordPress のプラグイン開発とサイト運営、PowerShell・Python での作業の自動化をしています。このサイトには、その作業で実際につまずいたことと、効いた直し方を、確かめた環境と手順つきで残しています。

運営者情報と記事の作り方