Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

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

未关闭
#277 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
68/100
Issue 类型
缺陷
描述清晰度
描述清楚
活跃度
冷清
技术栈
bash, python
领域
devops, tooling

调研方向

从 install_ubuntu.sh 开始,找到 pip install scons requests tqdm kconfiglib pyyaml 这一步。在使用 PEP 668 的 Ubuntu 或 Kubuntu 发行版上重现该失败,然后验证受支持的较新发行版是否通过 APT 安装列出的依赖项,以及其余安装步骤是否仍能成功运行。

由索引模型根据 Issue 内容生成。

描述

环境信息

操作系统: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 那行,或手动运行剩余步骤)

主要语言
Python
星标
78
派生
64
平均合并
1 天 6 小时
30 天内合并 PR
6

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

RT-Thread/env 的其他 Issue

查看 RT-Thread/env 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。