파이썬 설치 및 시작 가이드: 초보자 완벽 안내

Python의 세계에 오신 것을 환영합니다! 단순함, 강력함, 다재다능함으로 유명한 언어를 배우기로 선택하셨습니다. Python은 웹 애플리케이션, 데이터 과학, 인공지능, 자동화 등 다양한 분야의 원동력입니다. 초보자에게는 깔끔한 구문과 읽기 쉬운 코드가 이상적인 첫 언어가 됩니다.

하지만 첫 코드를 작성하기 전에 개발 환경을 올바르게 설정해야 합니다. 올바른 설정은 앞으로 진행할 모든 프로젝트의 기반이 됩니다. 일반적인 문제 발생을 방지하고 부드럽고 생산적인 학습 경험을 보장합니다. 이 종합 가이드는 컴퓨터에 Python을 설치하는 것부터 가상 환경으로 프로젝트 종속성을 관리하고 첫 스크립트를 실행하는 것까지 모든 단계를 안내할 것입니다. Python 여정을 튼튼하게 시작할 수 있도록 필요한 모든 명령어를 자세히 설명해 드릴 것입니다.

💡

아름다운 API 문서를 생성하는 훌륭한 API 테스트 도구를 원하시나요?

최대 생산성으로 개발 팀이 함께 작업할 수 있는 통합 올인원 플랫폼을 원하시나요?

Apidog는 모든 요구 사항을 충족하며, 훨씬 저렴한 가격으로 Postman을 대체합니다!

button

이 튜토리얼은 완전 초보자를 위해 설계되었습니다. 사전 프로그래밍 지식은 없다고 가정합니다. 첫날부터 모범 사례, 특히 진지한 Python 개발자에게 필수적인 가상 환경 사용에 중점을 둘 것입니다.

I. Python 설치: 첫 단계

가장 첫 번째 단계는 시스템에 Python 인터프리터를 설치하는 것입니다. 인터프리터는 Python 코드를 읽고 작성한 명령을 실행하는 프로그램입니다. Python 2는 더 이상 지원되지 않으므로 Python 3을 사용할 것입니다.

Python을 올바르게 설치하고 명령줄 인터페이스(CLI)에서 액세스할 수 있는지 확인하는 것이 중요합니다. Windows에서는 명령 프롬프트 또는 PowerShell, macOS 및 Linux에서는 터미널입니다.

A. Windows에 설치

Windows에는 Python이 사전 설치되어 있지 않습니다. 설치를 위한 권장 방법은 공식 설치 프로그램을 사용하는 것입니다.

설치 프로그램 다운로드: 웹 브라우저를 열고 공식 Python 웹사이트의 Windows용 다운로드 페이지로 이동합니다. 최신 안정 버전을 다운로드할 수 있는 버튼이 보일 것입니다. "Windows installer (64-bit)"를 다운로드합니다.

설치 프로그램 실행: 다운로드가 완료되면 설치 실행 파일을 실행합니다. 설치 창이 나타납니다.

중요 단계: Python을 PATH에 추가: "지금 설치(Install Now)"를 클릭하기 전에 창 하단을 확인하세요. "Add Python to PATH" 또는 유사한 문구의 체크박스가 보일 것입니다. 이 상자를 반드시 체크해야 합니다. 이 단계는 어떤 디렉토리에서든 명령 프롬프트에서 Python을 실행할 수 있도록 합니다. 이는 Windows 초보자에게 가장 흔한 함정 중 하나입니다.

설치: "지금 설치(Install Now)"를 클릭하여 권장 설정으로 설치를 시작합니다. 진행률 표시줄이 설치 과정을 보여줄 것입니다.

설치 확인: 설치가 완료되면 성공적으로 설치되었는지 확인해야 합니다. 명령 프롬프트 또는 PowerShell을 엽니다. 시작 메뉴에서 검색하여 찾을 수 있습니다. 나타나는 창에 다음 명령을 입력하고 Enter 키를 누릅니다:Bash

python --version

설치가 성공했다면 화면에 Python 버전 번호가 출력될 것입니다. 예를 들어, Python 3.12.3과 같이 표시됩니다.

