파이썬 설치와 VS Code 세팅 방법 완전 정리

Python 설치 준비와 기본 환경 이해

파이썬 실행 구조의 핵심

파이썬은 설치 이후 운영체제의 명령어 환경에서 실행된다. 코드 작성 이전에 실행 파일의 위치가 시스템에 정상적으로 등록되는지가 가장 중요하다.

이 구조를 이해하지 못하면 설치는 되었지만 실행되지 않는 상황을 자주 겪게 되며, 이는 코드 문제가 아니라 환경 문제인 경우가 대부분이다.

공식 배포판을 사용해야 하는 이유

파이썬은 반드시 공식 사이트에서 제공하는 배포판을 사용하는 것이 기준이다. 비공식 경로나 스토어 버전은 실행 방식이 달라 초보자에게 혼란을 준다.

공식 배포판은 문서, 커뮤니티, 개발 도구와의 호환성이 가장 안정적으로 유지된다.

설치 전 기존 환경 확인

이미 파이썬이 설치되어 있는지 확인하는 것이 첫 단계다. 중복 설치는 실행 경로 충돌을 유발할 수 있다.

버전 확인 결과 문제가 없다면 기존 환경을 그대로 사용하는 것이 바람직하다.

Python 공식 사이트 접속과 다운로드 절차

Python 공식 사이트 주소

파이썬의 모든 공식 배포 파일은 아래 사이트에서 제공된다. 이 경로가 파이썬 설치의 시작점이다.

 https://www.python.org 

다운로드 페이지 이동 방법

메인 화면 상단 메뉴에서 Downloads 항목을 선택하면 운영체제에 맞는 설치 파일이 자동으로 제안된다.

Windows 사용자는 별도의 선택 없이 제시된 최신 버전 다운로드 버튼을 클릭하면 된다.

설치 파일 실행 전 확인 사항

설치 파일을 실행하면 첫 화면에서 옵션 선택 단계가 나온다. 이 단계는 이후 실행 성공 여부를 결정한다.

반드시 Add Python to PATH 옵션이 체크되어 있는지 확인해야 한다.

Python 공식 설치 방법과 필수 체크 항목

Install Now 선택 기준

초보자라면 Customize Installation을 선택할 필요가 없다. Install Now를 선택하는 것이 가장 안전하다.

기본 옵션은 대부분의 개발 환경에서 문제없이 동작하도록 설계되어 있다.

Add Python to PATH의 실제 의미

이 옵션은 파이썬 실행 파일의 위치를 시스템 환경 변수에 등록한다. 체크하지 않으면 python 명령어가 인식되지 않는다.

이 항목을 놓쳤다면 설정을 수정하기보다 재설치가 가장 빠른 해결책이다.

설치 완료 후 정상 확인

설치가 끝나면 반드시 명령어로 정상 동작 여부를 확인해야 한다. 이 확인이 환경 세팅의 마무리 단계다.

 python --version 

VS Code 설치와 Python 확장 설정

VS Code 설치 기준

VS Code는 기본 설정 그대로 설치하면 된다. 초기 단계에서의 세부 옵션 조정은 필요하지 않다.

정상 실행만 확인되면 즉시 다음 단계로 넘어가면 된다.

Python 확장의 필수성

VS Code 자체에는 파이썬 실행 기능이 없다. Python 확장을 설치해야 실행, 디버깅, 문법 인식이 가능해진다.

반드시 Microsoft에서 제공하는 공식 Python 확장을 사용해야 한다.

인터프리터 선택 문제

여러 파이썬 버전이 설치된 경우 잘못된 인터프리터가 선택될 수 있다. 이는 실행 결과가 다르게 나타나는 원인이 된다.

화면 하단에 표시된 Python 버전을 클릭해 설치한 버전을 명확히 지정해야 한다.

첫 파이썬 파일 생성과 실행

작업 폴더 구성 원칙

파이썬 파일은 별도의 작업 폴더에서 관리하는 것이 좋다. 한글 경로나 시스템 폴더는 초반 오류 가능성을 높인다.

짧고 단순한 영문 경로가 가장 안정적이다.

환경 확인용 테스트 코드

첫 단계에서는 복잡한 예제가 필요 없다. 출력이 정상적으로 되는지만 확인하면 된다.

 print("Hello, Python") 

실행 방법 선택

초보자에게는 디버깅 없이 실행하는 방식이 가장 적합하다. 실행 결과만 확인하는 데 집중할 수 있다.

 Ctrl + F5