VSCode에서 파이썬을 실행하고 디버깅하는 방법을 처음부터 끝까지 상세히 알아봅니다. 초보자를 위한 설치 가이드부터 가상환경 설정까지, 실습과 함께 배우는 VSCode 파이썬 개발 환경 세팅 완벽한 가이드.
Vscode와 파이썬의 관계
파이썬(Python)은 프로그래밍 언어로, 컴퓨터에게 명령을 내리기 위해 사용됩니다. 웹사이트, 게임, 데이터 분석 등 다양한 프로그램을 만들 수 있는 언어입니다. 하지만 파이썬 코드를 적고 실행하려면 코드를 작성할 수 있는 도구가 필요합니다. 바로 그때 등장하는 도구가 Vscode(Visual Studio Code)입니다.
Vscode는 코드를 작성하고 편집할 수 있는 코드 편집기(프로그램)입니다. 우리는 Vscode에서 파이썬 코드를 작성하고, 그 코드를 컴퓨터가 실행할 수 있게 파이썬 실행 환경을 설정하여 코드를 실행합니다. 간단히 말해, Vscode는 코드를 적는 공간이고, 파이썬은 그 공간에서 작성하는 언어입니다.
1. Vscode 설치하기
우선, Vscode를 설치해야 합니다. Vscode는 다양한 운영 체제에서 무료로 제공됩니다.
- Vscode 다운로드: Visual Studio Code 공식 웹사이트에서 운영 체제에 맞는 버전을 다운로드하세요.
- 설치 진행: 다운로드한 파일을 실행하여 안내에 따라 설치를 완료합니다. 설치가 끝나면 Vscode를 실행하세요.
💡 팁: 이미 설치된 경우, 최신 버전으로 업데이트하는 것이 좋습니다.
2. 파이썬 설치 및 환경 설정
파이썬이 아직 설치되지 않았다면, 다음 단계를 따르세요. 파이썬이 이미 설치되어 있다면, 버전을 확인하고 최신 버전으로 업데이트하는 것이 좋습니다.
- Python 다운로드: Python 공식 웹사이트에서 최신 버전을 다운로드합니다.
- 설치 진행: 설치 중 ‘Add Python to PATH’ 옵션을 반드시 체크하세요. 이 설정으로 터미널에서 Python 명령어를 사용할 수 있습니다.
- 설치 확인: 터미널(Windows: 명령 프롬프트, Mac/Linux: 터미널)에서
python --version을 입력해 설치가 성공했는지 확인합니다.
3. Vscode에서 파이썬 확장 프로그램 설치
Vscode에서 파이썬을 실행하기 위해서는 파이썬 확장 프로그램이 필요합니다.
- 확장 설치: Vscode 왼쪽 사이드바에서 확장(Extensions) 아이콘을 클릭하거나
Ctrl+Shift+X를 눌러 확장 패널을 엽니다. - Python 확장 검색: 검색창에 “Python”을 입력하고, Microsoft에서 제공하는 Python 확장을 설치합니다.
- 설치 확인: 설치가 완료되면 Vscode 하단에 Python 인터프리터가 표시됩니다. 표시되지 않으면, 오른쪽 하단에서 Python 버전을 선택하세요.
💡 팁: Python 가상 환경을 사용하고 있다면, 해당 환경을 인터프리터로 선택해야 합니다.
4. 첫 번째 파이썬 파일 만들기
Vscode에서 첫 번째 파이썬 파일을 만들어봅시다.
- 새 파일 생성:
Ctrl+N을 눌러 새 파일을 만듭니다. 파일을 저장할 때는 확장자를.py로 지정합니다. 예:hello.py - 코드 작성: 간단한 파이썬 코드를 입력합니다:
python print("Hello, Python in Vscode!") - 코드 저장:
Ctrl+S로 파일을 저장합니다.
5. 파이썬 코드 실행하기
이제 작성한 코드를 실행해 보겠습니다.
- 터미널 열기:
Ctrl+(백틱) 키를 눌러 터미널을 엽니다. Vscode 하단에 터미널이 열립니다. - 코드 실행: 아래 명령어를 입력하여 파이썬 파일을 실행합니다:
bash python hello.py - 결과 확인: 터미널에 “Hello, Python in Vscode!” 메시지가 출력됩니다.
또한, 코드 창 상단의 ▷ 실행 버튼을 클릭해도 터미널에서 코드를 실행할 수 있습니다.
6. 파이썬 디버깅 설정 및 사용 방법
파이썬 코드를 작성할 때 오류를 찾아내는 가장 효율적인 방법 중 하나는 디버깅입니다. Vscode에서 제공하는 디버깅 도구를 사용하면 코드의 흐름을 추적하고 오류를 쉽게 찾아낼 수 있습니다.
- 중단점 설정: 코드의 특정 줄을 클릭하여 중단점을 설정합니다. 중단점은 코드 실행을 멈추고 변수 상태를 확인할 수 있는 지점입니다.
- 디버깅 시작: Vscode 상단 메뉴에서
Run>Start Debugging을 선택하거나F5키를 눌러 디버깅을 시작합니다. - 디버깅 도구 사용: 코드 실행이 중단되면, 하단의 디버깅 패널에서 변수 값, 스택 트레이스 등을 확인할 수 있습니다. 이를 통해 코드의 문제를 추적할 수 있습니다.
💡 팁:
Shift+F5키를 눌러 디버깅을 중단할 수 있습니다.
7. 자주 발생하는 문제 해결
Q1. “Python 인터프리터를 찾을 수 없습니다”라는 오류가 발생해요.
Vscode가 Python 인터프리터를 찾지 못할 때 발생하는 오류입니다. Vscode 하단에서 올바른 Python 인터프리터를 선택하세요. 그래도 문제가 해결되지 않으면 Python을 다시 설치하고, 설치 경로를 확인하세요.
Q2. 터미널에서 “Python 명령어를 찾을 수 없습니다”라고 나와요.
Python이 환경 변수에 추가되지 않은 경우 발생하는 문제입니다. Python을 설치할 때 ‘Add Python to PATH’ 옵션을 체크했는지 확인하고, 체크하지 않았다면 Python을 다시 설치하세요.
8. 파이썬 가상 환경 설정 (고급)
여러 프로젝트에서 서로 다른 Python 버전을 사용해야 할 때, 가상 환경을 설정하는 것이 좋습니다.
- 가상 환경 생성: 프로젝트 폴더에서 다음 명령어를 입력해 가상 환경을 생성하세요:
bash python -m venv .venv - 가상 환경 활성화:
- Windows:
bash .venv\Scripts\activate - Mac/Linux:
bash source .venv/bin/activate
- Windows:
- Python 인터프리터 선택: Vscode 하단에서 생성한 가상 환경을 선택하여 작업하세요.
💡 팁: 가상 환경을 사용하면 파이썬 패키지 충돌을 방지하고 프로젝트별로 환경을 관리할 수 있습니다.
결론
Vscode에서 파이썬을 실행하는 방법을 배우셨으니, 이제 실제 프로젝트에 적용해 보세요. 디버깅 기능과 가상 환경 설정을 활용하면 더욱 효율적인 개발 환경을 만들 수 있습니다.
파이썬 개발을 처음 시작하시는 분들은 처음에는 어려울 수 있지만, 꾸준한 실습과 연습을 통해 점차 익숙해질 수 있습니다. 이 가이드를 통해 VSCode와 파이썬으로 개발하는 즐거움을 경험하시길 바랍니다.
이제 여러분만의 파이썬 프로그래밍을 시작해보세요. 기초부터 차근차근 배워가다 보면 어느새 멋진 프로그램을 만들고 계실 거예요. 새로운 도전을 시작하는 여러분을 응원합니다!