pip 설치 확인: Python의 패키지 관리자인 pip은 Python과 함께 자동으로 설치됩니다. 이는 서드파티 라이브러리를 설치하는 데 사용할 도구입니다. 다음 명령으로 설치를 확인합니다:Bash

pip --version

pip의 버전과 위치가 출력될 것입니다.

B. macOS에 설치

최신 버전의 macOS에는 종종 Python 2가 사전 설치되어 있습니다. 하지만 이 버전은 구식이며 사용해서는 안 됩니다. Python 3을 설치해야 합니다.

권장 방법은 Windows와 유사하게 공식 설치 프로그램을 사용하는 것입니다.

설치 프로그램 다운로드: 공식 Python 웹사이트의 macOS용 다운로드 페이지로 이동합니다. 최신 안정 버전의 "macOS 64-bit universal2 installer"를 다운로드합니다.

설치 프로그램 실행: 다운로드한 .pkg 파일을 엽니다. 설치 프로그램이 단계를 안내할 것입니다. 라이선스에 동의하고 표준 설치를 진행합니다. Python 3은 /Applications 폴더에 설치되고 필요한 링크가 생성됩니다.

설치 확인: 터미널 애플리케이션을 엽니다 (Applications/Utilities에서 찾거나 Spotlight로 검색할 수 있습니다). 새로운 Python 3 설치를 확인하려면 다음을 입력합니다:Bash

python3 --version

방금 설치한 버전이 출력될 것입니다. macOS에서는 python3 명령이 Python 3 인터프리터를 명시적으로 호출하는 데 사용되며, python은 여전히 이전 Python 2를 가리킬 수 있습니다.

pip 확인: 마찬가지로 pip 설치를 확인합니다:Bash

pip3 --version

Python 3 설치를 위한 패키지를 관리하려면 pip3를 사용해야 할 가능성이 높습니다.

C. Linux에 설치

대부분의 Linux 배포판에는 Python 3이 사전 설치되어 있습니다. 하지만 배포판의 패키지 저장소에서 최신 버전을 가지고 있는지, 그리고 pip 및 venv와 같은 필수 도구도 있는지 확인하는 것이 좋습니다.

터미널을 엽니다.

패키지 관리자 업데이트: 먼저 로컬 패키지 목록을 업데이트합니다.

Debian, Ubuntu 또는 파생 배포판: Bash

sudo apt update

Fedora, CentOS 또는 RHEL: Bash

sudo dnf check-update

Python 설치: 이제 Python 3 패키지를 설치하고, 가상 환경을 만드는 데 사용되는 pip 및 venv 모듈도 함께 설치합니다.

Debian, Ubuntu 또는 파생 배포판: Bash

sudo apt install python3 python3-pip python3-venv

Fedora, CentOS 또는 RHEL: Bash

sudo dnf install python3 python3-pip

설치 확인: 터미널을 사용하여 설치된 버전을 확인합니다. 일반적으로 python3 명령을 사용합니다.Bash

python3 --version

그리고 pip을 확인합니다:Bash

pip3 --version

II. 가상 환경: 전문적인 프로젝트 격리

Python이 설치되었으므로 이제 전역적으로 패키지를 설치하고 싶을 수도 있습니다. 멈추세요. 새로운 Python 개발자를 위한 가장 중요한 모범 사례는 모든 프로젝트에 가상 환경을 사용하는 것입니다.

가상 환경을 사용하는 이유?

두 개의 다른 프로젝트를 작업하고 있다고 상상해 보세요. 프로젝트 A는 특정 라이브러리의 버전 1.0이 필요하고, 프로젝트 B는 동일한 라이브러리의 버전 2.0이 필요합니다. 이러한 라이브러리를 전역적으로 설치하면 계속해서 버전을 전환해야 하며, 한 프로젝트는 항상 문제가 발생할 것입니다.

가상 환경은 특정 버전의 Python과 프로젝트에 필요한 모든 특정 패키지 및 라이브러리를 포함하는 자체 포함된 격리된 디렉토리입니다. 이는 전역 Python 설치 또는 다른 가상 환경에 영향을 미치지 않습니다.

장점:

