목록으로

프로그래밍 · Python

Python 입문 시리즈 #1 : 설치부터 첫 번째 프로그램 실행까지

BeanCon
Python 입문자가 개발 환경을 구축하고 첫 프로그램을 실행하는 과정을 표현한 대표 이미지

Python 입문 시리즈 1편입니다. 개발 환경이 필요한 이유, Windows와 macOS Python 설치, 설치 확인, Visual Studio Code 설정, 첫 번째 Python 프로그램 작성과 실행, 실습 예제, 자주 발생하는 오류 해결 방법과 기본 명령어를 정리했습니다.

1. 왜 개발 환경부터 구축해야 할까?

프로그래밍을 배우기 위해서는 먼저 코드를 작성하고 실행할 수 있는 환경이 필요합니다.

운전을 배우기 전에 자동차가 필요하듯이, Python을 배우기 위해서는 Python 인터프리터와 코드 편집기가 필요합니다.

이번 글에서는 Windows와 macOS 환경에서 Python을 설치하고 첫 번째 프로그램을 실행하는 방법까지 단계별로 알아보겠습니다.

이 글을 끝까지 따라 하면 Python 프로그램을 직접 실행할 수 있게 됩니다.

필요한 도구역할
Python 인터프리터작성한 Python 코드를 실행합니다.
Visual Studio Code코드를 작성하고 터미널에서 실행할 수 있는 무료 코드 편집기입니다.
터미널 또는 명령 프롬프트설치 확인, 파일 실행, 패키지 설치 같은 명령을 입력합니다.

2. Python 설치하기

Windows 설치 방법

Python 공식 홈페이지 https://www.python.org
Windows 설치 단계
  1. Python 공식 사이트에 접속합니다.
  2. 상단 메뉴의 Downloads를 클릭하고 현재 최신 안정 버전을 다운로드합니다.
  3. 설치 프로그램을 실행한 뒤 Add Python to PATH 옵션을 반드시 체크합니다.
  4. Install Now를 클릭해 설치를 진행합니다.
  5. 설치가 완료되면 터미널에서 버전을 확인합니다.

다운로드 버전 표시는 다음과 같은 형식으로 표시됩니다.

Python 3.x.x

설치 프로그램에서 반드시 확인해야 하는 옵션입니다.

Add Python to PATH

이 옵션을 선택하지 않으면 나중에 터미널에서 Python 명령어를 사용할 수 없습니다.

macOS 설치 방법

macOS에서는 공식 설치 파일을 사용하는 방법과 Homebrew를 사용하는 방법이 있습니다.

Python 공식 홈페이지 https://www.python.org
방법설명권장 상황
공식 설치 파일Python 공식 홈페이지에서 설치 파일을 내려받고 설치 마법사를 따라 진행합니다.처음 Python을 설치하는 입문자
Homebrew터미널에서 brew install python 명령으로 설치합니다.Homebrew를 이미 사용하는 개발 환경

Homebrew를 사용하는 경우 다음 명령을 실행합니다.

brew install python

설치 후 버전을 확인합니다.

python3 --version

3. Python 설치 확인하기

설치가 정상적으로 완료되었는지 확인합니다.

Windows

명령 프롬프트(cmd)를 실행한 뒤 다음 명령을 입력합니다.

python --version

또는 Python Launcher 명령을 사용할 수 있습니다.

py --version

출력 예시입니다.

Python 3.14.0

macOS

터미널을 실행한 뒤 다음 명령을 입력합니다.

python3 --version

출력 예시입니다.

Python 3.14.0

버전 정보가 출력되면 정상 설치된 것입니다.

4. Visual Studio Code 설치하기

Python 개발을 위해 가장 많이 사용하는 무료 IDE 중 하나가 Visual Studio Code입니다.

Visual Studio Code 공식 홈페이지 https://code.visualstudio.com

Python 확장 설치

VS Code Python 확장 설치 흐름
  1. VS Code를 실행합니다.
  2. 좌측 Extensions 메뉴를 클릭합니다.
  3. 검색창에 Python을 입력합니다.
  4. 게시자가 Microsoft인지 확인합니다.
  5. Python 확장을 설치합니다.

