<div id="readability-page-1" class="page"><article><div id="contents_list"><h2 id="section">목차</h2><ul><li><a href="#개요">개요</a></li><li><a href="#pyenv-설치">pyenv 설치</a></li><li><a href="#pyenv-virtualenv-설치">pyenv-virtualenv 설치</a></li><li><a href="#python-버전-리스트">Python 버전 리스트</a></li><li><a href="#python-399-설치">Python 3.9.9 설치</a></li><li><a href="#pyenv-versions">pyenv versions</a></li><li><a href="#pyenv-version">pyenv version</a></li><li><a href="#설치한-python-버전-사용하기">설치한 Python 버전 사용하기</a></li><li><a href="#python-가상-환경-생성">Python 가상 환경 생성</a></li><li><a href="#python-version-파일">.python-version 파일</a></li><li><a href="#python-버전-삭제하기">Python 버전 삭제하기</a></li><li><a href="#완료">완료</a></li></ul></div><h2 id="개요">개요</h2><p>여러 Python 프로젝트를 하나의 머신(PC)에서 개발하다보면, 각각의 프로젝트에서 사용하는 Python 버전에 따라 개발 환경을 구축해야할 경우가 있습니다.</p><p>이때, 매번 Python을 지우고 해당 프로젝트에 필요한 Python 버전을 설치할 수는 없습니다. 이번 블로그 포스트에서는 <code>pyenv</code>를 사용하여 하나의 머신에서 다양한 Python 버전을 설치하고 관리하는 방법에 대해서 알아보도록 하겠습니다.</p><ul><li>pyenv: <a href="https://github.com/pyenv/pyenv" rel="nofollow noreferrer" target="_blank">https://github.com/pyenv/pyenv</a></li></ul><h2 id="pyenv-설치">pyenv 설치</h2><p>다음 명령어를 사용하여 <code>pyenv</code>를 설치합니다.</p><ul><li>macOS: <code>brew install pyenv</code></li><li>Windows: <code>choco install pyenv-win</code></li></ul><p><code>macOS</code>인 경우, <code>.zshrc</code> 파일을 열고 다음과 같은 내용을 추가합니다.</p><div><pre><code><span># code ~/.zshrc</span>
...
<span># pyenv setting</span>
<span>eval</span> <span>"</span><span>$(</span>pyenv init <span>--path</span><span>)</span><span>"</span>
<span>eval</span> <span>"</span><span>$(</span>pyenv init -<span>)</span><span>"</span>
</code></pre></div><h2 id="pyenv-virtualenv-설치">pyenv-virtualenv 설치</h2><p><code>pyenv-virtualenv</code>는 <code>pyenv</code>의 플러그인으로 Python의 가상 환경을 만들 수 있게 도와주는 플러그인입니다.</p><ul><li>pyenv-virtualenv: <a href="https://github.com/pyenv/pyenv-virtualenv" rel="noopener" target="_blank">https://github.com/pyenv/pyenv-virtualenv</a></li></ul><p>그럼 다음 명령어를 실행하여 <code>pyenv-virtualenv</code>를 설치합니다.</p><ul><li>macOS: <code>brew install pyenv-virtualenv</code></li><li>Windows: <code>pip install pyenv-virtualenv</code></li></ul><p><code>macOS</code>인 경우, <code>.zshrc</code> 파일을 열고 다음과 같은 내용을 추가합니다.</p><div><pre><code><span># code ~/.zshrc</span>
...
<span># pyenv-virtualenv setting</span>
<span>eval</span> <span>"</span><span>$(</span>pyenv virtualenv-init -<span>)</span><span>"</span>
</code></pre></div><h2 id="python-버전-리스트">Python 버전 리스트</h2><p>다음 명령어를 실행하여 <code>pyenv</code>로 설치 가능한 Python 버전을 확인합니다.</p><p>그럼 다음과 같이 설치 가능한 Python의 버전 리스트를 확인할 수 있습니다.</p><div><pre><code>...
stackless-3.2.5
stackless-3.3.5
stackless-3.3.7
stackless-3.4-dev
stackless-3.4.2
stackless-3.4.7
stackless-3.5.4
stackless-3.7.5
</code></pre></div><h2 id="python-399-설치">Python 3.9.9 설치</h2><p>이번 블로그 포스트에서는 <code>Python 3.9.9</code> 버전을 설치해 보도록 하겠습니다. 다음 명령어를 실행하여 <code>Python 3.9.9</code> 버전을 설치합니다.</p><h2 id="pyenv-versions">pyenv versions</h2><p>설치가 완료되었다면, 다음 명령어를 실행하여 설치된 Python 버전을 확인합니다.</p><p>그럼 다음과 같이 방금 설치한 <code>Python 3.9.9</code>를 확인할 수 있습니다.</p><div><pre><code><span>*</span> system <span>(</span><span>set </span>by /.pyenv/version<span>)</span>
  3.9.9
