Skip to content

[Bug] 在 Kubuntu 25.04 上安装失败:externally-managed-environment (PEP 668) #277

@MYLMMMM

Description

@MYLMMMM

环境信息

操作系统:Kubuntu  25.04 (任何启用了 PEP 668 保护的版本)

Python 版本:3.12+ 或 3.13+

Env 安装方式:install_ubuntu.sh --gitee

问题描述

执行官方提供的 install_ubuntu.sh 脚本时,运行到 pip install scons requests tqdm kconfiglib pyyaml 这一步失败,错误信息为:
text

error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
python3-xyz, where xyz is the package you are trying to
install.

...

这是因为 Ubuntu 从 23.04 开始默认遵循 PEP 668,禁止直接使用 pip 向系统级 Python 环境安装包,以避免与 APT 包管理器冲突。

改用 APT 安装依赖:检测到 Ubuntu 版本 ≥ 23.04 时,使用 apt install scons python3-requests python3-tqdm python3-kconfiglib python3-yaml 代替 pip install。

目前用户可以手动执行以下命令来绕过该问题:
bash

方法1:APT 安装(推荐)

sudo apt install scons python3-requests python3-tqdm python3-kconfiglib python3-yaml

然后重新执行 install_ubuntu.sh(但需跳过 pip install 那行,或手动运行剩余步骤)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions