Python 실행에 필요한 세 가지
| 구성 | 맡는 일 | 준비할 곳 |
|---|---|---|
| VS Code | 파일 편집·실행 명령·디버깅 화면 | VS Code 설치 안내 |
| Python 3 | 실제로 코드를 실행하는 런타임 | Python 공식 다운로드 |
| Python 확장 | 인터프리터 선택·실행·언어 지원 | Microsoft Python 공식 확장 |
Windows의 VS Code 데스크톱을 기준으로 설명합니다. 확장 화면에서는 이름뿐 아니라 게시자가 Microsoft인지 확인하세요. Python Debugger는 Python 확장과 함께 설치되며, 다른 언어용 실행 확장을 추가할 필요는 없습니다.
폴더를 열고 프로젝트 환경 선택하기
- 새 연습 폴더를 만든 뒤
File > Open Folder로 엽니다. 파일 하나만 여는 것보다 프로젝트와 환경을 구분하기 쉽습니다. Ctrl+Shift+P로 명령 팔레트를 열고Python: Create Environment를 실행합니다.Venv를 선택하고 사용할 Python 3 인터프리터를 고릅니다. 생성이 끝나면 프로젝트의.venv폴더를 확인합니다.Python: Select Interpreter를 실행해 이 프로젝트의.venv환경이 선택됐는지 확인합니다. 이미 환경이 있다면 새로 만들지 않고 기존 환경을 선택할 수 있습니다.
목록에 Python이 없으면 Python 3 설치 여부와 인터프리터 위치부터 확인하세요. 편집기를 재시작해도 목록에 나타나지 않을 때는 공식 환경 안내의 인터프리터 경로 지정 방법을 사용합니다. 다른 프로젝트의 환경을 이름만 보고 고르지 말고 전체 경로를 비교하세요.
파일을 저장하고 예상 출력 확인하기
열린 폴더에 total.py를 만들고 다음 코드를 저장하세요. 금액을 더하는 자체 연습 예시입니다.
import sys
items = [("키보드", 35000), ("마우스", 18000)]
total = sum(price for _, price in items)
print(sys.executable)
print(f"합계 {total:,}원")
편집기 오른쪽 위의 Run Python File을 누릅니다. 여러 실행 확장이 설치돼 버튼이 헷갈리면 파일 안에서 마우스 오른쪽 버튼을 누르고 Run Python > Run Python File in Terminal을 선택하세요.
터미널에는 실행 명령과 결과가 표시됩니다. 첫 줄은 선택한 Python 실행 파일의 경로이며, 마지막 줄의 예상 결과는 다음과 같습니다.
합계 53,000원
.venv를 선택했다면 첫 줄의 경로도 해당 프로젝트의 .venv 아래를 가리켜야 합니다. Windows에서는 보통 Scripts/python.exe, macOS·Linux에서는 bin/python 형태입니다. 마지막 금액만 맞고 실행 경로가 다르면 의도한 환경에서 실행한 것이 아닐 수 있습니다.
중단점으로 계산 과정 살펴보기
total = ...줄의 왼쪽 여백을 눌러 중단점을 설정합니다.F5로 디버깅을 시작합니다. 구성을 물으면 Python 디버거에서 현재 Python 파일을 실행하는 구성을 선택합니다.- 해당 줄에서 실행이 멈추면 변수 영역에서
items를 확인합니다. 아직 그 줄을 실행하기 전이므로total값은 계산되지 않았을 수 있습니다. F10으로 다음 줄까지 진행한 뒤total이53000인지 확인합니다.- 계속 실행해 터미널 출력까지 확인합니다. 연습이 끝나면 디버깅을 종료하고 중단점을 해제합니다.
평소 파일 실행과 중단점 디버깅은 목적이 다릅니다. 출력만 확인할 때는 파일 실행을, 어느 줄에서 값이 달라지는지 찾을 때는 디버거를 사용하세요. 이 연습에는 복잡한 launch.json 설정이 필요하지 않습니다.
실행되지 않거나 패키지를 못 찾을 때
| 증상 | 먼저 확인할 것 | 다음 행동 |
|---|---|---|
| 인터프리터를 고르라는 메시지 | Python 3 설치와 프로젝트 환경 | 명령 팔레트에서 인터프리터 경로 선택 |
| 다른 환경의 Python 경로 출력 | 선택된 환경과 이미 열린 터미널 | 인터프리터를 다시 선택하고 새 터미널에서 실행 |
ModuleNotFoundError |
패키지를 설치한 환경과 실행 환경의 일치 | 같은 Python에서 python -m pip --version을 확인하고 필요한 패키지 설치 |
| 수정 전 결과가 나옴 | 파일 저장과 실행한 파일 이름 | 저장 후 현재 파일을 다시 실행 |
| 중단점에서 멈추지 않음 | 일반 실행인지 디버깅인지 | F5로 현재 Python 파일 디버깅 시작 |
패키지가 없다는 메시지에 Python을 다시 설치하는 것부터 시작하지 마세요. sys.executable과 pip 경로가 같은 환경인지 비교하면 환경 불일치를 먼저 가려낼 수 있습니다. 패키지 설치·삭제 자체는 아래 pip 가이드에서 이어갑니다.
목적별 가이드
| 하려는 일 | 가이드 |
|---|---|
| VS Code를 설치하고 한국어로 사용하기 | VS Code 설치·첫 설정 |
| Python 패키지를 설치·삭제하기 | pip 사용법 |
| uv로 프로젝트 환경을 관리하기 | uv 프로젝트·가상환경 |
| 수정한 코드를 이력으로 남기기 | VS Code Git과 첫 커밋 |
참고 자료
2026년 11월 11일 공식 문서를 확인했습니다. 코드는 본문에서 입력하는 자체 예시이며, VS Code의 실제 설치·GUI 디버깅 결과를 제시한 것은 아닙니다.