pyvenv.cfg, venv에서는 파이썬을 이렇게 실행하더랍니다

🤔 Problem

몇 달 전부터 아나콘다에서 독립적인 작업 세팅을 추구하고 있어서, 시간이 날 때마다 세팅을 바꿔가는 과정을 겪고 있었습니다. 그리고, 이제야 완전히 독립된 작업 세팅이 만들어진 거 같아 아나콘다를 삭제하고, 그와 관련된 마지막 이슈를 정리하고자 합니다.

 

우선, venv를 통해서 가상 환경을 만들어 작업을 해오던 입장이었는데 아나콘다(아나콘다 내부의 파이썬 포함)를 완전히 삭제하고, 파이썬을 재설치해서 환경 변수까지 다시 세팅을 해주었지만, 삭제 이전의 가상 환경들은 모두 이전 아나콘다의 파이썬을 찾는 게 문제점이었습니다. (파이썬 파일을 실행시키면, 아래와 같은 오류가 발생합니다.)

python test.py
>>> No Python at '"C:\Users\user\anaconda3\python.exe'

분명히 환경 변수를 새로운 파이썬의 경로에 맞게 잡아주었는데, 어떻게 이전 파이썬 경로를 기억하고 있는지가 의문이었습니다. 기존 환경 변수의 경로는 삭제를 해주었으니 말입니다.

---

😀 Solution

그러면, '현재 가상 환경 내부의 파일 중에 파이썬에 관하여 관리를 하고 있는 파일이 있을 것이다'라는 가설을 내세웠습니다.

 

다른 가설: '가상 환경의 python.exe는 심볼릭링크다.'

이전에는 'python.exe 파일이 심볼릭링크 파일일 것이다.'는 가설을 세우고 접근했지만, venv 공식 문서에서는 그걸 추천하지 않을뿐더러 의도적으로 모든 파일이 심볼릭링크가 되게끔 만들려고 했는데 심볼릭링크로는 만들 수 없다는 에러가 발생되어 이 가설은 틀렸다고 판단했습니다.

 

그래서, 찾아보니 가상 환경 디렉터리 내부에 pyvenv.cfg라는 파일에서 이런 내용이 담긴 것을 발견했습니다. 

home = C:\Users\user\anaconda3
include-system-site-packages = false
version = 3.10.9

여기서 home은 해당 가상 환경에서 사용하는 파이썬이 어디에 위치해 있는가를 나타낸 경로입니다. 위에서 에러가 발생한 경로와 같은 경로입니다. 즉, 이 파일에서 원래 파이썬 경로를 참조하고 있다는 것을 알 수 있습니다.

 

하지만, 여기서 더 의문이 생깁니다. '가상 환경에서 사용하는 파이썬은 심볼릭링크가 아니라고 판단이 되는데, 왜 여전히 원본 파이썬의 경로를 참조해야만 하는가?'인데 이것은 풀리지는 않았습니다. 단, 여전히 원래 경로의 파이썬을 참조를 해야 한다는 사실만은 알고 있어야 합니다.

 

추가적으로, include-system-site-packages는 시스템 전역(base 환경)에 설치된 라이브러리들을 사용할 것이냐를 묻는 것인데 패키지의 독립성을 보장하기 위해서라면, 기본적으로 false에 두어야 합니다.

 

그리고, 마지막으로 version은 참조하는 파이썬의 버전입니다.

 

결론적으로, 이러한 pyvenv.cfg 파일의 내용에 기반하여 새롭게 설치한 파이썬의 경로와 버전에 맞게끔 아래와 같이 재설정해주면, 기존 가상 환경의 파이썬이 새로운 파이썬을 찾아 실행하는 것을 볼 수 있습니다.

home = C:\Python\Python312
include-system-site-packages = false
version = 3.12.4

python test.py
>>> Hello World

하지만, 이렇게 가상 환경이 바뀔 때 파이썬의 버전만을 바꾸는 것은 조금 위험할 수도 있습니다. 파이썬 버전 자체에 의존하여 작동하는 패키지들이 있을 수 있기 때문에 requirements.txt를 추출해서 따로 관리를 하는 것이 조금 더 바람직합니다.