VS Code에서 파이썬 시작하기

VS Code만 설치했다고 파이썬 코드가 바로 실행되는 것은 아닙니다. 처음 설정할 때 가장 많이 헷갈리는 이유는 세 가지 프로그램이 서로 다른 역할을 하기 때문입니다.

• Python 인터프리터: 작성한 파이썬 코드를 실제로 실행합니다.
• Visual Studio Code: 파일과 폴더를 열고 코드를 작성하는 편집기입니다.
• Microsoft Python 확장: VS Code가 설치된 Python을 찾아 실행·자동 완성·디버깅 기능과 연결하도록 돕습니다.

이 세 가지를 모두 준비하고 올바른 인터프리터를 선택해야 합니다. 아래 순서는 Windows 10·11 기준이며, 프로그램 버전에 따라 버튼 이름과 위치가 조금 달라질 수 있습니다.

1. Python을 먼저 설치합니다

1. Python 공식 Windows 다운로드 페이지에서 현재 지원되는 Python 3 설치 파일을 받습니다.
2. 설치 안내에 따라 Python을 설치합니다. 학원이나 공용 PC처럼 관리자 권한이 제한된 환경에서는 담당자에게 설치를 요청하세요.
3. 설치가 끝나면 열려 있던 터미널과 VS Code를 모두 닫았다가 다시 엽니다. 실행 중인 프로그램은 새로 설치된 경로를 바로 인식하지 못할 수 있습니다.

2. VS Code와 Python 확장을 설치합니다

1. VS Code 공식 다운로드 페이지에서 Windows용 설치 파일을 받아 설치합니다.
2. VS Code를 열고 왼쪽 활동 표시줄에서 블록 모양의 Extensions 아이콘을 누릅니다.
3. 검색창에 Python을 입력하고 게시자가 Microsoft인 Python 확장을 설치합니다.
4. Python 확장을 설치하면 Python Debugger 확장도 함께 설치됐는지 Installed 목록에서 확인합니다.

이름이 비슷한 확장이 많으므로 게시자를 확인하는 것이 중요합니다. 처음에는 여러 확장을 한꺼번에 설치하지 말고 공식 Python 확장으로 기본 실행 환경부터 확인하는 편이 좋습니다.

3. 파일 하나가 아니라 작업 폴더를 엽니다

1. 문서처럼 찾기 쉬운 위치에 python-study 폴더를 만듭니다.
2. VS Code에서 File → Open Folder를 선택하고 방금 만든 폴더를 엽니다.
3. 왼쪽 Explorer에서 새 파일을 만들고 이름을 hello.py로 지정합니다.
4. 파일에 다음 코드를 입력하고 Ctrl+S로 저장합니다.

message = "Hello, Python!"
print(message)

파일만 하나씩 여는 것보다 폴더를 작업 공간으로 열어야 탐색기와 터미널의 기준 경로가 같아지고, 나중에 여러 파일과 디버깅 설정을 함께 관리하기 쉽습니다.

4. 실행할 Python 인터프리터를 선택합니다

1. Ctrl+Shift+P를 눌러 명령 팔레트를 엽니다.
2. Python: Select Interpreter를 검색해 선택합니다.
3. 목록에서 설치한 Python 3 버전을 선택합니다.
4. 화면 아래 상태 표시줄에 선택한 Python 버전이 나타나는지 확인합니다.

Python이 여러 개 설치된 PC에서는 이 단계가 특히 중요합니다. 선택한 인터프리터는 코드 실행뿐 아니라 자동 완성, 라이브러리 인식과 디버깅에도 사용됩니다.

5. 첫 파이썬 파일을 실행합니다

hello.py를 연 상태에서 편집기 오른쪽 위의 실행 버튼을 누르고 Run Python File in Terminal을 선택합니다. 아래쪽 터미널에 다음 결과가 나타나면 기본 설정이 완료된 것입니다.

Hello, Python!

실행 버튼이 보이지 않거나 다른 언어로 인식된다면 파일 이름이 반드시 .py로 끝나는지, Microsoft Python 확장이 활성화되어 있는지 확인하세요.

6. 중단점을 만들고 한 줄씩 실행해 봅니다

다음 코드로 바꾼 뒤 줄 번호 왼쪽 여백을 눌러 total = total + number 줄에 빨간 중단점을 만듭니다.

total = 0
for number in range(1, 4):
    total = total + number

print(total)

1. F5를 눌러 디버깅을 시작합니다.
2. 처음 실행할 때 환경을 묻는다면 Python File을 선택합니다.
3. 프로그램이 중단점에서 멈추면 왼쪽 Variables 영역에서 number와 total의 값을 확인합니다.
4. F10으로 한 줄씩 진행하며 값이 어떻게 바뀌는지 살펴봅니다.
5. F5로 계속 실행하거나 Shift+F5로 디버깅을 종료합니다.

디버깅은 오류가 생겼을 때만 사용하는 기능이 아닙니다. 반복문이 몇 번 실행되는지, 조건에 따라 어떤 줄로 이동하는지 확인하면 코드를 읽고 이해하는 연습에도 도움이 됩니다.

설정이 되지 않을 때 확인할 점

Python 인터프리터가 목록에 없습니다

Python 설치를 마친 뒤 VS Code를 완전히 종료하고 다시 실행하세요. 그래도 나타나지 않으면 명령 팔레트의 Python: Select Interpreter에서 경로를 직접 찾거나 Python 설치 상태를 먼저 확인합니다.

실행했는데 다른 버전의 Python이 사용됩니다

화면 아래 상태 표시줄의 Python 버전을 눌러 현재 작업 폴더에 사용할 인터프리터를 다시 선택합니다. 터미널을 새로 열어야 변경된 환경이 반영될 수도 있습니다.

Python 확장은 있는데 디버깅이 시작되지 않습니다

Extensions의 Installed 목록에서 Python Debugger가 설치되고 활성화되어 있는지 확인합니다. 파일을 저장한 뒤 .py 파일이 열린 상태에서 다시 시도하세요.

F5를 누르면 소리나 화면 밝기가 바뀝니다

노트북에서는 기능 키가 기기 제어에 우선 사용될 수 있습니다. 이 경우 Fn+F5를 사용하거나 왼쪽 Run and Debug 화면의 실행 버튼을 누르세요.