Setting | 파이썬 가상 환경 관리를 위한 miniconda3 설치 및 가상 환경 생성

이 글은 파이썬 가상 환경 관리를 할 수 있는 miniconda3를 설치하고 세팅하는 방법에 대해 정리한 글이다.

 

가상 환경을 이용하여 파이썬을 관리하는 이유는 여러 라이브러리가 서로 충돌을 일으키지 않도록 하기 위함과 라이브러리에 따라 지원하는 파이썬의 버전이 다르기 때문이며, 이로 인해 효율적으로 프로젝트를 관리하기 위해서 가상 환경을 사용하는 것이 좋다.

 

세팅을 진행하는 컴퓨터는 Windows 11 Pro 운영체제를 사용하고 있으며, 버전은 23H2이다.

---

miniconda3 설치

아래 링크로 접속하여 miniconda3 설치 파일을 다운받는다. 작성일(24.03.22.)을 기준으로 최신 버전은 24.1.2 버전이며 파이썬 3.12.1까지 지원한다.

https://docs.anaconda.com/free/miniconda/index.html

Miniconda — Anaconda documentation

설치 파일을 받았으면 관리자 권한으로 실행하여 설치를 진행한다.

Installation Type 선택 창이 뜨면 Just Me로 변경하고 다음을 누른다.

계속 진행하다가 Install 직전에 나오는 체크 박스 4개를 모두 체크한 후 Install을 진행한다. Add Miniconda3 to my PATH environment variable을 체크하는 이유는 PowerShell이나 cmd에서 conda 명령어를 사용할 수 있도록 하기 위함이다. 별도의 miniconda prompt만 사용할 것이라면 체크하지 않아도 무방하다.

설치가 완료되면 Finish 버튼을 눌러서 완료하면 된다

---

PowerShell 설정

PowerShell에서 conda 명령어를 이용하여 파이썬 가상환경 관리를 하기 위해 몇 가지 작업을 거쳐야 한다. 현재 PowerShell에서 conda 명령어를 통해 base 가상환경을 실행하면 아래와 같이 환경이 실행된건지 아닌지, 혹은 어느 가상환경에 접속 중인지 알 수 있는 정보가 전혀 없다.

PowerShell을 열고 conda init 명령어를 입력한다. conda 명령어를 사용할 수 있도록 초기화하는 작업이라고 생각하면 된다. 만약 오류가 발생한다면 PowerShell 혹은 터미널을 관리자권한으로 실행한 후 다시 시도해보자.

실행이 되었다면, PowerShell을 종료한 후 다시 실행한다. 그럼 아래와 같은 오류를 볼 수 있는데, 이는 실행 정책(실행 규칙)이 변경되면서 발생하는 오류이다.

PowerShell에서 아래 명령어를 실행한 후 (에러가 발생하면 관리자 권한으로 실행한 후 재시도)

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

다시 PowerShell을 껐다가 키면 현재 실행 중인 (혹은 현재 접속되어 있는) 가상환경의 이름이 앞에 뜨게 된다.

기본적으로 PowerShell을 실행하면 base 가상 환경이 자동으로 활성화되는데, 이게 싫은 사람들은 아래 설정을 이어서 해주면 된다.

 

위와 같이 가상환경이 실행되어 있는 상태에서 아래 명령어를 입력하여 가상 환경 자동활성화를 해제할 수 있다.

conda config --set auto_activate_base false

---

가상 환경 생성 및 실행

가상 환경을 생성하고 실행해볼 차례이다. 가상 환경을 생성할 때에는 기본적으로 base 가상 환경이 실행되어 있는 상태여야 한다. conda 명령어를 통해 생성하는 가상 환경은 base 가상환경을 상속받아 생성된다. 그래서 매번 가상 환경에서 설치하는 라이브러리나 패키지는 base 가상 환경에 설치해두는 것도 방법이다. 하지만 이렇게 세팅하는 경우, 용량이 커지고 라이브러리나 패키지가 많아지는 경우 관리가 힘들어진다는 단점이 있다.

 

base 가상 환경은 아래 명령어를 이용하여 실행할 수 있다.

conda activate base

conda activate env-name 명령어는 가상 환경을 실행할 때마다 실행하는 명령어니 기억해두면 좋다.

 

새로운 가상 환경을 생성할 때에는 base 가상 환경이 실행되어 있는 상태에서 아래 명령어를 통해 생성할 수 있다.

conda create -n my-env python=3.12.1

가상 환경을 생성할 때에는 conda create 명령어를 사용하며, 위 명령어는 파이썬 버전 3.12.1에 my-env라는 이름을 가진 가상 환경을 생성한다는 의미를 가진다.

 

이렇게 생성한 가상 환경은 아래 명령어를 통해 실행할 수 있다.

conda activate my-env

가상 환경을 종료할 때에는 conda deactivate 명령어를 사용하면 된다.

conda deactivate

 

가상 환경을 실행한 후 설치한 라이브러리와 패키지는 해당 가상 환경에 설치되어 다른 가상 환경이나 가상 환경이 실행되지 않은 상태에서는 사용할 수 없다.

---

요약

• miniconda3는 다음 링크에 접속하여 설치 파일을 받아 설치를 진행할 수 있다.
  • https://docs.anaconda.com/free/miniconda/index.html
• PowerShell에서 conda 명령어를 정상적으로 실행하기 위해서는 conda init 명령어를 실행하여 초기화 한 후, 실행 정책 변경을 위해 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned 명령어를 실행하면 된다.
• 파이썬 가상 환경은 conda create -n env-name python=version을 이용하여 생성할 수 있다.