こんな状況に遭遇したことはありませんか？コンピュータの容量を節約するために、pnpmのstoreを外付けHDDに設定していたのに、ある日HDDを持ってくるのを忘れたり、保存場所を変えようとしたら、pnpmがディレクトリが見つからないというエラーを吐き始めたことは？HDDを挿し直しても何かおかしい？

これは実はpnpm独自の動作原理に関連しています。今日はpnpmの「Store」メカニズムと、それが「接続不能」になったときの救出方法についてお話ししましょう！

そもそもpnpmはどうやってスペースを節約しているの？

修正を始める前に、pnpmのスペース節約の魔法を簡単に復習しておきましょう。

各プロジェクトの node_modules にパッケージの完全なセットをコピーするnpmとは異なり、pnpmは Content-addressable store (コンテンツアドレス指定ストレージ) と Hard Links (ハードリンク) を使用します。

pnpmの仕組みは、すべてのパッケージファイルが実際にはコンピュータ内の 「巨大な倉庫」 にのみ存在し、プロジェクトディレクトリはこの倉庫へのリンクを持っているだけということです。これにより、ハードディスク容量を節約できるだけでなく、インストールも驚くほど高速になります。

なぜ外付けHDDがpnpmのエラーを引き起こすのか？

ローカルSSDの容量を節約するためにpnpm storeを外付けHDDに設定すると、潜在的な落とし穴が現れます：

このような状況に遭遇した場合、手動で「校正」する必要があります。

解決策1：校正し、Storeパスを再設定する

ストアの場所を変更することにした場合、最も直接的な方法は、新しいストアがどこにあるかをpnpmに伝えることです。次のコマンドを使用できます：

pnpm config set store-dir <新しいディレクトリパス>

例えば、pnpm storeをユーザーのホームディレクトリ下の ~/.pnpm-store に設定する場合：

pnpm config set store-dir ~/.pnpm-store

現在のストア設定がどこかわからない場合は、まず照会できます：

pnpm store path

設定が完了すると、pnpmは今後どこからパッケージを取得すればよいかがわかります。

解決策2：最初からやり直し、リンクを再構築する

パスを変更した後でも、プロジェクトに古い残留エラーが残っている場合があります。このとき、「最初からやり直す」のが通常最も効果的な治療法です：

これにより、最新の設定に基づいて、pnpmがストアからプロジェクトへ正しいリンクを強制的に引き直します。

どう配置するのが最もスムーズか？

異なる環境を行き来することが多かったり、外付けHDDの不安定さが心配な場合、理想的な構成はこれです：pnpm storeはローカルSSDに置き、プロジェクトコードを外付けHDDに置くことができます。

なぜでしょうか？ストアは通常それほど頻繁に変更されず、容量はあるものの、各プロジェクトに分散した総和はnpmよりはるかに小さいからです。ストアを安定したローカルパス（例：macOSのデフォルト ~/Library/pnpm/store）に保つことで、外付けHDDがなくても他の場所で新しいプロジェクトをスムーズに初期化できます。

この Stateless（ステートレス） な開発コンセプトにより、開発環境がより柔軟になります！

結論：Storeを安定させることが手間を省く

pnpm store管理の鍵は「安定性」という言葉にあります。パスの問題に遭遇した場合は、次のように対処できます：

この記事が、皆さんがpnpmのパスの落とし穴から抜け出し、高速開発の楽しさを享受する助けになれば幸いです！

Reference

• Configuring | pnpm