종속성 충돌 방지: 각 프로젝트의 종속성을 분리하고 독립적으로 유지합니다.
시스템을 깨끗하게 유지: 전역 Python 설치가 프로젝트별 패키지로 어수선해지지 않고 깨끗하게 유지됩니다.
재현성 보장: 다른 머신에서 프로젝트의 정확한 환경을 쉽게 재현할 수 있습니다.

Python 3에서 가상 환경을 만드는 표준 내장 방식인 venv 모듈을 사용할 것입니다.

가상 환경 생성 및 사용

전체 워크플로우를 살펴보겠습니다.

프로젝트 디렉토리 생성: 먼저 새 프로젝트를 위한 폴더를 만듭니다. 명령줄 인터페이스를 열고 다음 명령을 실행합니다:Bash

mkdir my_first_project
cd my_first_project

이렇게 하면 my_first_project라는 새 디렉토리가 생성되고 해당 디렉토리로 이동합니다.

가상 환경 생성: 이제 프로젝트 폴더 내에서 다음 명령을 실행합니다. 이 명령은 Python에게 venv 모듈을 실행하고 venv라는 폴더에 새로운 가상 환경을 만들도록 지시합니다.

macOS 및 Linux: Bash

python3 -m venv venv

Windows: Bash

python -m venv venv

이 명령을 실행하면 my_first_project 내부에 venv라는 새 폴더가 표시됩니다. 이 폴더에는 Python 인터프리터의 복사본이 포함되어 있으며 프로젝트별 패키지가 설치될 위치입니다. 이 폴더 이름을 venv 또는 .venv로 지정하는 것이 일반적인 관례입니다.

가상 환경 활성화: 환경을 생성하는 것만으로는 충분하지 않습니다. "활성화"해야 합니다. 환경을 활성화하면 셸의 프롬프트가 환경의 특정 Python 및 pip 실행 파일을 가리키도록 수정됩니다.

Windows (명령 프롬프트 사용):Bash

venv\Scripts\activate.bat

Windows (PowerShell 사용):PowerShell

.\venv\Scripts\Activate.ps1

(먼저 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process를 실행하여 실행 정책을 변경해야 할 수 있습니다)

macOS 및 Linux:Bash

source venv/bin/activate

활성화되면 명령 프롬프트 시작 부분에 (venv) C:\Users\YourUser\my_first_project>와 같이 환경 이름이 괄호 안에 표시됩니다. 이는 가상 환경이 활성화되었음을 나타냅니다.

가상 환경 비활성화: 프로젝트 작업이 끝나면 환경을 비활성화하고 일반 셸로 돌아갈 수 있습니다. 다음 명령을 입력하기만 하면 됩니다:Bash

deactivate

프롬프트에서 (venv) 접두사가 사라집니다.

III. `pip`으로 패키지 관리

가상 환경이 활성화되면 이제 프로젝트에 필요한 패키지를 안전하게 설치할 수 있습니다. 이를 위한 도구는 pip입니다. 환경이 활성화되면 pip 명령은 자동으로 해당 환경에 연결됩니다.

핵심 `pip` 명령어

HTTP 요청을 만드는 데 사용되는 인기 있는 패키지인 requests를 설치해 보겠습니다.

패키지 설치: venv가 활성화되어 있는지 확인한 다음 실행합니다:Bash

pip install requests

pip은 Python Package Index (PyPI)에서 requests 패키지와 모든 종속성을 다운로드하여 venv 폴더에 직접 설치합니다. 전역 Python 설치는 그대로 유지됩니다.

설치된 패키지 목록 보기: 현재 (활성) 환경에 설치된 패키지를 확인하려면 다음을 사용합니다:Bash

pip list

requests와 해당 종속성이 나열되지만, 전역 Python 또는 다른 환경에 설치된 패키지는 표시되지 않습니다.

requirements.txt 파일 생성: 다른 사람과 프로젝트를 공유하여 환경을 재현하게 하려면 어떻게 해야 할까요? 요구 사항 파일로 이를 수행합니다. 표준 관례는 이 파일의 이름을 requirements.txt로 지정하는 것입니다.