검색창 입력값입니다.

Python

게시자 확인값입니다.

Microsoft

설정 확인

새 파일을 만든 뒤 다음 코드를 입력합니다.

print("Hello Python")

Python 문법 색상이 적용되면 기본 설정이 정상적으로 완료된 것입니다.

5. 첫 번째 Python 프로그램 작성하기

이제 첫 번째 프로그램을 만들어 보겠습니다.

파일 생성

프로젝트 폴더를 생성합니다.

python-study

폴더 안에 Python 파일을 생성합니다.

hello.py

코드 작성

print("Hello World")

코드 설명

print()는 화면에 내용을 출력하는 함수입니다.

print("안녕하세요")
print("Python 공부 시작")

실행 결과입니다.

안녕하세요
Python 공부 시작

6. Python 파일 실행하기

VS Code 터미널 실행

VS Code 상단 메뉴에서 새 터미널을 엽니다.

Terminal → New Terminal

실행

Windows에서는 다음 명령으로 실행합니다.

python hello.py

macOS에서는 다음 명령으로 실행합니다.

python3 hello.py

결과는 다음과 같습니다.

Hello World

첫 번째 Python 프로그램이 성공적으로 실행된 것입니다.

7. 실습 예제

이번에는 조금 더 재미있는 예제를 만들어 보겠습니다.

자기소개 프로그램

print("이름 : 홍길동")
print("직업 : 개발자")
print("관심분야 : AI")

실행 결과입니다.

이름 : 홍길동
직업 : 개발자
관심분야 : AI

간단한 계산기

print(10 + 20)
print(50 - 10)
print(5 * 3)
print(100 / 4)

실행 결과입니다.

30
40
15
25.0

8. 자주 발생하는 오류 해결 방법

python 명령어를 찾을 수 없습니다

원인: PATH 설정이 누락된 경우 발생합니다.

해결: Python을 재설치하면서 Add Python to PATH 옵션을 체크합니다.

ModuleNotFoundError

원인: 필요한 패키지가 설치되지 않은 경우 발생합니다.

해결: pip install 패키지명 명령으로 필요한 패키지를 설치합니다.

실행이 되지 않음

원인: Python 미설치, VS Code Python Extension 누락, 파일 확장자 오류가 원인일 수 있습니다.

해결: Python 설치 여부, VS Code Python Extension 설치 여부, 파일 확장자가 .py인지 확인합니다.

python 명령어 오류 예시입니다.

'python' is not recognized

PATH 문제를 해결하려면 설치 과정에서 다음 옵션을 체크해야 합니다.

Add Python to PATH

ModuleNotFoundError 오류 예시입니다.

ModuleNotFoundError

필요한 패키지를 설치하는 명령입니다.

pip install 패키지명
실행이 되지 않을 때 확인할 항목
  • Python 설치 여부
  • VS Code Python Extension 설치 여부
  • 파일 확장자가 .py인지 확인

9. 개발자가 알아두면 좋은 기본 명령어

작업명령어
버전 확인python --version 또는 python3 --version
패키지 설치pip install requests
설치 패키지 확인pip list
pip 업그레이드pip install --upgrade pip

버전 확인 명령입니다.

python --version

python3 --version

패키지 설치 명령입니다.

pip install requests

설치된 패키지 목록 확인 명령입니다.

pip list

pip 업그레이드 명령입니다.

pip install --upgrade pip

10. 정리와 다음 편 예고

이번 시간에는 Python 개발 환경을 구축하고 첫 번째 프로그램을 실행해 보았습니다.

오늘 배운 내용은 앞으로 Python 학습의 기초가 되는 매우 중요한 부분입니다. 특히 VS Code와 Python 환경을 정상적으로 구축해 두면 이후 실습을 그대로 따라 할 수 있습니다.

다음 편부터는 본격적으로 Python 문법 학습을 시작합니다.

다음 편 예고
  • Python 입문 연재 2: 변수란 무엇인가?
  • 데이터를 저장하는 가장 쉬운 방법
  • 실제 프로그램에서 변수를 사용하는 방법

댓글

0

댓글을 불러오는 중입니다.