파이썬/파이썬 설치와 개발 환경 설정

Python 개발 환경 설정 : VSCode 설치부터 가상환경, 디버깅까지 완벽 가이드

creator6556 2025. 9. 4. 19:01

1 VSCode와 Python의 관계 이해하기

→ VSCode는 에디터이고, Python은 언어(인터프리터)

VSCode 자체에는 Python이 내장되어 있지 않으므로 Python 설치가 먼저 필요

→ 즉, 'VSCode는 코딩 도구', 'Python은 실행 엔진'이라고 이해하면 쉬움


2 Python 설치

Python 공식 다운로드 홈페이지에서 OS에 맞는 설치 파일을 다운로드하기

→ 설치 시 반드시 Add Python to PATH를 체크하기

→ 설치 후 1-1 명령어라 1-2 명령어를 cmd에 입력하여 확인하기

1-1 명령어

python --version

 

1-1 결과

1-2 명령어

pip --version

1-2 결과


3 VSCode 설치하기

VSCode 공식 사이트에 접속하여 운영체제별 버전을 다운로드하기

→ 설치 후, Python 개발에 필요한 확장 프로그램인 Python, Pylance, Jupyter를 설치하기


4 VSCode 기본 화면 구성

→ 좌측에는 탐색기(파일 관리), 소스 제어(Git), 디버깅이 있음

→ 중앙에는 에디터(코드 작성 공간)이 있음

→ 하단에는 터미널과 출력창이 있음


5 Python 실행 환경 연결하기

→ Python 확장 프로그램을 설치 후, 좌측 하단의 Python Interpreter를 선택하기

→ 현재 PC에 설치된 Python 버전 목록이 나오면 원하는 버전을 선택하기

→ 프로젝트별로 독립된 환경을 설정하는 것이 권장됨


728x90

6 코드 실행 방법

터미널에서 저장된 파일 경로에 있는 Python 파일을 2-1 명령어를 입력하여 실행하기

2-1 명령어

python 파일이름.py

→ VSCode에서는 실행 버튼을 클릭하기

→ Jupyter Notebook 확장자를 사용하는 경우에는 셀 단위로 실행이 가능함


7 가상환경(venv) 설정 (권장)

1) 가상환경 생성

3-1 명령어

python -m venv venv

2) 가상환경 활성화

3-2-1 명령어 : Windows

venv\Scripts\activate

3-2-1 결과

3-2-2 명령어 : Mac/Linux

source venv/bin/activate

→ 설치된 패키지는 requirements.txt로 공유하면 팀원들도 동일한 환경을 구성하는 것이 가능함


8 VSCode 터미널 활용

1) 단축키

→ Windows에서는 Ctrl + `

→ MacOS에서는 Cmd + J


2) 주요 명령어

dir / ls현재 폴더를 확인

cd 폴더명폴더로 이동

cls / clear터미널 화면을 정리


3) 패키지 설치 및 확인

→ 패키지 설치는 pip install 패키지명

→ 패키지 확인은 pip list


9 디버깅(Debugging)

VSCode 좌측 메뉴의 디버그 탭에서 실행

→ 중단점(Breakpoint)를 설정 후 변수 값을 확인할 수 있음

→ F5는 디버깅을 시작함

→ F10은 한 줄씩 실행함


10 기본 설정 & 팁

자동 저장은 Ctrl + , -> Settings -> Auto Save로 설정

→ 코드 자동 정리(포매팅)은 Windows에서 Shift + Alt + F

테마 변경은 Ctrl + K + T에서 변경

터미널 글꼴과 색상 변경은 settings.json에서 직접 커스터마이즈가 가능


VSCode에 Python 설정에 대해 더 상세한 설명을 원하는 분들은 아래 사이트에 접속

VSCode에 Python 설정


VSCode에 Python 설정 뿐만 아니라 다른 프로그래밍 언어에 대해 더 알고 싶은 분들은 아래 사이트에 접속하여 원하는 링크에 접속

프로그래밍 정리 모음

 

728x90