Node.jsと比べて分かるPythonパッケージ管理のクセ

最近はNode.jsとPythonの両方を触る人も増えてきましたが、実際に開発してみると「同じパッケージ管理なのに、ずいぶん感覚が違うな」と感じる場面が多いのではないでしょうか。
結論から言うと、Node.jsのパッケージ管理は「プロジェクト単位で完結する設計」が強く、Pythonは「環境全体との関係を意識せざるを得ない設計」になっています。この違いを理解せずにPythonを使うと、思わぬところでハマりやすいです。

この記事では、Node.jsと比較しながら、Pythonのパッケージ管理に特有のクセや考え方を具体例つきで整理します。単なる概念説明ではなく、「実際にやるとこうなる」「ここで失敗しがち」という視点を重視します。

Node.jsとPythonのパッケージ管理の前提の違い

Node.jsでは、npmやyarn、pnpmなどを使って依存関係を管理するのが一般的です。
特徴的なのは、依存関係が基本的にプロジェクトディレクトリ配下のnode_modulesに閉じている点です。

一方、Pythonではpipを使うことが多いですが、こちらは少し事情が異なります。pipは「Python環境」に対してパッケージをインストールします。
つまり、プロジェクトではなく、Pythonそのものにひも付く形になりやすいのです。

この前提の違いが、後々の混乱の種になります。

Node.jsは「このフォルダの中だけ見ればいい」

Node.jsの世界では、次のような流れが当たり前です。

npm install

これを実行すると、package.jsonとlockファイルを元にnode_modulesが作られます。
重要なのは、他のプロジェクトやシステム全体に影響を与えにくいことです。

• 別プロジェクトの依存関係と衝突しにくい
• node_modulesを消せばほぼ初期状態に戻せる
• CIやDockerでも再現性を確保しやすい

この「フォルダ単位で完結する感覚」が、Node.jsのパッケージ管理の分かりやすさにつながっています。

Pythonは「どのPythonに入れたか」を常に意識する

Pythonで次のコマンドを実行したとします。

pip install requests

このとき、requestsは「今使っているPython環境」にインストールされます。
ここで言うPython環境とは、システムPythonなのか、venvなのか、pyenvで切り替えたPythonなのか、といったものです。

つまり、同じpip installでも、

• どのPythonに対して実行したのか
• どの環境が有効になっていたのか

を正しく把握していないと、意図しない場所にパッケージが入ります。

仮想環境が前提になるPythonのパッケージ管理

Pythonでは、仮想環境（venvやvirtualenv）を使うのがほぼ前提になっています。
これはNode.jsと比べると、少し手間に感じる部分かもしれません。

なぜPythonでは仮想環境が必要なのか

Pythonのパッケージ管理が環境単位になっているため、仮想環境を使わないと次のような問題が起きやすくなります。

• プロジェクトAで必要なバージョンと、プロジェクトBで必要なバージョンが衝突する
• システム全体のPython環境が壊れる
• どのプロジェクトがどのライブラリを使っているか分からなくなる

Node.jsではnode_modulesが自然にこの役割を果たしますが、Pythonでは明示的に仮想環境を作る必要があります。

実際にやるとこうなる：venvを使った流れ

典型的なPythonプロジェクトの初期手順は次のようになります。

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Node.jsのnpm installに比べると、手順が多いと感じるかもしれません。
しかし、この一手間を省くと、後でトラブルが起きやすくなります。

requirements.txtとlockファイルの考え方の違い

Node.jsでは、package.jsonとpackage-lock.json（またはyarn.lockなど）がセットで使われます。
lockファイルがあることで、インストール結果をほぼ完全に再現できます。

Pythonにもrequirements.txtがありますが、役割は少し違います。

requirements.txtは「固定」ではないことが多い

requirements.txtには、次のように書かれることが多いです。

requests>=2.25

これは「最低このバージョンが必要」という指定であり、Node.jsのlockファイルほど厳密ではありません。
そのため、環境やタイミングによってインストールされるバージョンが変わることがあります。

最近ではpip-toolsやPoetryなど、より厳密な管理を行うツールも増えていますが、標準的なpip運用ではこの曖昧さが残ります。

Node.jsとの比較で見えるクセ

Node.jsに慣れていると、

• lockファイルがないと不安
• 同じ結果が再現できないのは怖い

と感じることが多いです。
Pythonのパッケージ管理は、この点で「利用者が意識して補わないといけない部分」が残っています。

Pythonパッケージ管理で失敗しがちなポイント

ここでは、Node.js経験者がPythonで特につまずきやすいポイントを挙げます。

pip installしたのにimportできない

これは非常によくあるケースです。
原因の多くは、次のいずれかです。

• 仮想環境を有効化していない
• 実行しているPythonとpipが別の環境を指している

Node.jsでは起きにくい問題なので、最初は戸惑いやすいです。

環境を作り直すと動かなくなる

venvを削除して作り直した際に、

• requirements.txtに書き漏れがある
• 手動で入れたライブラリを忘れている

といった理由で動かなくなることがあります。
Node.jsではpackage.jsonに依存が集約されやすいため、この差は意識しておく必要があります。

リスクと注意点：Pythonの自由度は諸刃の剣

Pythonのパッケージ管理は柔軟ですが、その分リスクもあります。

• 環境が増えると管理が煩雑になる
• チーム開発では手順を揃えないと再現性が下がる

特に、仮想環境の扱いをドキュメント化していないと、「動く人と動かない人」が出やすくなります。
これはPythonそのものの欠点というより、運用設計の問題と言えるでしょう。

結局どうすればいいのか

Node.jsとPythonのパッケージ管理は、似ているようで前提がかなり違います。
Pythonを使う場合は、次の点を意識すると混乱しにくくなります。

• 仮想環境を必ず使う
• 「どのPythonで動いているか」を常に意識する
• 依存関係の管理方法をプロジェクトごとに明確にする

Node.jsの感覚をそのまま持ち込むと違和感がありますが、Pythonの設計思想を理解すれば納得できる部分も多いです。
それぞれの言語に合ったパッケージ管理の考え方を受け入れることが、結果的に一番の近道と言えるでしょう。