首页·报错信息

pip 23+ · Python

报错原文

error: externally-managed-environment

这是什么意思

这个 Python 是操作系统或 Homebrew 管着的,pip 拒绝往里面写(PEP 668)。你是对系统解释器执行了 pip install;这条消息是在让你建虚拟环境。--break-system-packages 就像它名字说的那样,可能让 apt 管理的文件处于损坏状态,所以正确做法是建一个 .venv 并装在里面。

怎么修

python3 -m venv .venv && source .venv/bin/activate
来自
pip 23+
Python
18

Python 的 traceback 把答案劈成两半——最后一行说「错了什么」,上面的帧说「错在哪里」——所以只读最后一行,你会拿到名字却丢掉位置;而 NoneType、KeyError 这类「值不存在」的错误,原因几乎总在崩溃那一帧的上面。

怎么读报错

  • 从第一行往下读。越往下越是工具内部的事,起因通常写在最上面。
  • 有文件名和行号就从那里查——不是栈顶那一帧,而是最上面那条提到你自己写的文件的行。
  • 把报错原文照样去搜,但先去掉你自己的路径和变量名,正是那些让搜索匹配不上。
  • 同一种情况在不同版本里措辞不同。结果不对头,就把版本号一起加进查询。
  • 粘贴修法之前,先确认它会丢掉什么。这里面有些是不能撤回的。

常见问题

Q. “error: externally-managed-environment” 是什么意思?

这个 Python 是操作系统或 Homebrew 管着的,pip 拒绝往里面写(PEP 668)。你是对系统解释器执行了 pip install;这条消息是在让你建虚拟环境。--break-system-packages 就像它名字说的那样,可能让 apt 管理的文件处于损坏状态,所以正确做法是建一个 .venv 并装在里面。

Q. 怎么修?

python3 -m venv .venv && source .venv/bin/activate —— 执行前先看上面的说明,确认这条命令会丢掉什么。

Q. 这是哪个工具报的?

pip 23+。它属于Python,报错原文有 2 个词。

相关报错