파이썬 코드를 작성했다면, 이제 그것을 컴퓨터가 이해하고 실행하도록 만드는 방법을 알아야 합니다. 이 챕터에서는 파이썬 코드를 실행하는 두 가지 핵심 방법인 인터프리터와 스크립트 파일 사용법을 상세히 다룹니다. 여러분이 작성한 첫 코드가 어떻게 생명을 얻는지 이 책을 통해 직접 경험하게 될 것입니다.
핵심 요약
- 파이썬 인터프리터는 코드를 즉시 실행하며, 간단한 테스트나 학습에 유용합니다.
- 스크립트 파일(.py)은 긴 코드를 저장하고 재사용하며, 실제 프로그램 개발에 필수적입니다.
- 터미널(명령 프롬프트)에서
python 파일명.py명령어로 스크립트를 실행합니다. - 코드 실행 시 발생할 수 있는 흔한 오류를 이해하고 해결하는 방법을 익힙니다.
- 올바른 파이썬 코드 실행 방법을 익히면 개발 생산성이 크게 향상됩니다.
파이썬 코드는 어떻게 실행되나요?
파이썬 코드를 실행하는 방식은 크게 두 가지로 나뉩니다. 첫째는 인터프리터를 통해 즉시 코드를 실행하는 방법이고, 둘째는 스크립트 파일을 만들어 실행하는 방법입니다. 이 두 가지 방법은 개발 목적과 상황에 따라 적절히 선택하여 사용됩니다.
인터프리터로 즉시 코드 실행하기: 파이썬 셸(Shell)
파이썬 코드를 즉시 실행하고 결과를 확인하는 가장 빠른 방법은 파이썬 인터프리터, 즉 대화형 셸을 사용하는 것입니다. 파이썬 셸은 코드를 한 줄씩 입력하고 바로 그 결과를 볼 수 있어, 간단한 문법을 테스트하거나 특정 함수의 동작을 즉각적으로 확인하기에 매우 편리합니다. 저도 파이썬을 처음 배울 때, 변수가 어떤 값을 가지는지, 작은 코드가 예상대로 동작하는지 확인하고자 할 때 이 인터프리터를 자주 활용했습니다.
파이썬 셸을 실행하는 방법은 간단합니다. 파이썬을 성공적으로 설치했다면 터미널(Windows의 경우 명령 프롬프트 또는 PowerShell, macOS/Linux의 경우 터미널)을 열고 단순히 python 또는 python3를 입력한 뒤 엔터를 누르면 됩니다. 프롬프트가 >>> 로 바뀌는 것을 볼 수 있습니다. 이제 이곳에 코드를 입력해 보세요.
>>> print("안녕하세요, 파이썬 인터프리터!")안녕하세요, 파이썬 인터프리터!>>> 10 + 515>>> a = 10>>> b = 20>>> a + b30
위 예시처럼, 코드를 입력할 때마다 즉시 결과가 출력됩니다. 이는 ‘Hello, World!’를 출력하기와 같은 첫 번째 프로그램을 작성할 때 개념을 빠르게 이해하는 데 큰 도움이 됩니다.
스크립트 파일로 코드 실행하기: .py 파일
긴 파이썬 코드를 작성하고 재사용하며, 실제 프로그램을 만들 때는 스크립트 파일(.py)을 생성하여 실행하는 것이 표준적인 방법입니다. 인터프리터는 한 줄씩 실행하는 데 적합하지만, 수십, 수백 줄의 코드를 매번 입력할 수는 없습니다. 이럴 때는 파이썬 코드를 파일에 저장하고, 그 파일을 통째로 실행하는 방식을 사용합니다. 제가 현업에서 자동화 스크립트를 만들거나 데이터 분석 프로그램을 개발할 때 항상 이 방식으로 코드를 관리합니다.
파이썬 스크립트 파일 생성하기
스크립트 파일을 만드는 것은 일반 텍스트 파일을 만드는 것과 크게 다르지 않습니다. 메모장, Visual Studio Code(자세한 내용은 IDE 선택 챕터를 참조하세요), PyCharm 같은 텍스트 편집기나 IDE를 사용하면 됩니다. 중요한 것은 파일을 저장할 때 확장자를 반드시 .py로 지정해야 한다는 점입니다. 예를 들어, my_first_script.py와 같이 저장합니다.
예를 들어, hello.py라는 파일을 만들고 다음 내용을 입력해 보세요.
# hello.py 파일 내용
print("파이썬 스크립트 파일 실행 성공!")
print("두 번째 줄 코드입니다.")
터미널(명령 프롬프트)에서 스크립트 실행하기
생성한 파이썬 스크립트 파일은 터미널에서 python 파일명.py 명령어를 사용하여 실행할 수 있습니다. 이 방법은 파이썬 코드가 저장된 파일을 인터프리터에게 넘겨주어 처음부터 끝까지 실행하도록 지시하는 것입니다.
스크립트 파일을 실행하려면 다음 단계를 따릅니다.
- 터미널(명령 프롬프트) 열기: Windows 검색창에 ‘cmd’ 또는 ‘PowerShell’을, macOS/Linux에서는 ‘터미널’을 검색하여 실행합니다.
- 파일이 있는 디렉터리로 이동:
cd명령어를 사용하여hello.py파일이 저장된 폴더로 이동해야 합니다. 예를 들어, 파일이C:\Users\YourName\Documents\PythonProjects에 있다면,cd C:\Users\YourName\Documents\PythonProjects(Windows) 또는cd ~/Documents/PythonProjects(macOS/Linux)와 같이 입력합니다. - 스크립트 실행: 해당 디렉터리에서
python hello.py(또는python3 hello.py)를 입력하고 엔터를 누릅니다.
그러면 터미널에 다음과 같은 결과가 출력될 것입니다.
파이썬 스크립트 파일 실행 성공!두 번째 줄 코드입니다.
코드 실행 시 흔한 실수와 해결 방법
파이썬 코드를 실행하다 보면 몇 가지 흔한 오류에 직면할 수 있습니다. 당황하지 마세요, 저도 초보 시절에는 이런 문제들로 좌절을 많이 겪었습니다. 제 경험상 대부분의 문제는 다음 세 가지 범주에 속합니다.
- 파일 또는 디렉터리 오류 (FileNotFoundError):
스크립트 파일을 실행하려는데No such file or directory같은 오류 메시지가 나온다면, 대부분 현재 터미널의 위치와 실행하려는 파일의 위치가 다르기 때문입니다.cd명령어를 사용하여 파일이 있는 정확한 경로로 이동하거나, 파일의 전체 경로를 지정하여 실행해야 합니다 (예:python C:\path\to\hello.py). - ‘python’ 또는 ‘python3’ 명령을 찾을 수 없음:
'python' is not recognized as an internal or external command같은 메시지가 나온다면, 파이썬이 시스템 PATH 환경 변수에 제대로 등록되지 않았을 가능성이 높습니다. 파이썬 설치 가이드를 다시 확인하고, 설치 시 ‘Add Python to PATH’ 옵션을 체크했는지 확인해야 합니다. 설치 후에도 문제가 지속되면 시스템 환경 변수를 수동으로 설정해야 할 수도 있습니다. - 코드 오타 또는 문법 오류 (SyntaxError, NameError 등):
코드 자체에 오타가 있거나 파이썬 문법 규칙을 어겼을 때 발생하는 오류입니다. 이런 오류는 인터프리터나 스크립트 실행 시 어떤 파일의 몇 번째 줄에서 오류가 발생했는지 알려줍니다. 메시지를 잘 읽고 해당 줄의 코드를 수정해야 합니다. 저의 경우, 오타는 종종 눈에 잘 띄지 않아 몇 번이고 다시 코드를 보게 만드는 주범이었습니다.
이러한 오류 메시지들은 여러분의 코딩 학습 여정에서 중요한 이정표가 됩니다. 오류를 해결하는 과정 자체가 실력을 키우는 가장 좋은 방법임을 기억하세요.
마무리하며: 이제 직접 실행해 보세요!
지금까지 파이썬 코드를 실행하는 두 가지 주요 방법인 인터프리터 사용과 스크립트 파일 실행에 대해 알아보았습니다. 간단한 테스트는 인터프리터로, 본격적인 프로그램은 스크립트 파일로 관리하는 것이 일반적인 관행입니다. 이 챕터에서 배운 내용을 바탕으로 여러분이 직접 작성한 파이썬 코드를 실행하며 실제 동작을 경험해 보시기 바랍니다.
다음 챕터에서는 파이썬 코드를 이루는 가장 기본적인 요소인 변수 선언과 할당에 대해 심도 있게 다룰 예정입니다. 코드가 데이터를 어떻게 저장하고 조작하는지 이해하는 중요한 첫걸음이 될 것입니다.
자주 묻는 질문 (FAQ)
Q1: 파이썬 인터프리터와 스크립트 파일 실행 중 어떤 방법을 더 많이 사용하나요?
A: 저의 3년 현업 경험에 비추어 볼 때, 실제 프로젝트 개발에서는 대부분 스크립트 파일(.py)을 사용합니다. 인터프리터는 주로 짧은 코드 테스트, 새로운 기능 탐색, 또는 디버깅 과정에서 특정 변수 값을 확인하는 용도로 활용됩니다.
Q2: Visual Studio Code나 PyCharm 같은 IDE에서는 코드를 어떻게 실행하나요?
A: 대부분의 IDE는 내부에 터미널 기능을 포함하고 있어, IDE 내에서 직접 스크립트 파일을 실행할 수 있습니다. 또한, IDE에는 ‘실행’ 버튼(보통 재생 버튼 모양)이 있어서 클릭 한 번으로 현재 열려 있는 스크립트를 실행할 수 있는 편리한 기능도 제공합니다. 이는 IDE 선택과 설정 챕터에서 더 자세히 설명하고 있습니다.
Q3: 파이썬 스크립트 파일을 더블클릭해서 실행할 수는 없나요?
A: Windows 환경에서는 .py 파일을 더블클릭하면 파이썬 인터프리터가 실행되지만, 대부분의 경우 명령 창이 잠깐 나타났다가 사라져 결과를 확인하기 어렵습니다. 이는 스크립트가 실행되고 즉시 종료되기 때문입니다. 터미널에서 실행해야 출력 결과를 명확하게 볼 수 있습니다.
Q4: python과 python3 명령어의 차이점은 무엇인가요?
A: python 명령어는 주로 시스템에 설치된 기본 파이썬 버전을 호출합니다. 리눅스나 macOS에서는 python이 파이썬 2를, python3가 파이썬 3를 가리키는 경우가 많았습니다. 현재는 파이썬 2의 지원이 종료되었기 때문에 python 명령어가 파이썬 3를 가리키도록 설정되는 추세입니다. 확실하게 파이썬 3를 사용하려면 python3를 명시하는 것이 좋습니다.
참고 자료
- [1] Python 공식 튜토리얼 — 파이썬 훑어보기 — https://docs.python.org/ko/3/tutorial/introduction.html
- [2] Python 공식 튜토리얼 (전체 목차) — https://docs.python.org/ko/3/tutorial/index.html
