1. 問題描述

在按照 ms-agent 教程安裝 ms-agent 時，運行下述命令后報錯

cd ms-agent 

pip3 install -e .

#  該安裝命令解釋：
#  pip install：使用 pip 安裝 Python 包。
#  -e：表示 “editable”（可編輯）模式。也稱為“開發(fā)模式”（development mode）。
#  .：代表當前目錄（即你運行命令時所在的目錄）。

報錯內(nèi)容如下：

error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try brew install
    xyz, where xyz is the package you are trying to
    install.
    
    If you wish to install a Python library that isn't in Homebrew,
    use a virtual environment:
    
    python3 -m venv path/to/venv
    source path/to/venv/bin/activate
    python3 -m pip install xyz
    
    If you wish to install a Python application that isn't in Homebrew,
    it may be easiest to use 'pipx install xyz', which will manage a
    virtual environment for you. You can install pipx with
    
    brew install pipx
    
    You may restore the old behavior of pip by passing
    the '--break-system-packages' flag to pip, or by adding
    'break-system-packages = true' to your pip.conf file. The latter
    will permanently disable this error.
    
    If you disable this error, we STRONGLY recommend that you additionally
    pass the '--user' flag to pip, or set 'user = true' in your pip.conf
    file. Failure to do this can result in a broken Homebrew installation.
    
    Read more about this behavior here: <https://peps.python.org/pep-0668/>

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.

2.報錯分析

這是 PEP 668 的限制：現(xiàn)在用的 python3/pip3 是來自 Homebrew，它把系統(tǒng) Python 環(huán)境標記為“externally managed”，禁止用 pip install 往這個全局環(huán)境里裝包（避免把 Homebrew 的 Python 環(huán)境弄壞）。

最推薦的解決方式是：用虛擬環(huán)境 來安裝（尤其這里是 pip install -e .，更應該用 venv）。

3. 創(chuàng)建虛擬環(huán)境再安裝

3.1 在項目里建 venv 再install

# 進入項目
cd ms-agent

# 1) 創(chuàng)建虛擬環(huán)境
python3 -m venv .venv

# 2) 激活虛擬環(huán)境
source .venv/bin/activate

# 3) 升級 venv 里的 pip（可選但建議）
python -m pip install -U pip

# 4) editable 安裝
python -m pip install -e .

在項目的 .venv 目錄里，可以看到新創(chuàng)建的虛擬環(huán)境信息：

3.2 驗證venv是否成功

# 進入項目
cd ms-agent

# 激活虛擬環(huán)境
source .venv/bin/activate

# 查看虛擬環(huán)境的python位置
which python

# 查看虛擬環(huán)境里的 pip 版本
python -m pip -V

# 輸出里應包含 .../ms-agent/.venv/...，而不是系統(tǒng)環(huán)境 /opt/homebrew/...

3.3 每次打開終端先激活虛擬環(huán)境

# 進入項目
cd ms-agent

# 激活虛擬環(huán)境
source .venv/bin/activate

到此這篇關于pip install報錯This environment is externally managed的解決方法的文章就介紹到這了,更多相關pip install報錯解決內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論