Git は、開発者がプロジェクトのファイル履歴を管理するのに役立つ強力なバージョン管理システムです。時には、Git が追跡したくないファイルがリポジトリにキャッシュされることがありますが、ローカルディレクトリには保持しておきたい場合があります。 git rm --cached コマンドを使用すると、作業ディレクトリにファイルを保持したまま、Git の追跡システムからファイルを削除できます。このチュートリアルでは、このコマンドを効果的に使用して、リポジトリをクリーンアップし、ワークフローを最適化する方法を説明します。
Git からキャッシュされたファイルを削除する方法を理解するために、まずいくつかのファイルを含むサンプルリポジトリを設定しましょう。これにより、Git のキャッシングが実際にどのように機能するかを確認できます。
git add コマンドを使用してファイルを Git に追加すると、Git はこれらのファイルをインデックス (ステージングエリアとも呼ばれます) に保存します。これらのファイルは現在「キャッシュ」またはステージングされており、リポジトリにコミットされるのを待っています。ローカルファイルシステムからファイルを削除せずに、これらのファイルのステージングを解除したり、Git の追跡から削除したりしたい場合があります。
作業用のシンプルな Git リポジトリを作成しましょう。
cd ~/projectmkdir git-cache-demo
cd git-cache-demogit init次のような出力が表示されるはずです。
Initialized empty Git repository in /home/labex/project/git-cache-demo/.git/git config user.name "LabEx User"
git config user.email "labex@example.com"これで、ファイルを追加する準備ができた新しい Git リポジトリができました。次のステップでは、いくつかのファイルを作成し、Git の追跡システムに追加します。これにより、後でキャッシュから削除する練習をすることができます。
Git リポジトリを設定したので、いくつかのファイルを作成し、Git の追跡システムに追加しましょう。これにより、ファイルが Git で「キャッシュ」されることの意味を理解できます。
## Create a text file
echo "This is a sample text file" > sample.txt
## Create a config file
echo "debug=true" > config.ini
## Create a log file (which we typically don't want to track)
echo "2023-01-01: System started" > app.loggit status次のような出力が表示されるはずです。
On branch master
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
app.log
config.ini
sample.txt
nothing added to commit but untracked files present (use "git add" to track)これは、Git が認識しているファイルが 3 つあるものの、まだ追跡されていないことを示しています。
git add .git statusこれで、次のように表示されるはずです。
On branch master
No commits yet
Changes to be committed:
(use "git rm --cached <file>..." to unstage)
new file: app.log
new file: config.ini
new file: sample.txtGit が、git rm --cached <file> を使用してファイルのステージングを解除できることを教えていることに注意してください。ファイルは現在 Git のステージングエリアにキャッシュされており、コミットされるのを待っています。
git commit -m "Initial commit with sample files"これで、Git の追跡システムにファイルを正常に追加できました。次のステップでは、ローカルディレクトリにファイルを保持したまま、Git のキャッシュから特定のファイルを削除する方法を学びます。
Git によって追跡されているファイルがあるので、ローカルディレクトリにファイルを保持したまま、Git の追跡から特定のファイルを削除する方法を学びましょう。これは、ログファイル、一時ファイル、または機密情報を含むファイルなど、除外する必要があるファイルを誤ってコミットした場合によく必要になります。
Git のキャッシュからファイルを削除する理由はいくつかあります。
.gitignore ファイルを設定していて、すでに追跡されているファイルを削除する必要があるapp.log ファイルを Git で追跡すべきではないことに気づいたとしましょう。
git ls-files3 つのファイルすべてがリストに表示されるはずです。
app.log
config.ini
sample.txtapp.log を Git の追跡システムから削除しましょう。git rm --cached app.log確認メッセージが表示されます。
rm 'app.log'git statusapp.log が追跡されていないファイルとしてリストされていることがわかります。
On branch master
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
deleted: app.log
Untracked files:
(use "git add <file>..." to include in what will be committed)
app.logこれは、Git が次のコミットでファイルの追跡を停止することを意味しますが、ファイルはまだローカルディレクトリに存在します。
ls -laapp.log がまだそこにあることがわかるはずです。
git commit -m "Remove app.log from Git tracking"git ls-filesこれで、次だけが表示されるはずです。
config.ini
sample.txtただし、app.log ファイルはまだローカルディレクトリに存在します。
cat app.log出力：
2023-01-01: System startedおめでとうございます！ローカルディレクトリにファイルを保持したまま、Git のキャッシュからファイルを正常に削除しました。次のステップでは、複数のファイルを処理し、.gitignore を使用してワークフローを改善する方法を学びます。
Git のキャッシュから単一ファイルを削除する方法がわかったので、複数のファイルやディレクトリ全体を削除するなど、より複雑なシナリオを検討しましょう。
まず、練習用にさらにいくつかのファイルとディレクトリ構造を作成しましょう。
## Create a directory for temporary files
mkdir temp
## Create some files in the temp directory
echo "This is a temporary file" > temp/temp1.txt
echo "Another temporary file" > temp/temp2.txt
## Create another log file in the main directory
echo "2023-01-02: System updated" > system.loggit add .git commit -m "Add temporary files and system log"git ls-files次のように表示されるはずです。
app.log
config.ini
sample.txt
system.log
temp/temp1.txt
temp/temp2.txt次に、すべてのログファイルと temp ディレクトリ全体を Git の追跡から削除するとします。
git rm --cached system.loggit rm --cached -r temp/ここで -r フラグは重要です。これは、Git にディレクトリ内のすべてのファイルをそのキャッシュから再帰的に削除するように指示します。
git statusログファイルと temp ディレクトリ内のすべてのファイルの両方が、Git の追跡システムからの削除のためにステージングされていることがわかります。
On branch master
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
deleted: system.log
deleted: temp/temp1.txt
deleted: temp/temp2.txt
Untracked files:
(use "git add <file>..." to include in what will be committed)
system.log
temp/git commit -m "Remove logs and temp directory from Git tracking"git ls-filesこれで、次だけが表示されるはずです。
app.log
config.ini
sample.txtただし、すべてのファイルはまだローカルディレクトリに存在します。
ls -la
ls -la temp/ファイルを Git の追跡から削除したので、誤って再び追加されないように、.gitignore ファイルを設定しましょう。
.gitignore ファイルを作成します。nano .gitignore## Ignore log files
*.log
## Ignore temp directory
temp/保存して終了します (Ctrl+X、次に Y、次に Enter を押します)。
.gitignore ファイルを追加してコミットします。
git add .gitignore
git commit -m "Add .gitignore file"これで、すべてのファイルを Git に追加しようとしても、.gitignore ファイルが尊重され、指定されたパターンは追跡されません。
git add .
git statusログファイルと temp ディレクトリが Git の追跡に追加されていないことがわかります。
これで、Git のキャッシュから複数のファイルとディレクトリを削除する方法、および .gitignore ファイルを使用して特定のファイルが将来追跡されないようにする方法を学びました。
Git のキャッシュからファイルを削除する基本を理解したので、ワークフローを改善するための高度なテクニックとベストプラクティスをいくつか見ていきましょう。
Git によってすでに追跡されているファイルがあり、追跡から削除し、.gitignore ファイルに追加したい場合は、この効率的なアプローチを使用できます。
## Create a build directory with some compiled files
mkdir build
echo "Compiled binary data" > build/app.bin
echo "Configuration for build" > build/build.confgit add build/
git commit -m "Add build files temporarily".gitignore ファイルを 1 つのワークフローで更新しましょう。## First, edit the .gitignore file to add the build directory
echo "## Ignore build directory" >> .gitignore
echo "build/" >> .gitignore
## Now remove the tracked files from Git's cache
git rm --cached -r build/
## Commit both changes together
git add .gitignore
git commit -m "Remove build directory from tracking and add to .gitignore"git ls-files
ls -la build/パスワードや API キーなどの機密情報を含むファイルを誤ってコミットした場合、Git のキャッシュから削除することは最初のステップにすぎません。Git はすべてのコミットの履歴を保持しているため、機密情報はまだリポジトリの履歴に存在します。
機密情報については、以下を行う必要があります。
git filter-branch や BFG Repo-Cleaner などのツールを使用して、履歴から機密データを削除することを検討するこれはこのチュートリアルの範囲を超えていますが、この制限を認識しておくことが重要です。
従うべきベストプラクティスを次に示します。
プロジェクトの早い段階で適切な .gitignore ファイルを作成する: これにより、不要なファイルが誤って追跡されるのを防ぎます。
一般的なパターンにはグローバル .gitignore ファイルを使用する: すべてのリポジトリに適用されるグローバル .gitignore ファイルを設定できます。
git config --global core.excludesfile ~/.gitignore_globalgit add . に注意する: このコマンドは、追跡されていないすべてのファイルを追加します。可能な場合は、git add <file> のようなより具体的なコマンドを使用します。
コミット前に変更を確認する: 常に git status と git diff --cached を使用して、コミットしようとしている内容を確認します。
一般的な操作にはエイリアスを使用する: たとえば、キャッシュされたファイルを削除するためのエイリアスを設定できます。
git config --global alias.uncache 'rm --cached'次に、次のように使用できます。
git uncache <file>これらのテクニックとベストプラクティスを使用すると、クリーンで効率的なリポジトリを維持するために、Git のキャッシュを効果的に管理する方法を包括的に理解できるようになりました。
このチュートリアルでは、git rm --cached コマンドを効果的に使用して、ローカルディレクトリにファイルを保持しながら、Git の追跡システムからファイルを削除する方法を学びました。達成した内容は次のとおりです。
git rm --cached を使用して、Git のキャッシュから個々のファイルを削除しました。-r) を使用して、複数のファイルとディレクトリを管理しました。.gitignore を使用して、不要なファイルが追跡されるのを防ぎました。これらのスキルは、クリーンで効率的な Git リポジトリを維持し、不要なファイルの追跡を防ぎ、機密情報を保護するのに役立ちます。Git がどのファイルを追跡するかを適切に管理することで、一時ファイル、ログ、ビルド成果物を無視しながら、重要なコードと設定ファイルに集中できます。
Git のキャッシュからファイルを削除しても、ローカルファイルシステムからファイルが削除されるわけではないことに注意してください。Git に追跡を停止するように指示するだけです。これは、リポジトリの内容を管理し、必要なファイルのみがプロジェクトの履歴に含まれるようにするための強力なツールです。
