포스트

Ubuntu - 사용자 계정에서 pip 명령어 사용하기

Ubuntu 24.04 , Python 3.12.3


처음으로 pip install을 시도해보던 중 아래 에러가 등장했다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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.
    
    If you wish to install a non-Debian packaged Python application,
    it may be easiest to use pipx install xyz, which will manage a
    virtual environment for you. Make sure you have pipx installed.
    
    See /usr/share/doc/python3.12/README.venv for more information.

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.

가상 환경을 생셩하여 설치를 진행하라는 내용이었다.


가상 환경 세팅

1
2
3
4
5
# 설치
sudo apt install -y python3.12-venv

# 설정 
python3 -m venv path/my/env
  • path/my/env 는 가상 환경 설정을 관리하고자 하는 경로로 입력


가상 환경 실행

1
source path/my/env/bin/activate

이후 pip 명령어를 사용하면 에러 메세지가 나타나지 않고 원하는 패키지의 설치가 진행된다!
pip 명령어 사용할 때 마다 source path/my/env/bin/activate 명령어로 가상 환경에 진입해야 한다.


가상 환경 종료

1
deactivate
이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.