VS Code에서 파이썬 인터프리터 선택하는 방법: 실행 안 될 때 함께 확인

VS Code에서 파이썬 파일은 열리는데 실행 결과가 이상하거나, 설치한 패키지가 안 보인다면 가장 먼저 확인해야 할 것은 현재 선택된 인터프리터입니다. 이 글에서는 VS Code에서 올바른 파이썬 인터프리터를 고르는 방법과 자주 생기는 문제를 정리합니다.

왜 인터프리터 선택이 중요한가

컴퓨터에 파이썬이 하나만 있는 경우보다 여러 버전이나 가상환경이 함께 있는 경우가 더 많습니다. VS Code가 다른 인터프리터를 보고 있으면 pip install한 패키지가 안 보이거나 실행 버전이 달라집니다.

가장 빠른 선택 방법

1. VS Code에서 파이썬 파일 열기
2. Ctrl + Shift + P 누르기
3. Python: Select Interpreter 입력
4. 프로젝트에 맞는 인터프리터 선택

보통 경로와 버전이 함께 표시되므로, 시스템 파이썬인지 가상환경인지 같이 확인할 수 있습니다.

상태 표시줄에서도 확인 가능

VS Code 하단 상태 표시줄에 현재 파이썬 버전이 보이면 그 항목을 클릭해 인터프리터를 바꿀 수 있습니다.

가상환경을 쓰는 프로젝트라면

프로젝트 폴더 안의 .venv 또는 venv 인터프리터를 선택하는 것이 일반적입니다.

.venv/Scripts/python.exe
.venv/bin/python

운영체제에 따라 경로 형태는 달라지지만 핵심은 프로젝트 전용 파이썬을 선택하는 것입니다.

선택했는데도 실행이 이상할 때

1. Python 확장이 설치되지 않은 경우

VS Code의 공식 Python 확장이 없으면 인터프리터 선택 기능이 제한될 수 있습니다.

2. 터미널과 에디터가 다른 환경을 보는 경우

선택한 인터프리터와 통합 터미널의 환경이 다를 수 있습니다. 새 터미널을 열거나 VS Code를 다시 시작해 반영 상태를 확인합니다.

3. 패키지는 설치했는데 import 오류가 나는 경우

현재 선택된 인터프리터에서 아래 명령어로 패키지 설치 위치를 다시 확인합니다.

python -m pip --version
python -m pip list

추천 점검 순서

1. 현재 인터프리터 확인
2. 터미널에서 python --version 확인
3. python -m pip --version 확인
4. 가상환경 경로가 프로젝트와 맞는지 확인

정리

• VS Code 실행 오류의 상당수는 인터프리터 불일치 문제
• 명령 팔레트의 Python: Select Interpreter가 가장 빠른 해결 경로
• 가상환경 프로젝트는 프로젝트 전용 인터프리터를 써야 함
• pip 위치까지 함께 확인해야 혼동이 줄어듦

이후에는 pip 설치 위치 확인, 가상환경 만드는 법, python 명령어가 안 될 때 해결로 이어가면 초보자 검색 흐름이 자연스럽게 연결됩니다.