Visual Studio Code와 Miniconda를 사용한 Python 개발 환경 만들기( Windows, Ubuntu, WSL2)

 Windows와 Ubuntu, WSL2에 Visual Studio Code와 Miniconda를 사용한 Python 개발 환경을 만드는 방법을 다루고 있습니다.

2022. 4. 03  최초작성

2023. 3. 19  

2023. 9. 16  영상 추가

2023. 12. 29 우분투 PATH 설정 관련 수정

2024. 3. 11

2024. 3. 13

2024. 5. 4  

2024. 8. 25  윈도우에서 테스트 진행하여 큰 변화 없었음.

2025. 4. 20  업데이트

2025. 7. 13  가상환경에서 pip와 python 명령이 실행안되는 문제 해결방법 추가

2025. 8. 26 윈도우에서 문제 생겼던게 해결된 것으로 보여 다시 진행.

영상이 편한 분은 아래 영상을 참고하세요. 원도우 기준으로 설명하고 있습니다.  

윈도우에서 파이썬 개발환경 이렇게 만드세요. Visual Studio Code와 Miniconda를 사용한 Python 개발 환경 만들기

https://youtu.be/35wV_Y7c3tg?si=6W6pwD4tfQun3lbB 

1. 윈도우에선 2번을 진행하고 우분투에선 3번을 진행하세요. WSL2는 우분투와 동일하게 진행하면 됩니다.

2. (윈도우에서 Miniconda 설치) 아래 링크에서 Miniconda 설치 파일을 다운로드하여 설치합니다.  

설치 중에 conda 위치를 시스템 변수 PATH에 추가하여 일반 명령 프롬프트에서 사용가능하게 할 수 있지만 Miniconda 공식 문서에서 권장하지 않습니다.

옵션 변경없이 설치를 진행하면 됩니다

https://www.anaconda.com/download/success 

참고로 Miniconda는 최소한의 설치 파일로, 기본적으로 Python, conda 패키지 관리자와 몇 가지 필수 패키지만 포함합니다. 반면 Anaconda는 수백 개의 과학 패키지가 사전 설치된 대용량 배포판입니다.

윈도우키를 누르고 anaconda를 입력시 보이는 Anaconda Prompt를 실행시킵니다.

4번을 진행합니다.

3. (Ubuntu에서 Miniconda 설치) 설치를 할 때 사용할 최신버전 설치 쉘스크립트를 다운로드합니다.

$ wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

쉘스크립트의 퍼미션을 실행가능하도록 변경합니다.

$ chmod +x Miniconda3-latest-Linux-x86_64.sh

쉘 스크립트 실행하여 설치합니다.

$ ./Miniconda3-latest-Linux-x86_64.sh

엔터를 누릅니다.

q를 누릅니다.

yes 입력 후 엔터를 누릅니다.

엔터를 누릅니다.

yes 입력 후 엔터를 누릅니다.

설치가 완료되었습니다.

Ctrl + Alt + T를 눌러 터미널을 새로 엽니다. 다음처럼 프롬프트 앞에 (base)가 추가된 것을 볼 수 있습니다.  다음처럼 현재 사용가능한 파이썬이 miniconda의 것임을 알 수 있습니다. 파이썬의 설치된 경로에 miniconda3 디렉토리가 포함되어 있습니다.

 (base) webnautes@webnautes-laptop:~$ python

Python 3.11.5 (main, Sep 11 2023, 13:54:46) [GCC 11.2.0] on linux

Type "help", "copyright", "credits" or "license" for more information.

>>> import sys

>>> sys.executable

'/home/webnautes/miniconda3/bin/python'

>>> quit()

(base) webnautes@webnautes-laptop:~$

4. 윈도우와 우분투 공통적으로 진행하세요.

conda를 사용하여 파이썬 가상환경을 생성합니다. 다음 예는 python 3.8을 사용하는 newenv라는 이름의 파이썬 가상환경을 만듭니다.

conda create -n newenv python=3.8

environment location에 가상환경관련 설정 파일과 설치되는 패키지들이 위치하게 됩니다.

경로를 변경가능할 수 있는 방법도 있지만 굳이 바꿀 필요는 없습니다.

리스트로 명시된 패키지들이 추가로 설치됩니다. Python 3.8이 포함되어 있는 것을 볼 수 있습니다.

y를 입력 안하고 엔터만 눌러도 설치가 시작됩니다.

다음 처럼 보이면 newenv라는 이름의 가상환경이 생성된 것입니다. 해당 가상환경을 활성화하는 방법과 비활성화 하는 방법을 알려주고 있습니다.

다음 명령으로 newenv 가상환경이 추가된 것을 볼 수 있습니다.

현재 사용중인 가상환경은 base입니다. 출력 결과에 *로 표시해주고 있고 명령 프롬프트 앞쪽에 (base)라고 표시한 것을 봐도 알 수 있습니다.

