[Mac] 파이썬 기본 버전 변경하는 방법 3단계

macOS Sequoia에는 기본적으로 Python 3.9.6이 설치되어 있습니다. 이 버전은 다소 구버전이기 때문에, 최신 파이썬 기능을 활용하거나 특정 라이브러리를 사용할 때 호환성 문제가 발생할 수 있습니다.

특히, 최신 앱을 실행하거나 개발 환경을 구성할 때 Python 3.10 이상을 요구하는 경우가 많아, 기본 버전을 변경하는 것이 필요할 수 있습니다.

이 글에서는 터미널에서 파이썬 명령어를 사용할 때 기본 버전을 변경하는 방법에 대해 알아보겠습니다.

1. 터미널에서 인식하는 파이썬 기본 버전 확인하기

서두에서 설명했던 것 처럼 파이썬 3.9.6 버전이 기본으로 설치되어 있습니다. 여기서 사용자가 최신 버전을 설치하면 zsh에 파이썬 최신 버전을 가리키는 경로가 등록되는데, 간혹 최신 버전을 인식하지 않고 구버전으로 명령어가 실행될 수 있습니다.

터미널에서 python3 명령어를 입력했을 때 명령어를 실행하는 버전이 어떤 것인지 먼저 확인합니다.

python3 --version

역시나 기본 버전 3.9.6에서 명령어를 실행하고 있어서 스테이블 디퓨전이 실행되지 않았네요.

2. 설치된 파이썬 버전 확인하기

ls -l /usr/local/bin/python*

사용자가 필요한 파이썬 버전이 설치되어 있는지 확인합니다. 만일 특정 버전이 필요하다면 공식 홈페이지에서 패키지를 다운로드 받아 설치합니다. 필자의 경우 3.10.11 버전이 필요해 미리 설치했습니다.

3. 파이썬 기본 버전 변경하기

macOS에서 사용하는 버전을 삭제하면 문제가 생길 수 있으므로 기존 버전을 삭제하는 대신 .zshrc 파일을 수정해 파이썬 기본 버전을 변경할 수 있습니다.

vi ~/.zshrc

vi 또는 vim 에디터로 ,zshrc 파일을 엽니다.

PATH="/Library/Frameworks/Python.framework/Versions/3.10/bin:${PATH}"

사용자가 설치한 버전에 맞는 경로를 추가한 후 저장합니다.

ℹ️ vi 에디터 기준, i 키를 눌러 편집 모드로 전환하고 Esc 키를 눌러 편집 모드를 빠져나올 수 있습니다. 그리고 :wq 키를 입력해 파일을 저장합니다.

source ~/.zshrc

다시 터미널 화면으로 돌아오면 source 명령어로 기본 파이썬 경로를 적용합니다.

python3 --version

다시 파이썬 버전 확인 명령어를 입력하면 기본 파이썬 버전이 변경된 것을 확인할 수 있습니다.