Python開発中に「ImportError: cannot import name 'html5lib' from pip._vendor」というエラーに遭遇した。これはパッケージが見つからないという単純な問題ではなく、環境のパス設定が壊れているサインであり、デバッグに時間を費やすよりも環境をリセットした方が早いと判断した。
何が起きたか（課題）
このエラーが発生する状況は、pipが内部的に使用するべき依存関係（ベンダーモジュール）を、通常のアプリケーションのインポートパスが誤って参照しようとしている状態を示している。これは非常に厄介で、原因は環境のパス汚染か、パッケージのバージョン衝突にあることが多い。
-
pipのベンダーモジュールを参照しようとして失敗している。 - システム全体のPython環境が意図せず干渉している。
- デバッグに時間をかけると、環境の再構築にかかる時間よりも多くなるリスクがある。
どう解決したか（概要）
最も確実な解決策は、現在の環境を破棄し、クリーンな仮想環境を再構築することだ。古い環境での修正は、隠れた依存関係の衝突を再発させる可能性が高いため、推奨しない。仮想環境（venvなど）を使用することで、システム全体への影響を遮断できる。
まず、新しい仮想環境を作成し、アクティベートする。
python3 -m venv .venv
source .venv/bin/activate
その後、必要なパッケージをインストールし直す。もし仮想環境外で対応が必要な場合は、pipの強制更新やPYTHONPATHの解除、キャッシュのクリアも併せて実施し、システムレベルのクリーンアップを行った。
システムクリーンアップの主要な手順は以下の通りだ。
-
pip自体の最新化とアップグレードの強制実行。 - 該当パッケージ（
html5lib）のアンインストールと再インストール。 - 環境変数
PYTHONPATHが設定されていないか確認し、設定されていれば解除する。 -
pip cache purgeで古いキャッシュを削除する。
これは私が現場で遭遇したこの種のエラーに対する標準的なアプローチであり、仮想環境の利用が最優先事項となる。
🚀 詳細な設定とコードはこちら
具体的なvenvのアクティベートコマンド（Windows/Linux両対応）や、システム環境変数の解除コマンド、キャッシュクリアの手順全文は元のブログで公開しています。