Windows 코딩

VS Code에서 Python 인터프리터 선택하는 방법

windows4silver 2025. 3. 12. 16:17

VS Code에서 Python 인터프리터 선택하는 방법

Python을 개발하기 위해서는 **Python 인터프리터(실행 환경)**를 선택해야 합니다. 인터프리터는 Python 코드가 실행될 환경을 의미하며, 특정 Python 버전 또는 가상 환경을 선택할 수 있습니다.


1. Python 확장 프로그램 설치

먼저, VS Code에서 Python을 사용하려면 Python 확장 프로그램을 설치해야 합니다.

  • VS Code를 열고 Extensions(확장) 탭 (Ctrl + Shift + X)을 클릭
  • "Python" 을 검색하여 Microsoft에서 제공하는 확장 프로그램을 설치

2. Python 인터프리터 선택하기

Python 확장을 설치한 후, Python 실행 환경을 선택하는 과정입니다.

방법 1: 명령 팔레트 사용

  1. Ctrl + Shift + P 를 눌러 명령 팔레트(Command Palette) 를 엽니다.
  2. Python: Select Interpreter 입력 후 클릭
  3. 사용 가능한 Python 인터프리터 목록이 나타납니다.
  4. 원하는 Python 버전 또는 가상 환경을 선택합니다.

방법 2: 하단의 인터프리터 선택 버튼 사용

  1. VS Code 하단 상태 표시줄에서 Python 버전이 표시된 부분을 클릭
  2. 사용 가능한 Python 환경 목록에서 선택

3. 원하는 인터프리터 선택하기

Python 인터프리터 목록에는 다양한 환경이 있을 수 있습니다.

  • 시스템 기본 Python: C:\Python39\python.exe (Windows) 또는 /usr/bin/python3 (Linux, Mac)
  • 가상 환경(venv, virtualenv): 프로젝트 폴더 내 venv\Scripts\python.exe
  • Anaconda 환경: C:\Users\사용자\anaconda3\python.exe
  • WSL(Windows Subsystem for Linux): WSL 환경 내의 Python 실행

👉 가상 환경을 사용하면 프로젝트별로 독립적인 패키지 관리가 가능하므로 추천됩니다.


4. Python 인터프리터 정상 확인

인터프리터를 선택한 후, VS Code 터미널(Ctrl + ~)을 열고 다음 명령어를 실행해 정상적으로 선택되었는지 확인하세요.

python --version

또는

python -m pip list

올바른 버전이 표시되면 Python 인터프리터 설정이 완료된 것입니다! 🚀


문제 해결 (선택한 인터프리터가 동작하지 않을 때)

Python이 설치되지 않은 경우:

  • Python을 다운로드하여 설치하세요. Python 공식 사이트
  • 설치 후 VS Code를 다시 실행하고 인터프리터를 선택하세요.

목록에 원하는 Python 환경이 나타나지 않는 경우:

  • VS Code에서 Python 확장 프로그램을 다시 설치
  • VS Code를 재시작한 후 Python: Select Interpreter를 다시 실행
  • 가상 환경을 만든 후, python -m venv venv를 실행하여 환경을 활성화

이제 Python 인터프리터를 올바르게 설정하고 VS Code에서 Python 개발을 시작할 수 있습니다!