git add が「fatal: pathspec ‘…?’ did not match any files」で全部失敗する。while read で読んだ一覧の行末 \r が原因(Git Bash)

Git Bash で、ファイル一覧のテキストを while read で1行ずつ読んで git add したら、116 本すべてが失敗しました。ファイルはちゃんとあるのに、です。

原因は一覧の行末に残っていた \r(CRLF の CR)でした。エラー文のパスの最後に付いている ? がその印です。

読んだ行から \r を落とす f="${f%$'\r'}" を1行足したら、116 本とも通りました。

症状

コミットしたいファイルの一覧を commit_list.txt に書き出し、それを1行ずつ git add するループを回しました。

while IFS= read -r f || [ -n "$f" ]; do
  [ -z "$f" ] && continue
  git add -- "$f" >/dev/null 2>"$TEMP/ga.err" || echo "FAIL $f: $(head -1 $TEMP/ga.err)"
done < commit_list.txt

結果は全部 FAIL。エラーはこうです(ファイル名は例に置き換えています)。

fatal: pathspec 'docs/設計書_v1.0.md?' did not match any files
fatal: pathspec 'tools/tb_restore.ps1?' did not match any files

最初は git add ... 2>/dev/null でエラーを捨てていたので、FAIL <パス> しか見えず、何が悪いのか分かりませんでした。エラーを出すようにして初めて、パスの末尾に ? が付いていることに気づきました。

ややこしかったのは、切り分けのつもりで1行だけ取り出して試したときです。

f=$(sed -n 2p commit_list.txt); git add -- "$f"; echo rc=$?
# rc=0

こちらは通ってしまいました。なので「一覧のパスは正しいのに、ループのときだけ失敗する」ように見えました。

環境

  • Windows 11
  • Git Bash(Git for Windows)
  • ファイル一覧は Windows 上で、Python のスクリプトで書き出したもの

原因

一覧の各行が \r\n で終わっていて、read -r は \n までしか取らないので、変数 f の最後に \r が残っていました。

git add -- "docs/設計書_v1.0.md\r" を頼んでいることになるので、そんな名前のファイルは無い、と言われます。エラー文では、表示できない \r が ? になって出ていました。

読み方 末尾の \r 結果
while IFS= read -r f 残る pathspec '...?' did not match
while ...; f="${f%$'\r'}" 取れる 通る(116/116)

解決手順

  1. ループの中で、読んだ直後に行末の \r を取り除く。

bash
n=0; fail=0
while IFS= read -r f || [ -n "$f" ]; do
f="${f%$'\r'}"
[ -z "$f" ] && continue
if git add -- "$f" >/dev/null 2>&1; then n=$((n+1)); else fail=$((fail+1)); echo "FAIL $f"; fi
done < commit_list.txt
echo "added=$n fail=$fail"

  1. 登録できた数を確かめる。

bash
git diff --cached --name-only | wc -l

今回は added=116 fail=0、git diff --cached --name-only も 116 になりました。

|| [ -n "$f" ] は、最後の行に改行が無いときにその行を取りこぼさないためのものです。\r の件とは別ですが、一覧を読むループには付けておくと安心です。

再発防止・気づき

  • エラーを 2>/dev/null で捨てない。今回は stderr を出した瞬間に ? が見えて、すぐ原因に近づけました。
  • パスの最後に ? が付いたエラーを見たら、まず行末の \r を疑う。od -c で行末を見れば \r が見えます(行の頭だけ見ても分からないので、行末まで出すこと)。
  • 1行だけ取り出して試すと通る、ということもありました。ループでしか起きないときこそ、ループの中で printf '[%s]\n' "$f" のように変数をそのまま出して確かめるのが早いです。

関連

この記事を書いた人

realine

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

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