1. 導入：なぜpnpm patchが必要なのか
開発中に「利用しているライブラリにバグがある」「特定の挙動を少しだけ変えたい」という状況に直面したことはありませんか？通常、バグ修正はOSSのコントリビューターが対応するのを待つ必要がありますが、それでは納期に間に合わないこともあります。
そんな時、ライブラリをフォークして管理するのは大変な手間です。そこで役立つのが pnpm patch です。この機能を使えば、プロジェクト内でライブラリのコードを直接書き換え、その変更を永続的に保持することができます。まさに「外科手術」のような解決策です。
2. 基礎知識：pnpm patchの仕組み
pnpm patch は、ライブラリのソースコードを一時的なディレクトリに展開し、ユーザーが修正を加えた後、その差分（diff）をプロジェクト内の patches/ フォルダに保存する機能です。
インストール時に、pnpmはこのパッチファイルを読み込み、元のライブラリに対して自動的に修正を適用します。これにより、ライブラリをアップデートしても、修正内容が維持されるというメリットがあります。
3. 実装/解決策：パッチ適用の手順
具体的には、以下のステップで進めます。
1. ライブラリを一時的なディレクトリに展開して修正モードにする。
2. 展開されたコードを修正する。
3. 修正内容をパッチファイルとして保存する。
4. サンプルプログラム：実際にパッチを作成する手順
以下のコマンドを順にターミナルで実行してください。（ここでは例として example-package というライブラリを修正すると想定します）
1. ライブラリをパッチ適用可能な状態にする
pnpm patch example-package
(ターミナルに表示されたパスに移動して、コードを直接修正します)
例: cd /tmp/pnpm-patch-XXXXX/node_modules/example-package/dist/index.js
修正後、以下のコマンドでパッチを確定させます
2. 修正したディレクトリのパスを指定してパッチを作成
pnpm patch-commit /tmp/pnpm-patch-XXXXX/node_modules/example-package
実行後、プロジェクト直下の patches/example-package@1.0.0.patch が生成されます
3. 設定ファイル（package.json）に自動的に反映されているか確認
pnpmは自動的に package.json の pnpm.patchedDependencies に追記してくれます
{
“pnpm”: {
“patchedDependencies”: {
“example-package@1.0.0”: “patches/example-package@1.0.0.patch”
}
}
}
5. 応用・注意点：現場で陥りやすい罠
注意点1：修正はあくまで「緊急避難」であること
パッチを適用したまま放置すると、ライブラリのアップデート時に競合が発生したり、本来の修正が適用されなくなったりします。パッチを作成したら、必ず本家のリポジトリに対して Pull Request を送り、マージされたらパッチを削除するように運用しましょう。
注意点2：パッチの作成は慎重に
コードの修正範囲が広すぎると、ライブラリがアップデートされた際にパッチが当たらなくなる（パッチの失敗）リスクが高まります。修正は必要最小限に抑えるのが、長期的なメンテナンスのコツです。
pnpm patchは、開発のスピードを止めないための強力なツールです。困った時の外科手術として、ぜひ活用してみてください。
コメント