error: the following file has local modifications:の原因と対処法

2022年3月24日2023年7月17日

git rmコマンドでファイル削除を行おうとしたところ、「error: the following file has local modifications:」のエラーメッセージが表示されました。

本記事では、このエラーの原因と対処法について解説しています。同じエラーで躓いている人はぜひこちらの記事を参考ください。

Gitの学習におすすめ書籍

改訂2版わかばちゃんと学ぶ Git使い方入門

総合評価

( 5 )

メリット

楽天ブックス

¥2,453 （2025/02/18 14:28時点 | 楽天市場調べ）

ポチップ

先輩くん

Amazon Kindle Unlimitedに登録すると、月額980円で読み放題だからオススメだよ！

後輩ちゃん

初回30日間は無料だから、まだ登録したことのない人はぜひ試してみてね！

全プログラマー必見！
変数名/関数名にもう悩まない！

リーダブルコード

総合評価

( 5 )

メリット

著:Dustin Boswell, 著:Trevor Foucher, 解説:須藤功平, 翻訳:角征典

¥2,640 （2023/07/23 02:48時点 | Amazon調べ）

ポチップ

エラーの原因

git rm test.txt 
error: the following file has local modifications:
    test.txt
(use --cached to keep the file, or -f to force removal)

「error: the following file has local modifications:」のエラーメッセージは、削除対象のファイルはワークツリー(自分のローカル環境)で変更されているため削除できないみたいです。

(use --cached to keep the file, or -f to force removal)
# このオプションを付けてください！という親切なアドバイスです

エラーメッセージに記載があった通り、「–cached」「-f or force」のオプションを付けることでファイルを削除することができます。

オプション	説明
–cached	リポジトリからの削除 ※ワークツリーのファイルは削除されない
-f –force	最新のチェックを上書き

git rm --cached ファイル名

git rm -f ファイル名
git rm --force ファイル名