VSCode에서 Python 실행 안 될 때 해결 방법 (환경변수 오류 포함)

📌 문제 상황

VSCode에서 Python 코드를 실행하려고 했는데 아래와 같은 문제가 발생하는 경우가 있다.

• python is not recognized as an internal or external command
• 실행 버튼을 눌러도 아무 반응 없음
• 터미널에서 Python 실행이 안 됨

초보 개발자라면 거의 한 번은 겪는 대표적인 오류다.

---

📌 원인 정리

이 문제는 대부분 아래 3가지 중 하나다.

1. Python이 설치되지 않음
2. 환경변수(PATH)가 설정되지 않음
3. VSCode에서 Python 인터프리터 선택이 안 됨

---

✅ 해결 방법 1: Python 설치 확인하기

먼저 Python이 설치되어 있는지 확인해야 한다.

✔ 확인 방법

터미널(CMD 또는 PowerShell)에서 아래 명령어 입력:

python --version

또는

python3 --version

👉 결과가 나오지 않으면 Python이 설치되지 않은 상태다.

✔ 해결 방법

• Python 공식 홈페이지에서 설치
• 설치 시 “Add Python to PATH” 체크 필수

---

✅ 해결 방법 2: 환경변수(PATH) 설정하기

Python이 설치되어 있어도 환경변수가 설정되지 않으면 실행되지 않는다.

✔ 설정 방법 (Windows 기준)

1. 시작 메뉴 → “환경 변수” 검색
2. “시스템 환경 변수 편집” 클릭
3. “환경 변수” 버튼 클릭
4. “Path” 선택 → 편집
5. 아래 경로 추가

C:\PythonXX\
C:\PythonXX\Scripts\

※ Python 설치 경로에 따라 다름

👉 설정 후 반드시 VSCode 재시작

---

✅ 해결 방법 3: VSCode에서 Python 인터프리터 설정

VSCode는 어떤 Python을 사용할지 직접 지정해야 한다.

✔ 설정 방법

1. VSCode 실행
2. Ctrl + Shift + P 입력
3. “Python: Select Interpreter” 선택
4. 설치된 Python 버전 선택

👉 선택 안 되어 있으면 실행 안 됨

---

✅ 해결 방법 4: 확장 프로그램 설치 확인

VSCode에서 Python 실행하려면 확장이 필요하다.

✔ 확인 방법

• 왼쪽 Extensions 탭 클릭
• “Python” 검색 후 설치

👉 Microsoft에서 만든 Python 확장 사용

---

🔥 추가 팁

• Python 설치 후 VSCode 재시작은 필수
• 여러 Python 버전 설치 시 충돌 가능
• 가상환경(venv) 사용 시 인터프리터 다시 지정해야 함

---

📌 마무리

VSCode에서 Python이 실행되지 않는 문제는 대부분
👉 환경변수 설정 + 인터프리터 선택 문제다.

위 방법대로 하나씩 확인하면 대부분 해결된다.