교재 홈: 바이브 코더를 위한 코딩 기초 학습
이 장은 코드 입력 경험이 없다는 전제에서 시작합니다. 코드는 컴퓨터에 시킬 일을 정해진 규칙으로 적은 글이며, 실행은 컴퓨터가 그 지시를 수행하게 하는 일입니다. **Python(파이썬)**은 이 교재에서 사용할 프로그래밍 언어입니다. 프로그래밍 언어는 컴퓨터에 지시를 적을 때 따르는 규칙이라고 생각하시면 됩니다. 장을 마치면 코드를 저장한 파일과 그 파일을 실행하는 도구를 구별하고, 어느 파일을 어떤 Python으로 실행했는지 확인할 수 있습니다.
코드 편집기(editor)는 코드를 적고 고쳐 저장하는 도구입니다. Python **인터프리터(interpreter)**는 Python 코드를 읽어 실행하는 프로그램입니다. **터미널(terminal)**은 글로 명령을 입력하고 결과를 받는 창이고, 그 안에서 명령을 해석해 필요한 프로그램을 실행하는 도구가 **셸(shell)**입니다. 처음에는 ‘편집기에 코드를 저장하고, 터미널에 실행 명령을 넣는다’는 역할 구분을 먼저 익히면 됩니다.
편집기의 실행 버튼도 뒤에서 특정 Python을 실행합니다. 버튼이 선택한 Python과 터미널에서 선택한 Python이 다르면, 설치된 추가 기능이 달라 같은 코드가 한쪽에서만 실행될 수 있습니다. 이 장 뒤에서 두 실행 위치를 확인합니다.
**파일(file)**은 이름을 붙여 저장한 자료 하나이고, **폴더(folder)**는 파일을 모아 두는 공간입니다. 파일명은 hello.py처럼 파일을 구별하는 이름이며, 맨 뒤의 .py 같은 부분을 확장자라고 합니다. 소스 코드는 사람이 읽고 수정하는 형태의 코드입니다. 따라서 .py는 Python 소스 코드 파일에 흔히 붙이는 확장자입니다.
.csv는 행과 열로 된 표를 글자로 저장하는 형식이고, .json은 값의 이름과 묶음 관계를 정한 규칙으로 저장하는 형식입니다. 두 형식은 06. 파일과 데이터 — 읽기·정제·저장을 구분하기의 「CSV와 JSON」절에서 예를 보며 배웁니다. 확장자를 바꾼다고 내용이 자동 변환되지는 않습니다.
일반 텍스트는 글자와 줄바꿈을 중심으로 저장한 글입니다. 글자 크기나 색, 문서 배치 정보를 포함하는 문서 프로그램의 저장 형식과 다릅니다. 코드는 일반 텍스트로 저장하는 편집기에 작성합니다. 코드 상자 맨 위의 python 같은 표시는 코드의 종류를 알리는 표지이며 파일에 함께 적는 줄이 아닙니다.
이 교재는 Python 3.12 이상에서 사용할 수 있는 문법과 표준 라이브러리를 중심으로 구성했습니다. 문법은 코드를 적는 규칙입니다. 라이브러리는 다른 코드에서 다시 쓸 수 있도록 만들어 둔 기능 모음이며, Python에 기본 포함된 기능 모음이 표준 라이브러리입니다. 3.12 같은 버전 번호는 프로그램의 판을 구별합니다. 특정 최신 설치 화면을 미리 알고 있다고 가정하지 않습니다.
운영체제는 컴퓨터의 파일·화면·프로그램 실행을 관리하는 기본 소프트웨어입니다. Windows와 macOS는 운영체제 이름입니다. 설치 파일은 Python 공식 다운로드에서 자신의 운영체제에 맞게 고르고, 설치 후 아래 명령으로 실제 버전을 확인합니다. Windows의 PowerShell과 macOS 기본 터미널에서 쓰는 zsh는 셸의 이름입니다. 이름을 외우기보다 자신의 운영체제에 해당하는 명령만 골라 사용합니다.
**프로젝트(project)**는 한 프로그램을 만들기 위해 모아 둔 코드·자료·설정과 작업의 묶음입니다. 개인 컴퓨터의 작업 폴더에 vibe-basics 폴더를 만들고 편집기에서 이 폴더를 엽니다. 이 폴더가 이번 프로젝트의 가장 바깥 폴더입니다. 뒤에서 ‘프로젝트 폴더에서 실행’이라고 하면 이 위치를 뜻합니다.
**경로(path)**는 파일이나 폴더가 있는 위치를 글로 나타낸 주소입니다. 터미널에서 지금 기준으로 삼는 폴더를 현재 폴더라고 합니다. 편집기에 터미널 열기 기능이 있으면 프로젝트 폴더를 연 상태에서 사용하고, 아래의 위치 확인 명령으로 맞는지 살펴봅니다. 다른 곳이라면 cd 다음에 목표 폴더 경로를 적어 이동합니다. cd는 change directory의 약자이며 directory는 여기서 폴더와 같은 뜻입니다. 경로에 공백이 있으면 그 경로 전체를 따옴표로 묶습니다.
아래 상자는 터미널에 입력할 명령입니다. 한 줄을 복사하거나 입력한 뒤 Enter를 누르고, 끝나면 다음 줄을 실행합니다. 운영체제별 두 상자를 모두 실행하지 않습니다. --version처럼 붙이는 추가 지시를 **옵션(option)**이라고 하며, 이 옵션은 버전을 보여 달라는 뜻입니다. 컴퓨터가 앞에 보여 주는 경로·$·> 같은 입력 대기 표시는 명령의 일부가 아니므로 따라 적지 않습니다.
Get-Location과 pwd는 현재 위치를, Get-ChildItem과 ls는 그 위치의 파일·폴더 목록을 보여 줍니다. 다음 줄의 py 또는 python3는 설치된 Python을 실행하는 명령입니다.
Windows PowerShell에서 실행합니다.
Get-Location
Get-ChildItem
py --version
py -m venv .venv
.\.venv\Scripts\python.exe --version
macOS에서는 다음 명령을 사용합니다.
pwd
ls
python3 --version
python3 -m venv .venv
./.venv/bin/python --version