Windows에서 Python 개발을 위해 VS Code 설정 익히기
VS Code는 Microsoft에서 제공하는 가볍고 빠른 텍스트 에디터이자 IDE(개발환경)입니다. 무료이며 다양한 확장 기능과 테마 지원 등, 사용자 편의성이 매우 뛰어납니다.
또한 VS Code는 Python용 확장 프로그램을 제공하여 IDE 수준으로 편리하게 Python 코드를 작성, 디버깅, 테스트할 수 있습니다.
개발에 필요한 기본 절차를 진행해 보겠습니다. 물론 본 글에 작성되지 않았지만 개별적으로 필요한 도구들은 추가로 설치해서 사용할 수 있습니다.
VS Code 설치과정과 Python 설치 과정은 다른 문서에 정리되어 있으므로 설치 부분은 제외하고 시작합니다.
- VS Code가 아직 설치 전이라면 다음 문서를 참고하세요.
[VSCode]Windows에 VS Code를 먼저 설치해볼까!
VS Code 설치 가이드1. VS Code란?VS Code(Visual Studio Code)는 Microsoft에서 제공하는 무료 코드 편집기로, 가볍고 빠른 성능을 제공하면서도 강력한 기능을 갖춘 개발 환경입니다. 다양한 프로그래밍 언어
all-tech-hub.tistory.com
- Python 설치가 아직 설치 전이라면 다음 문서를 참고하세요.
[Python]Python이 처음이라면 설치부터 해볼까?
Windows용 Python 언어 설치하는 방법 1. 설치 파일 다운로드공식 Python 웹사이트에 접속합니다.페이지를 내려 최신 버전(예: Python 3.x.x)의 다운로드 버튼을 클릭합니다.Windows 환경용 설치 파일(.exe)을
all-tech-hub.tistory.com
1. 필수 확장(Extension) 설치
VS Code는 기본적으로 Python에 대한 기능을 내장하고 있지 않기 때문에, Microsoft Python Extension을 설치하여 IDE 기능을 확장해야 합니다.
(1) VS Code 실행
- 설치가 끝나면 VS Code를 실행합니다.
(2) 확장 탭 이동
- 왼쪽 사이드바에서 ‘확장(Extensions)’ 아이콘(‘ㅁ+’-모양)을 클릭합니다.
(3) Python 검색 및 설치
- 검색창에 “Python”이라고 입력하면 Microsoft에서 제공하는 Python 확장이 나타납니다.
- ‘Install’을 클릭하여 설치합니다. Python만 설치해도 디버깅 기능을 모두 사용할 수 있으므로 Python만 설치하겠습니다.
- 앞서 Python 설치 문서에서 진행했던 Python 설치는 실제 코드 해석기(인터프리터)를 운영체제에 설치하는 단계였으며 현재 VS Code 확장에서 설치하는 Python는 VS Code 툴에서 Python 언어 지원을 제공하는 플러그인입니다.
(3) Jupyter 검색 및 설치
- Jupyter 플러그인을 사용하는 경우도 있기 때문에 함께 설치해보겠습니다. 주로 데이터 분석이나 AI 모델 생성 과정을 line by line 으로 결과를 확인하고 싶은 경우에 많이 활용여 JupyterLab 같은 인터랙티브 노트북 환경을 VS Code 내에서 사용할 수 있습니다. 이 부분은 선택사항입니다.
- Jupyter 플러그인과 함께 다음 IPython for VSCode를 설치합니다.
(4) 추가 확장(권장 사항)
코딩하는 분야에 따라서 필요한 확장 플러그인이 필요할 수 있으며 설치 방법은 동일하므로 언제든지 설정해서 사용하세요.
- Pylance: Python 언어 서버로, 빠르고 정확한 코드 완성과 IntelliSense를 제공해 줍니다.
- Visual Studio IntelliCode: AI 기반 코드 추천 기능을 제공하여 생산성을 높여줍니다.
- Python Docstring Generator: 함수의 주석을 자동으로 생성해 주는 확장.
- 등등
필요에 따라 확장 목록을 검색하여 설치해 주시면 됩니다.
2. Python 인터프리터 설정
VS Code에서 Python 코드를 실행하려면, 어떤 Python 버전(또는 가상환경)을 사용하여 코드를 실행할지 지정해야 합니다.
(1) Python 파일 생성 및 열기
- VS Code에서 파일 생성을 위해 먼저 사용할 폴더을 생성하고 해당 폴더를 VS Code에서 열어보겠습니다. (예: 폴더명을 set으로 미리 만들었다고 가정하겠습니다.)
- 새 파일을 만들고 확장자를 .py로 저장합니다. (예: hello.py)
(2) 인터프리터 선택
- VS Code 하단(또는 상단 코너) 상태바에서 ‘Python (version)’이라고 표시된 부분을 클릭합니다.
- 현재 시스템에 설치된 Python 인터프리터 목록이 표시됩니다.
- 원하는 Python 버전 또는 가상환경(Virtual Environment)을 선택합니다.
3. Python 코드 실행하기
(1) 터미널에서 실행
- VS Code에서 Ctrl + Shift + ~(Windows) 또는 Cmd + Shift + ~(macOS) 단축키로 내장 터미널을 열 수 있습니다.
- 미널에서 아래와 같이 Python 파일을 직접 실행할 수 있습니다.
터미널에서 Python 실행하기
(2) VS Code의 ‘Run’ 기능 사용
- 에디터 상단에 있는 ‘Run and Debug’ 버튼(▶)을 누르거나, 메뉴에서 Run > Start Debugging을 선택합니다.
- 디버깅 모드를 통해 중단점(Breakpoint)을 설정하고 변수를 확인하는 등 IDE 수준의 기능을 사용할 수 있습니다.
7. Python 코드 디버깅 설정
VS Code의 디버깅 기능을 활용하면, breakpoints, step over, step into 등을 사용할 수 있어 코드 오류를 빠르게 찾을 수 있습니다.
(1) vscode/launch.json 설정
- ‘Run and Debug’ 버튼을 클릭하면 기본적으로 Python 디버깅 설정(launch.json)을 자동 생성합니다.
(2) Breakpoint 설정
- 디버깅하고자 하는 코드 줄 번호 왼쪽 영역을 클릭하면 빨간색 점이 표시됩니다.
(3) Debugging 제어
- F5(디버깅 시작), F10(한 줄씩 실행), F11(함수 내부로 진입) 등 다양한 키를 사용하여 디버깅을 진행할 수 있습니다.
8. 추천하는 VS Code 단축키
- 파일 탐색 토글: Ctrl + B
- 명령 팔레트: Ctrl + Shift + P
- 터미널 열기: Ctrl + Shift + ~
- 파일 찾기: Ctrl + P
- 디버깅 시작: F5
필요에 따라 다른 단축키도 커스터마이즈할 수 있습니다.
'프로그램개발도구 > VSCode' 카테고리의 다른 글
| [Streamlit]Python 결과를 콘솔 대신 웹으로? (1) | 2025.03.29 |
|---|---|
| [VSCode]Windows에 VS Code를 먼저 설치해볼까! (0) | 2025.02.01 |