본문 바로가기
컴퓨터 활용(한글, 오피스 등)/기타

시스템 파이썬 환경을 보호 문제 This environment is externally managed

by 3604 2026. 3. 12.
728x90

"pip install torch torchvision torchaudio

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.

  • 2를 써도 무방하지만, 시스템 파이썬이 꼬일 수 있다는 점을 염두에 두어야 합니다.

이 에러는 최근 리눅스 배포판(Ubuntu 23.04+, Debian 등)에서 시스템 파이썬 환경을 보호하기 위해 도입된 안전장치 때문입니다. 시스템 전체에 pip으로 패키지를 설치하다가 운영체제 자체의 파이썬 구성 요소가 망가지는 것을 방지하려는 의도죠.

가장 권장되는 해결 방법은 **가상 환경(Virtual Environment)**을 사용하는 것입니다.

방법 1: 가상 환경(Venv) 생성 및 사용 (가장 권장)
프로젝트별로 독립된 공간을 만들어 그 안에 PyTorch를 설치하는 방식입니다.

가상 환경 생성: (현재 폴더에 .venv라는 이름의 환경 생성)

Bash
python3 -m venv .venv
만약 python3-venv가 없다고 나오면 sudo apt install python3-venv를 먼저 실행하세요.

가상 환경 활성화:

Bash
source .venv/bin/activate
(활성화되면 터미널 프롬프트 앞에 (.venv)가 표시됩니다.)

PyTorch 설치:

Bash
pip install torch torchvision torchaudio
방법 2: --break-system-packages 옵션 사용 (비권장)
에러 메시지 마지막에 나온 대로 시스템 보호를 무시하고 강제로 설치하는 방법입니다. 간단하지만, 나중에 시스템 패키지 업데이트 시 충돌이 발생할 수 있어 주의가 필요합니다.

Bash
pip install torch torchvision torchaudio --break-system-packages
방법 3: Conda(Miniconda) 사용
데이터 과학이나 딥러닝 분야에서는 시스템 파이썬과 완전히 분리된 Conda를 사용하는 것이 관리에 훨씬 편리합니다.

어떤 방법을 선택해야 할까요?
개인 프로젝트나 학습용: **방법 1(가상 환경)**이 정석입니다. 프로젝트 폴더마다 하나씩 만들어 관리하세요.

간단한 테스트 후 바로 삭제할 경우: 방법 2를 써도 무방하지만, 시스템 파이썬이 꼬일 수 있다는 점을 염두에 두어야 합니다.

728x90