설치된 모든 패키지와 정확한 버전을 출력하는 pip freeze 명령으로 이 파일을 자동으로 생성할 수 있습니다.Bash

pip freeze > requirements.txt

> 기호는 명령의 출력을 requirements.txt 파일로 리디렉션합니다. 이 파일을 열면 패키지 버전 목록이 표시됩니다.

requirements.txt 파일에서 설치: 다른 사람 (또는 미래의 자신)이 프로젝트를 설정하려면 새 가상 환경을 만들고 활성화한 다음 다음 명령을 실행하여 필요한 모든 패키지를 한 번에 설치할 수 있습니다:Bash

pip install -r requirements.txt

이 명령은 pip에게 파일을 읽고 그 안에 나열된 모든 패키지를 설치하도록 지시합니다.

패키지 제거: 더 이상 패키지가 필요하지 않으면 제거할 수 있습니다:Bash

pip uninstall requests

pip은 패키지를 제거하기 전에 확인을 요청할 것입니다.

IV. 첫 Python 스크립트

완전하고 격리된 개발 환경이 갖춰졌습니다. 드디어 코드를 작성할 시간입니다!

코드 작성

Python 파일 생성: 좋아하는 텍스트 편집기 (VS Code, Sublime Text 또는 메모장 등)를 사용하여 my_first_project 디렉토리 안에 app.py라는 새 파일을 만듭니다. venv 디렉토리와 같은 폴더에 있어야 하며 그 안에 있지 않아야 합니다.

Python 코드 추가: app.py를 열고 다음 코드를 입력합니다. 이 스크립트는 이름을 묻고 개인화된 인사를 출력합니다.Python

# 사용자를 환영하는 간단한 Python 스크립트

def get_greeting(name):
    """개인화된 인사를 생성합니다."""
    if not name:
        return "안녕하세요, 미스터리한 낯선 분!"
    else:
        return f"안녕하세요, {name}님! Python의 세계에 오신 것을 환영합니다."

def main():
    """프로그램을 실행하는 메인 함수입니다."""
    print("첫 Python 애플리케이션에 오신 것을 환영합니다!")
    user_name = input("이름을 입력해주세요: ")
    message = get_greeting(user_name.strip())
    print(message)

if __name__ == "__main__":
    main()

def는 함수를 정의합니다.
input()은 사용자에게 입력을 요청하고 문자열로 읽습니다.
.strip()은 입력에서 앞뒤 공백을 제거합니다.
f"..."는 f-string으로, 문자열 리터럴 안에 표현식을 포함하는 현대적이고 편리한 방법입니다.
if __name__ == "__main__": 블록은 표준 Python 관례입니다. 이 블록은 스크립트가 직접 실행될 때만 main() 안의 코드가 실행되도록 보장합니다 (다른 스크립트로 모듈로 임포트될 때는 실행되지 않음).

스크립트 실행

환경이 활성화되었는지 확인: 명령줄 인터페이스로 돌아갑니다. my_first_project 디렉토리에 있고 (venv) 접두사가 보이는지 확인합니다.

스크립트 실행: 프로그램을 실행하려면 Python 인터프리터를 호출하고 스크립트 파일 이름을 전달합니다.

macOS 및 Linux: Bash

python3 app.py

Windows: Bash

python app.py

프로그램과 상호 작용: 스크립트는 터미널에서 실행됩니다. 먼저 "첫 Python 애플리케이션에 오신 것을 환영합니다!"를 출력한 다음 이름을 묻습니다. 이름을 입력하고 Enter 키를 누릅니다. 그러면 스크립트가 개인화된 인사를 출력합니다.

축하합니다! 전문적인 Python 개발 환경을 성공적으로 설정하고, 패키지를 관리했으며, 첫 Python 애플리케이션을 작성하고 실행했습니다. 어떤 규모의 프로젝트에서도 유용하게 사용할 수 있는 워크플로우를 마스터했습니다. 이제부터 여러분의 여정은 언어 자체, 즉 구문, 데이터 구조 및 방대한 라이브러리 생태계를 배우는 것입니다. 하지만 이 튼튼한 기반을 통해 앞으로의 모험에 완벽하게 준비되었습니다.

💡