Dev Blog

스크립트 & 소스코드 공유

실무에서 유용하게 쓰는 스크립트와 코드 조각을 블로그 게시판으로 저장하고 공유합니다.

Python 외부 관리 환경(PEP 668) 오류 - 가상환경 활성화 방법

페이지 정보

조회 87회 작성일 25-12-29 16:10
Python 패키지 설치 시 "externally managed environment"(PEP 668) 오류가 발생할 때의 해결 방법이다. python -m venv로 가상환경을 만들고 Windows CMD·PowerShell, macOS/Linux에서 활성화하는 명령을 단계별로 안내한다. uv 패키지 매니저 사용법과 --break-system-packages로 강제 설치할 때의 위험성도 함께 설명한다.

你再次遇到了“externally-managed-environment”错误,并且它建议你查看 PEP 668 和使用 --break-system-packages 来强制安装。使用这个选项可以临时绕过限制,但可能会对环境稳定性造成风险。为了安全起见,我建议你考虑以下更稳妥的解决方案:

推荐解决方案

创建虚拟环境
使用虚拟环境是比较安全且推荐的处理方式,它允许你在不影响系统环境的情况下安装和管理 Python 包:

python -m venv myenv 

激活虚拟环境:
Windows(CMD):

myenv\Scripts\activate 

Windows(PowerShell):

.\myenv\Scripts\Activate.ps1 

macOS/Linux:

source myenv/bin/activate 

激活之后,就可以尝试再次执行:

python -m pip install --upgrade pip python -m pip install -r requirements.txt 

了解 uv 提供的包管理方式
如果因为某些原因你不能或不想使用虚拟环境,你可以查看 uv 管理器的文档,看看是否有提供专门的命令来管理 Python 包。

如果决定使用 --break-system-packages

在极端情况下,如果你确实需要在 uv 管理的系统环境中安装包,并且你已经考虑过可能的风险,可以执行以下命令:

python -m pip install --break-system-packages -r requirements.txt 

请谨慎使用这个选项,并确保你有能力恢复环境或者安全备份重要文件。

如果需要更多指导,请随时告诉我!



Let's create something great together.

프로젝트 문의 및 견적 요청은 언제든 환영합니다.