1. 導入: なぜGOMODCACHEの掃除が必要なのか
Goで開発を続けていると、無意識のうちにディスク容量が圧迫されることがあります。その主犯格が「GOMODCACHE」です。Goは依存ライブラリをダウンロードする際、キャッシュとしてローカルに保存しますが、プロジェクトが増えるごとに古いバージョンや不要なライブラリが蓄積され、数十GBに達することも珍しくありません。本記事では、安全かつ効率的にキャッシュをクリーンアップする方法を解説します。
2. 基礎知識: GOMODCACHEとは
GOMODCACHEは、Goモジュールがダウンロードしたソースコードを保存しておくディレクトリです。デフォルトでは「$GOPATH/pkg/mod」に配置されます。Goは一度ダウンロードしたモジュールをここに保持することで、他のプロジェクトで同じライブラリが必要になった際にネットワーク通信をスキップし、ビルドを高速化しています。しかし、開発ツールやCI環境で古いモジュールが残り続けると、ディスク容量を浪費するだけでなく、意図しない古いバージョンの参照トラブルを招くリスクもあります。
3. 実装/解決策: 安全なクリーンアップ手順
単にフォルダを削除することも可能ですが、パーミッション制限があるファイルが含まれている場合や、現在進行中のプロジェクトで使用中のファイルがある場合は注意が必要です。Go公式が提供するコマンドを利用するのが最も安全です。
具体的には「go clean -modcache」コマンドを使用します。これにより、GOMODCACHEディレクトリ内のすべてのキャッシュが安全に削除されます。
4. サンプルプログラム: クリーンアップ自動化スクリプト
以下のシェルスクリプトは、現在のキャッシュサイズを確認してから削除し、削除後の空き容量を表示する実用的なスニペットです。
!/bin/bash
GOMODCACHEのパスを取得（設定されていない場合はデフォルトパス）
CACHE_DIR=$(go env GOMODCACHE)
echo “— クリーンアップ前のキャッシュサイズ —”
du -sh $CACHE_DIR
echo “キャッシュを削除中…”
go cleanコマンドで安全にキャッシュを削除
go clean -modcache
削除結果の確認
if [ $? -eq 0 ]; then
echo “成功: キャッシュの削除が完了しました。”
else
echo “エラー: 削除に失敗しました。パーミッションを確認してください。”
fi
echo “— クリーンアップ後のキャッシュサイズ —”
du -sh $CACHE_DIR
5. 応用・注意点: 現場で陥りやすい罠
実務で運用する際は、以下の点に注意してください。
削除後のビルド時間: キャッシュを削除すると、次回ビルド時にすべての依存ライブラリをネットワーク経由で再ダウンロードする必要があります。CI環境で頻繁に実行するとビルド時間が大幅に延びるため、定期実行する場合は注意が必要です。
パーミッションの問題: 特定のディレクトリに書き込み権限がない場合、管理者権限（sudo）を求められることがあります。ディレクトリの所有者が自分であることを確認してください。
環境変数の確認: 「go env GOMODCACHE」コマンドを実行し、意図したディレクトリが指定されているか必ず確認してください。誤ったパスを削除しないよう、コマンド実行前の確認は必須です。
ディスク容量不足によるビルドエラーを未然に防ぐため、定期的なクリーンアップを開発ルーチンに組み込むことを推奨します。
コメント