두번째 항목으로 있는 경로는 파이썬 패키지들이 설치되는 경로입니다.

conda env list

newenv 가상환경을 활성화 해봅니다. 괄호안에 가상환경이름이 newenv로 변경됩니다.

conda activate newenv

현재 사용중인 가상환경을 확인해봅니다. * 표시가 newenv로 변경되었습니다.

설치된 패키지 목록을 확인해봅니다.

앞에서 지정한 python 3.8이 설치된 것을 볼 수 있습니다.

현재 사용가능한 python의 버전을 다음처럼 확인할 수 있습니다.

다음처럼 newenv 가상환경을 비활성화하면 다시 base 가상환경으로 돌아옵니다.

conda deactivate

참고로 다음처럼  newenv라는 이름의 가상환경을 삭제할 수 있습니다.

conda env remove -n newenv

5. Visual Studio Code를 설치합니다.

Visual Studio Code와 Miniconda를 사용한 Python 개발 환경 만들기( Windows, Ubuntu, WSL2)

https://ilkemomo.blogspot.com/2025/09/visual-studio-code-windows-ubuntu-apple.html 

6. Visual Studio Code를 실행한 후,  Explorer(탐색) 버튼을 클린 후, Open Folder(폴더 열기) 버튼을 선택합니다.

원하는 위치에 원하는 폴더를 생성하고 해당 폴더로 이동한 후, 폴더 선택을 클릭합니다.

다음처럼 해당 폴더가 Visual Studio Code 왼쪽에 보이게 됩니다.  새파일 아이콘을 클릭합니다.

입력란이 보이게 되는데 hello.py를 입력 후, 엔터를 누르면 해당 파일이 추가되면서 오른쪽에 hello.py 파일이 열리게 됩니다.

오른쪽 아래에 Python 확장을 설치하는지 물어보는 메시지 박스가 보이면 설치를 클릭 합니다.

만약 보이지 않는다면 아래 스크린샷처럼 왼쪽에 보이는 확장 아이콘을 클릭 후 python을 검색합니다. 검색 결과에서 Python 항목에 보이는 Install을 클릭하여 설치합니다.

7.  윈도우의 경우 진행합니다. 우분투에선 8번부터 진행하세요.

메뉴에서 View(보기) > Terminal(터미널)을 선택합니다. 다음처럼 PowerShell이 실행되면  Conda의 가상환경이 적용되지 않기 때문에 명령 프롬프트(cmd.exe)를 사용하도록 변경해줘야 합니다.

Ctrl + Shift + P를 입력한 후,  default profile을 입력하여 검색되는 항목을 선택합니다.

Command Prompt를 선택합니다.

현재 터미널이 열려있다면 오른쪽에 보이는 쓰레기통 아이콘을 클릭하여 닫아줍니다.

다시 메뉴에서 View > Terminal을 선택하면 명령 프롬프트가 실행됩니다.

 

8. Conda에서 생성한 가상환경의 인터프리터로 변경해야 합니다.

Ctrl + Shift +P를 누른 후, interpreter를 입력하여 검색되는 다음 항목을 선택합니다.

앞에서 만든 가상환경  newenv가 포함된 Python 3.8 (‘newenv’:conda) 항목을 선택합니다. 새로운 폴더를 열었을때에도 가상환경 newenv를 사용할 수 있습니다.

올바르게 인터프리터가 설정이 되었는지 확인해봅니다.  오른쪽 아래에 (newenv)가 보여야합니다.

현재 터미널이 열려있다면 오른쪽에 보이는 쓰레기통 아이콘을 클릭하여 닫아줍니다.

 메뉴에서  보기 > 터미널(View > Terminal)을 선택합니다.  다음처럼 (newenv)가 현재 경로 앞에 보여야 합니다.

새로운 프로젝트를 위해 새로운 파이썬 폴더를 생성했어도 지금 방법으로 똑같은 파이썬 가상 환경을 선택하여 사용할 수 있습니다.

9. 테스트해보기 위해 vscode의 터미널에서 다음 명령으로  Numpy 패키지를 설치합니다.

pip install numpy

9. 다음 코드를 입력합니다.  numpy 패키지를 설치했지만 다음처럼  numpy 부분이 초록색으로 보이지 않고 노란줄이 그어질 수도 있습니다. 패키지 설치된 것이 아직 감지되지 않은 것입니다.  시간이 지나면 초록색으로 변합니다.

import numpy as np a = np.array([1, 2, 3]) print(a)

10. 오른쪽 위에 보이는 Run Python File 아이콘을 클릭합니다.

11. 실행 결과 [ 1 2 3]이 다음처럼 보여집니다.

참고

https://docs.anaconda.com/anaconda/install/windows/