[개발환경 구축] macOS에서 파이썬 개발환경 구축하기 - 파이썬 버전 확인 및 자잘한 디버깅 (파이썬 버전 출력 이상할 때)

Anaconda를 이용해 가상환경 생성하고 파이썬 버전을 확인하는 방법까지 확인했었다.

그런데 파이썬 버전을 정의하여 설치했는데 설치 후 확인되는 파이썬 버전이 내가 설치한 파이썬 버전과 다르게 이상한 값으로 나와 혼란을 주는 상황이 발생한다.

실제 설치된 파이썬 버전에는 문제가 없고, conda 환경에서의 파이썬 경로에 문제가 있는 경우 이런 상황이 발생할 수 있다.

이번 글에서는 macOS에서 파이썬 경로를 확인하고, 문제가 있을 때 해결하는 방법에 대해 정리한다.

---

파이썬 버전 정의하여 가상환경 생성

파이썬 버전을 정의해서 가상환경을 생성했고, 설치하면서 파이썬 버전이 의도한 버전이라는 것을 확인한다.

위 그림과 같이 파이썬 버전을 3.13.1로 정의해서 가상환경을 제대로 설치했는데,

해당 가상환경으로 진입하여 파이썬 버전을 확인해보면 아나콘다 기본 파이썬 버전이 출력되는 현상이 나타나는 경우가 있다. 설치가 잘못된 건가? 싶을 수 있다.

파이썬 버전이 안맞는 문제 발생..

가상환경 활성화도 제대로 되어있고, 파이썬 버전도 의도대로 설치되는 것을 확인했으니 그런 문제는 아닐 것이다.

잘못된 버전 출력 확인 후 파이썬 실행 경로 확인

이럴 때 해볼 수 있는 방법은 파이썬의 실행 경로를 확인해보는 것이다.

# 파이썬 실행 경로 확인
which python # For Linux / macOS
where python # For Windows

이렇게 확인했을 때 정상적이라면,

macOS 환경에서는 "~/miniconda3/envs/test/bin/python", Windows 환경에서는 "C:\Users\사용자\miniconda3\envs\test\python.exe"

위처럼 Conda 환경 내 Python 경로가 나와야 한다. (miniconda가 아닌 anaconda로 폴더명이 되어있는 등의 디테일한 부분에서 차이는 아나콘다 설치 시 설정 등에 따라 다를 수 있으므로 문제가 아니다.)

 

터미널에서 명령어를 입력했을 때 아래와 같은 출력이 나왔다.

python: aliased to /Library/Frameworks/Python.framework/Versions/3.10/bin/python3

이는 python 명령어가 macOS에 설치된 alias (가명이라는 뜻으로, 중복적으로 경로설정이 되어있다 정도로 이해하면 좋을듯)로 설정되어 있어서, conda 가상환경을 활성화해도 시스템 기본 파이썬이 실행되는 문제였다.

해결 방법

설정되어있는 alias를 제거하면 해결이 가능하다. 일시적으로 해제하는 방법도 있고, 영구적으로 삭제하는 방법도 있다.

1) 일시적으로 해제

일시적으로 해제했을 때 정상적인 경로로 Python을 실행하는지 확인해본다.

unalias python # 일시적으로 alias 해제
which python # Python 실행 경로 확인
python --version # Python 버전 확인

아래 그림처럼 alias를 해제하니 해결되는 것을 확인했다.

파이썬이 설치했던 3.13.1로 나오는 것을 볼 수 있다.

그런데 이 방법은 터미널을 껐다가 다시 열면 다시 alias가 되어있을 수 있다.

2) 영구적으로 alias 삭제

이 alias 설정은 보통 ~/.zshrc, ~/.bashrc, ~/.bash_profile과 같은 설정 파일에 들어있게 된다.

아래 명령어를 통해 alias 설정이 어디에 있는지 확인할 수 있다.

grep "alias python=" ~/.zshrc ~/.bashrc ~/.bash_profile 2>/dev/null

나의 경우 ~/.zshrc에서 확인할 수 있었다.

.zshrc 발견

이 파일을 편집해서 alias가 있는 부분을 삭제해야 한다.

nano ~/.zshrc

이러면 터미널에서 파일 편집이 가능해진다.

해당 alias 줄을 찾아서 삭제한 뒤 저장할 수 있다.

해당 alias 줄을 찾아서 삭제한 뒤 저장할 수 있었다.

이 설정 파일에서 변경된 사항을 적용해야 하므로 아래 명령을 실행한다.

source ~/.zshrc

이후에 가상환경을 다시 활성화해서 확인해보면 경로 설정이 제대로 되고 버전 확인도 제대로 동작하는 것을 볼 수 있다.

처음에 가상환경 생성할 때 설치했던 파이썬 버전이 확인되었다.

문제가 해결되었다.

---

아마 예전에 개발 환경을 만들 때 애플 실리콘 호환이 안되어서 파이썬 먼저 따로 설치하고 아나콘다를 추후에 설치했던 것 같다.

아무튼 이런 과정을 통해 가상환경을 다루는 방법을 조금은 익힐 수 있었다.