Python 강좌 / macOS·Ubuntu에서 Python 실행 환경 준비하기

macOS와 Ubuntu에서는 python3의 버전과 경로를 확인하고 프로젝트별 가상환경을 만드는 방식으로 시작합니다. 운영체제가 사용하는 Python을 임의로 교체하지 않고 개발용 환경을 분리하는 것이 핵심입니다.

기존 Python과 시스템 Python 구분하기

python3 --version
command -v python3
python3 -c "import sys; print(sys.executable)"

터미널에서 실행한 경로가 어떤 설치에서 왔는지 기록합니다. 이 강좌의 예제는 Python 3.12 이상을 기준으로 합니다. 버전이 낮거나 명령이 없으면 사용하는 운영체제의 지원 설치 방법으로 개발용 Python을 준비합니다. /usr/bin/python3 링크를 새 버전으로 바꾸면 운영체제 도구에 영향을 줄 수 있습니다.

관련 동작과 지원 조건은 macOS·Ubuntu에서 Python 실행 환경 준비하기 관련 공식 문서에서 확인할 수 있습니다.

macOS에서 공식 설치 프로그램 사용하기

1. python.org에서 macOS용 Python 설치 프로그램을 받습니다. 사용 중인 macOS와 CPU에 대한 지원 조건을 확인합니다.
2. 다운로드한 패키지를 열어 안내에 따라 설치한 뒤 새 터미널을 엽니다.
3. python3의 버전과 경로를 다시 확인합니다. 여러 설치가 있으면 원하는 실행 파일의 절대 경로로 가상환경을 만듭니다.

HTTPS 인증서 오류가 발생하면 공식 설치 프로그램에 포함된 인증서 설치 안내를 확인합니다. 인증서 검증을 끄는 코드로 우회하면 접속 상대를 검증할 수 없으므로 해결 방법으로 사용하지 않습니다.

Ubuntu에서 배포판 패키지 설치하기

아래는 Ubuntu가 제공하는 Python과 가상환경 패키지를 사용하는 명령입니다. 배포판 릴리스에 따라 Python 버전은 달라집니다. 설치 후 버전을 확인하고, 예제 요구 버전보다 낮다면 지원되는 Ubuntu 릴리스나 별도 개발 환경을 선택합니다.

sudo apt update
sudo apt install python3 python3-venv python3-pip
python3 --version

시스템 환경에서 pip 설치가 externally-managed-environment 오류로 막히면 가상환경을 사용하라는 의미일 수 있습니다. sudo pip나 시스템 보호를 해제하는 옵션으로 해결하지 않습니다.

공통 실습 폴더와 실행 확인

mkdir python-lab
cd python-lab
python3 -m venv .venv
.venv/bin/python --version
.venv/bin/python -m pip --version
.venv/bin/python -c "print(3500 + 8000 + 2500)"

마지막 줄은 14000을 출력해야 합니다. 활성화하려면 source .venv/bin/activate를 실행하고, 종료할 때는 deactivate를 입력합니다. 활성화는 현재 셸의 명령 탐색 경로를 바꾸는 편의 기능이며 가상환경 Python을 직접 실행하는 방식과 함께 사용할 수 있습니다.

venv 생성이 실패하면 해당 Python 버전에 맞는 venv 지원 패키지가 있는지 확인합니다. 소스는 python-lab 폴더에 보관하고, 가상환경을 다시 만들 때도 소스 파일이 사라지지 않도록 .venv 안에 코드를 저장하지 않습니다.