Mac에서 파이썬을 설치하는 방법

맥 환경에서 파이썬에 입문하기 위해서는 파이썬을 설치하고 명령어가 작동하게 환경 변수를 설정해야 합니다. 또한 배우는 과정에서 필요한 라이브러리를 추가할 수 있는데요.

이 글에서는 macOS 운영체제에서 파이썬 환경을 구축하는 방법에 대해 다루며 처음 설치하는 사용자부터 기존에 구버전이 설치되어 있지만 새롭게 다시 환경을 만들려는 사용자를 위해 작성되었습니다.

튜토리얼 환경 : M1 맥북 프로 14, macOS Sonoma 14.6

Mac용 파이썬 설치

Python 공식 홈페이지의 Downloads 페이지에 접속하면 화면 상단에서 가장 최신 버전의 파이썬 설치 파일을 다운로드 받을 수 있습니다. 만일 특정 버전이 필요하면 All Releases 페이지에서 원하는 버전을 선택할 수 있습니다.

파이썬은 Stable Releases(정식)과 Pre-releases(사전 출시) 버전이 나뉘며 안정적인 정식 버전을 사용하는 것이 권장됩니다.

pkg 파일을 실행하면 설치 화면이 뜨며 사용권 계약에 동의 > 디스크 경로를 선택하면 쉽게 설치가 가능합니다.

파이썬은 버전 별로 설치해서 사용할 수도 있으며 패키지의 경로와 응용 프로그램의 폴더가 구분됩니다.

설치된 파이썬 버전 및 경로 확인

파이썬을 버전마다 설치했을 때 터미널에서 파이썬 명령어를 입력하면 가장 최신 버전이 동작하게 되는 것이 기본적입니다. 하지만 Python2와 Python3를 혼용해서 사용하거나 환경 변수 지정에 따라서 사용자가 의도하지 않은 버전이 동작할 수도 있습니다.

python --version

python3 --version

이 경우, 터미널을 실행한 다음 위 명령어로 맥에 설치된 파이썬 버전을 확인할 수 있습니다.

which python

which python3

현재 동작하고 있는 파이썬의 설치 경로를 확인하고 싶다면 which 명령어를 사용합니다.

맥에 설치되는 파이썬은 /Library/Frameworks/Python.framework/Versions/ 경로 하위에 위치하며 다른 버전을 함께 사용한다면 터미널에서 이 경로로 이동해 특정 버전의 파이썬을 실행할 수 있습니다.

파이썬 환경 변수 설정

파이썬 환경 변수는 터미널에서 python 명령어 및 파일 실행을 할 때 파이썬이 설치된 전체 경로를 입력하지 않아도 되게 하는, 즉 어떠한 경로에서도 파이썬 명령어를 사용할 수 있게 하는 설정입니다.

기본적으로 가장 마지막에 설치된 파이썬이 환경 변수에 등록되며 우선 순위가 부여되지만 터미널에서 파이썬 명령어가 동작하지 않거나 다른 버전이 실행된다면 사용자가 직접 환경 변수를 설정할 수 있습니다.

파인더를 실행한 다음 사용자 폴더를 엽니다. 그리고 키보드의 Shift + command + . 키를 눌러 숨김 파일을 보기로 설정하면 .zprofile 파일을 찾을 수 있는데요. 이 파일을 텍스트 편집기로 엽니다.

.zprofile 파일은 사용자가 만든 환경 변수가 저장된 파일로 터미널 명령어에 영향을 미칩니다.

PATH="/Library/Frameworks/Python.framework/Versions/3.12/bin:${path}"
export PATH

위와 같은 구조의 환경 변수가 지정되어 있으며 사용자가 사용할 파이썬 버전 외에 다른 변수가 추가되어 있다면 삭제해도 무방합니다.

반대로 환경 변수가 등록되어 있지 않다면 위 예시를 참고해서 설치되어 있는 파이썬 버전에 맞는 경로로 수정해 등록합니다.

사용자가 지정한 환경 변수를 포함해 시스템의 환경 변수까지 한 눈에 확인하려면 터미널에서 echo $PATH 명령어를 사용하면 됩니다.

참고 : Mac에서 python3 명령어를 python으로 실행하는 방법

파이썬 라이브러리 설치

pip install package-name

python3 -m pip install package-name

파이썬에서 라이브러리를 설치하려면 터미널에서 pip install 명령어를 사용합니다.

pip는 파이썬으로 작성된 패키지 소프트웨어 및 라이브러리를 관리하는 시스템으로 종속성 및 호환성을 무시하므로 사용하는 파이썬의 버전에 맞는 패키지를 설치하는 것이 중요합니다.

현재 버전에 호환되는 라이브러리를 잘 모르겠다면 -m 옵션을 추가해서 설치할 수 있습니다.

pip list

설치된 파이썬 라이브러리를 목록으로 확인하려면 위 명령어를 사용합니다.