メインコンテンツへ移動

こちらはMole Macの公式サイトですが、Windows版のサイトへ移動しますか?

Windows版サイトへ
Mole
MacWindows
機能 検証 評判 価格 FAQ ブログ
EnglishEN 简体中文中 繁體中文繁 日本語日 한국어한 FrançaisFR DeutschDE ItalianoIT EspañolES PortuguêsPT NederlandsNL
購入 ダウンロード

    ヘルプ、ドキュメント、リリース、記事

    ブログ

    Moleがnpm cache verifyよりキャッシュを多く残す理由

    開発者公開日 2026年10月5日更新日 2026年10月12日約5分で読めます

    最近、MoleでMacをメンテナンスしてもnpmのキャッシュが残り、自分で整理したら8 GBから2 GBになったという声が届きました。これをきっかけに、開発ツールのキャッシュを見直しました。まだ使う内容、参照を失った内容、ツール自身がすでに整理している内容を分けないと、次のビルドを遅くするだけになってしまいます。

    ここで紹介する調査と変更は10月5日のものです。これらの変更は Mole 1.16.0 で提供しています。

    npmのキャッシュが増え続ける理由

    npmの既定のキャッシュは~/.npm/_cacacheです。content-v2にパッケージやレジストリの応答を保存し、index-v5でリクエストと内容を対応付けます。ファイル名は内容のハッシュで、複数の索引項目が同じファイルを参照できます。

    パッケージ情報が変わると新しい応答が保存され、その後の検索で古い索引項目が整理されても、内容のファイルは残ることがあります。npmのドキュメントにも、キャッシュは自動でデータを削除せず、インストールとともに増えると書かれています。

    報告した方はすでに整理を終えていたため、実行前のコピーも、正確に使ったコマンドも確認できませんでした。8 GBから2 GBという数字は調査のきっかけであって、Moleが6 GBを回収した実測値ではなく、そのすべてが参照を失っていた証拠でもありません。

    今回のテストでverifyが削除した内容

    実験にはこのMacのキャッシュのコピーを使い、npm 11.19.1とcacache 20.0.4で確認しました。元のキャッシュは変更していません。作成から約1日、内容は309796162バイトで、何か月も使ったキャッシュとは違います。

    判定 内容ファイル数 内容のバイト数
    有効な索引項目のどれからも参照されない 1 614295
    npm cache verifyが実際に削除 6 25469972

    cacacheのverify実装は内容を整理し、整合性を確認して索引を再構築します。同じキーでは最後の項目を残しますが、以前の項目にも、別のリクエストが使う完全版や簡略版のメタデータが残っている場合があります。単純な新旧関係ではありません。

    コピーでverifyが削除したうち11199796バイトは、別のリクエスト形式の有効な項目から参照されていました。整理前はオフラインで読めたパッケージ情報の一部が、その後のオフラインnpm viewでENOTCACHEDになりました。オンラインなら再取得できますが、元のキャッシュでできていたことが変わっています。

    Moleでは有効な索引項目が一つでも参照していれば残します。このサンプルで見つかったのが約0.6 MBでも、verifyの数字に近づけるために使える内容まで消すことはしません。

    未参照のファイルをまとめて表示し、全体の削除は手動で選ぶ

    新しい実装が調べるのは既定の~/.npm/_cacacheだけです。参照がなく、1日より古い内容を開発ツールのグループに1行で表示し、既定で選択します。npmキャッシュ全体の削除には引き続き確認が必要で、重複する選択の容量は一度だけ数えます。

    npm installやnpm ciなど、キャッシュに書き込むコマンドが動いている間は、これらのファイルを削除候補に出しません。索引を読めない場合も表示せず、削除前に参照を再確認します。索引ファイルや一時ディレクトリは変更せず、Moleからnpmの整理コマンドを実行することもありません。

    索引が参照する内容を残しても、すべてのプロジェクトが常にオフラインでビルドできる保証にはなりません。ロックファイルはハッシュから直接パッケージを探すことがあり、非公開レジストリや古いバージョンが再取得できるとも限りません。ソース、ロックファイル、再生成できない成果物は別に保存する必要があります。カスタムのnpmキャッシュパスも今回の対象外です。

    Go、Cargo、pnpmは別々に判断する

    Goはすでにビルドキャッシュを自動で整理します。実装では直近5日間に使った項目を残し、1時間の余裕を加えた121時間を基準にします。Moleは以前、このディレクトリ全体を既定の整理対象にしていましたが、同じ時間基準に絞りました。直近の作業まで消して再コンパイルさせる必要はありません。

    Cargoにも自動キャッシュ回収があり、このサンプルには期限を過ぎた内容がありませんでした。以前、展開済みのレジストリソースを消したあと、約29時間後に約157 MBを再ダウンロードし、約1.06 GBを展開していました。Moleではこの領域に別の自動回収を追加していません。既存のクリーンアップ項目は、引き続き手動で選択できます。

    pnpmの共有ストアはさらに違います。調査したAPFSのサンプルでは、ハードリンク数から未使用を証明できず、その条件を移植するとストア全体が選ばれてしまいます。今回はpnpm用の回収処理を追加していません。この条件を使うには、そのファイルシステムでハードリンク数が実際の使用状況を表している必要があります。

    グローバルツールと古いXcodeプロジェクトのビルド成果物

    グローバルにインストールしたpake-cliには、約1.48 GiBのsrc-tauri/targetがありました。TauriをビルドしたRustの出力で、npmのダウンロードキャッシュではありません。有効なCACHEDIR.TAGが付いたこうしたビルドディレクトリも、確認が必要な項目として表示します。ツール本体やnode_modulesの依存関係は残し、Rustのビルド中は処理しません。

    Xcodeでは、記録されたプロジェクトパスが存在しないDerivedDataが24個、調査時点で約9 GiBありました。起動ディスク上でプロジェクトが消えたことを確認でき、Xcodeが対応するキャッシュを2週間以上使っていない場合だけ、ディレクトリ全体を削除候補に表示します。外付けドライブが未接続、読み取り権限がないという状態は、削除済みの証拠ではありません。この容量は調査時の結果で、すべてのMacで回収できる量ではなく、再びビルドすれば再生成にも時間がかかります。

    整理する前に、対象のキャッシュを確認する

    この読み取り専用コマンドで、カスタム設定も含めたnpmのキャッシュパスを確認できます。

    npm config get cache
    

    インストールやビルドが書き込んでいないことを確認してから、npm cache verifyを実行するか決めます。これは閲覧だけのコマンドではなく、実際にキャッシュを変更します。プロジェクトのnode_modulesやグローバルのコマンドは別の層で、このコマンドでは整理されません。全体の手順は開発ツールのキャッシュ整理にまとめています。

    Xcode、Docker、パッケージマネージャは使うほど容量を取ります。Mole で再作成できる開発キャッシュを整理し、残った大きなファイルは分析で探せます。

    Mole を試す

    続きを読む

    • 開発者ビルドを壊さずに開発者キャッシュを消す約6分で読めます
    • 開発者MacでPythonとNode.jsをアンインストールする方法約13分で読めます
    • 開発者Mac の JetBrains キャッシュ(IntelliJ、WebStorm、PyCharm)約6分で読めます

    Mole · 鼹

    Mac をすっきり軽快に

    v1.21.0 (388) · リリース

    製品

    Macクリーナー アプリアンインストーラ Macメンテナンス ディスク解析 システムモニター

    サポート

    ヘルプ ドキュメント リリース ブログ

    規約

    利用規約 プライバシーポリシー 返金ポリシー

    リソース

    Windows版 CLIツール ストレージ価格換算 アフィリエイトプログラム

    その他のアプリ

    Yado 宿 Pake 殼 MiaoYan 語 Kaku 書

    つながる

    Twitter hi@mole.fit

    Moleの公式サイトはここだけ mole.fit、提供元が不明なインストーラはダウンロードしないでください

    ターミナル向けのCLIは、これからも無料です。