pip 23+ · Python
メッセージ
error: externally-managed-environment
何を意味するか
この Python は OS か Homebrew が管理しているもので、pip がそこへ書き込むのを拒んでいます（PEP 668）。システムのインタープリタに対して pip install したのが原因で、このメッセージは「仮想環境を作れ」という案内です。--break-system-packages は名前のとおりシステム側のパッケージを壊しうるので、.venv を作ってそこに入れるのが答えです。
直しかた
python3 -m venv .venv && source .venv/bin/activate- 出す道具
- pip 23+
- Python
- 18
Python のトレースバックは答えを二つに分けて置きます — 最後の一行が何が誤りかを、その上のフレームがどこで誤ったかを示すので、最後の行だけ読むと名前は分かって場所を落とします。とくに NoneType や KeyError のように値が無くて出る誤りは、落ちた場所より、その値を作った上のフレームに原因があります。
エラーメッセージの読み方
- 一行目から読みます。下に行くほど道具の内部の話で、原因はたいてい一番上に書かれています。
- ファイル名と行番号があればそこが出発点です — スタックの最上段ではなく、自分が書いたファイルが出てくる一番上の行です。
- 文句はそのまま検索します。ただし自分のパスや変数名は消します — その部分が検索を邪魔します。
- 同じ事情が道具の版ごとに違う言い方で出ます。結果が合わないときは版番号も入れてみます。
- 直す命令を貼る前に、その命令が何を捨てるかを確かめます。取り消せないものが混ざっています。
よくある質問
Q. error: externally-managed-environment はどういう意味ですか。
この Python は OS か Homebrew が管理しているもので、pip がそこへ書き込むのを拒んでいます（PEP 668）。システムのインタープリタに対して pip install したのが原因で、このメッセージは「仮想環境を作れ」という案内です。--break-system-packages は名前のとおりシステム側のパッケージを壊しうるので、.venv を作ってそこに入れるのが答えです。
Q. どう直しますか。
python3 -m venv .venv && source .venv/bin/activate — 実行する前に、この命令が何を捨てるかを上の説明で確かめてください。
Q. どの道具が出すエラーですか。
pip 23+ です。Pythonの仲間で、文句は2語です。
近いエラー
ModuleNotFoundError: No module named 'requests'pythonPermissionError: [Errno 13] Permission deniedpythonImportError: cannot import name 'User' from partially initialized module 'models' (most likely due to a circular import)pythonIndentationError: unexpected indentpythonTabError: inconsistent use of tabs and spaces in indentationpythonSyntaxError: invalid syntaxpythonTypeError: 'NoneType' object is not subscriptablepythonAttributeError: 'NoneType' object has no attribute 'get'python