【解决办法】树莓派系统使用PIP安装ultralytics失败

星隐

树莓派系统使用PIP安装ultralytics失败,解决办法:虚拟环境

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
smp4bu@raspberrypi:~ $ pip install ultralytics[export]
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.

If you wish to install a non-Debian-packaged Python package,
create a virtual environment using python3 -m venv path/to/venv.
Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
sure you have python3-full installed.

For more information visit http://rptl.io/venv

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.

你遇到的错误信息表明你正在一个“外部管理的环境”中尝试安装 ultralytics 包。这是因为你的 Python 安装是通过操作系统的包管理工具(如 apt)进行管理的。

解决方法

1. 创建虚拟环境

最推荐的解决方法是创建一个虚拟环境,这样你可以在其中自由安装和管理 Python 包,而不会影响系统级的 Python 安装。以下是具体步骤:

  1. 安装 python3-venv(如果还没有安装)

    1
    sudo apt install python3-venv
  2. 创建一个虚拟环境

    1
    python3 -m venv myenv

    这里 myenv 是你虚拟环境的名称,可以根据需要更改。

  3. 激活虚拟环境

    1
    source myenv/bin/activate
  4. 安装 ultralytics
    在虚拟环境激活后,你可以使用 pip 安装 ultralytics

    1
    pip install ultralytics[export]
  5. 使用虚拟环境
    每次需要使用这个环境时,记得先激活它。使用完成后,可以通过 deactivate 命令退出虚拟环境。

2. 使用系统包管理器(不推荐)

如果你希望使用系统包管理器来安装某个特定的 Python 包,虽然不推荐,但你可以尝试使用 apt

1
sudo apt install python3-ultralytics

请注意,这可能没有最新版本。

3. 直接覆盖(不推荐)

如果你非常确定要在系统环境中安装,可以使用 --break-system-packages 选项,但这样做风险较高,可能会导致系统不稳定:

1
pip install ultralytics[export] --break-system-packages

总结

创建虚拟环境是最安全和推荐的方式,它可以帮助你避免对系统环境造成影响,同时允许你自由地管理和安装 Python 包。

  • 标题: 【解决办法】树莓派系统使用PIP安装ultralytics失败
  • 作者: 星隐
  • 创建于 : 2025-10-09 21:55:33
  • 更新于 : 2026-01-19 01:58:27
  • 链接: https://www.starin.top/post/884250281efe/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
目录
【解决办法】树莓派系统使用PIP安装ultralytics失败