</code></pre></div><h2 id="pyenv-version">pyenv version</h2><p>다음 명령어를 실행하면 현재 사용중인 Python 버전을 확인할 수 있습니다.</p><p>그럼 다음과 같이 현재 사용중인 버전을 확인할 수 있습니다.</p><div><pre><code>system <span>(</span><span>set </span>by /Users/dev-yakuza/.pyenv/version<span>)</span>
</code></pre></div><h2 id="설치한-python-버전-사용하기">설치한 Python 버전 사용하기</h2><p>이제 <code>pyenv</code>로 설치한 Python 버전을 사용하는 방법에 대해서 알아봅시다. 다음 명령어를 실행하면 <code>Python 3.9.9</code>를 전역적으로 사용할 수 있습니다.</p><p>다음 명령어를 사용하면 현재 프로젝트에만 적용할 수 있습니다.</p><p>이 명령어는 <code>.python-version</code> 파일을 생성하고 개발 환경에 <code>pyenv</code>가 활성화되어 있는 경우, 자동으로 해당 버전을 사용하도록 변경해 줍니다.</p><p>다음 명령어를 사용하면 현재 <code>shell</code>에서만 해당 버전을 사용할 수 있습니다.</p><h2 id="python-가상-환경-생성">Python 가상 환경 생성</h2><p>여러 프로젝트가 동일한 Python 버전을 사용하지만, 설치하는 라이브러리의 버전이 다를 수 있습니다. 이럴 경우, 의도하지 않은 버전의 라이브러리가 사용되어 문제를 발생 시킬 수 있습니다.</p><p>이럴 때, 동일한 버전의 Python을 사용하여 각각의 프로젝트용 가상 환경을 만들고, 그 가상 환경위에서 개발을 하면 이 문제를 해결할 수 있습니다.</p><p>그럼 <code>pyenv-virtualenv</code>을 사용하여 가상 환경을 만들어 봅시다. 다음 명령어를 사용하여 Python 가상 환경을 생성합니다.</p><div><pre><code><span># pyenv virtualenv VERSION NAME</span>
pyenv virtualenv 3.9.9 venv
</code></pre></div><p>생성이 완료되었다면 다음 명령어를 사용하여 Python 가상 환경이 잘 생성되었는지 확인합니다.</p><p>그럼 다음과 같이 가상 환경이 잘 생성된 것을 확인할 수 있습니다.</p><div><pre><code><span>*</span> system <span>(</span><span>set </span>by /.pyenv/version<span>)</span>
  3.9.9
  3.9.9/envs/venv
  venv
</code></pre></div><p>이제 다음 명령어를 사용하여 <code>pyenv-virtualenv</code>로 생성한 가상 환경을 활성화 시켜봅니다.</p><p>그런 다음 다시 다음 명령어를 실행하여 가상 환경이 활성화되었는지 확인해 봅니다.</p><p>문제가 없다면 다음과 같이 가상 환경이 잘 활성화된 것을 확인할 수 있습니다.</p><div><pre><code>  system
  3.9.9
  3.9.9/envs/venv
<span>*</span> venv <span>(</span><span>set </span>by PYENV_VERSION environment variable<span>)</span>
</code></pre></div><p>가상 환경위에서 모든 작업을 끝냈다면, 다음 명령어를 실행하여 가상 환경을 비활성화시킬 수 있습니다.</p><p>다시 다음 명령어를 실행하여 가상 환경이 잘 비활성화되었는지 확인해 봅니다.</p><p>그럼 다음과 같이 가상 환경이 비활성화된 것을 확인할 수 있습니다.</p><div><pre><code><span>*</span> system <span>(</span><span>set </span>by /.pyenv/version<span>)</span>
  3.9.9
  3.9.9/envs/venv
  venv
</code></pre></div><h2 id="python-version-파일">.python-version 파일</h2><p>앞서 <code>pyenv local</code> 명령어를 실행하면 자동으로 <code>.python-version</code> 파일이 생성되는 것을 확인할 수 있었습니다. 이를 통해, <code>pyenv</code>를 사용하는 개발 환경에서는 자동으로 <code>Python</code>의 버전을 변경해 줍니다. 만약 해당 Python 버전이 없는 경우 다음 명령어를 사용하여 <code>.python-version</code>에 작성된 Python 버전을 설치할 수 있습니다.</p><p>그러므로 이 <code>.python-version</code> 파일을 사용하면 해당 프로젝트를 실행하기 위한 Python의 버전을 공유할 수 있습니다. 만약, 현재 프로젝트의 <code>.python-version</code> 파일이 없는 경우, <code>.python-version</code> 파일을 만들고 다음과 같이 해당 프로젝트에서 필요로 하는 Python의 버전을 작성합니다.</p><h2 id="python-버전-삭제하기">Python 버전 삭제하기</h2><p>머신에서 더이상 사용하지 않는 Python 버전이나 Python 가상 환경이 있는 경우, 다음 명령어를 사용하여 해당 버전(가상 환경)을 제거할 수 있습니다.</p><div><pre><code>pyenv uninstall 3.9.9
<span># pyenv uninstall venv</span>
</code></pre></div><h2 id="완료">완료</h2><p>이것으로 <code>pyenv</code>를 사용하여 동일한 머신에 다양한 Python 버전을 사용하는 방법에 대해서 알아보았습니다. 또한 <code>pyenv-virtualenv</code> 플러그인을 사용하여 Python의 가상 환경을 구성하는 방법에 대해서도 알아보았습니다. 만약, 여러분이 다양한 Python 버전의 개발 환경이 필요한 경우 <code>pyenv</code>를 사용하여 버전 관리를 해보시길 바랍니다.</p><p><code> 제 블로그가 도움이 되셨나요? 하단의 댓글을 달아주시면 저에게 큰 힘이 됩니다! </code></p><h2>앱 홍보</h2><div><p> 지금 보고 계신 블로그를 작성하는 <code>Deku</code>가 개발한 앱을 한번 사용해보세요.<br><code>Deku</code>가 개발한 앱은 Flutter로 개발되었습니다.</p><p> 관심있으신 분들은 앱을 다운로드하여 사용해 주시면 정말 감사하겠습니다.</p></div><h2>책 홍보</h2></article></div>

dev-yakuza

동일한 머신에서 여러 Python 버전을 사용하기 위해 pyenv를 사용하는 방법에 대해서 알아보겠습니다.

pyenv를 사용하여 Python 버전 관리하기

댓글