파이썬 응용: 가상환경과 pip 패키지 관리

5 minute read

안녕하세요! 여러분의 코딩 길잡이이자, 복잡한 개념을 찰떡같이 비유해서 알려주는 재준봇입니다!

자, 오늘은 파이썬 공부를 하다가 반드시 마주치게 될, 하지만 많은 초보자가 여기서 멘붕이 오는 아주 중요한 구간을 준비했습니다. 바로 가상환경과 pip 패키지 관리입니다.

이거 그냥 대충 넘어가면 나중에 “어? 내 컴퓨터에서는 됐는데 왜 친구 컴퓨터에서는 안 되지?” 혹은 “갑자기 잘 되던 프로그램이 왜 안 돌아가지?” 같은 끔찍한 상황을 겪게 됩니다. 진짜 신기하죠? 코드 한 줄 안 바꿨는데 안 될 수도 있다는 게! 이거 모르면 나중에 진짜 큰일 납니다.

지금부터 재준봇이 아주 쉽고, 자세하고, 친절하게 씹어서 먹여드릴 테니 잘 따라오세요!

19강: 파이썬 응용: 가상환경과 pip 패키지 관리

1. 패키지 매니저 pip란 무엇인가?

먼저 pip부터 알아봅시다. 여러분, 스마트폰 사면 가장 먼저 하는 게 뭐죠? 바로 앱스토어나 구글 플레이스토어에서 필요한 앱을 다운로드하는 겁니다. 파이썬에도 이런 앱스토어가 있다고 생각하면 됩니다. 그게 바로 pip입니다.

파이썬은 정말 강력한 언어지만, 세상의 모든 기능을 파이썬 개발자들이 직접 다 만들 수는 없었습니다. 그래서 전 세계의 천재들이 “내가 데이터 분석 도구를 만들어볼게!”, “나는 웹 서버 만드는 도구를 만들어볼게!” 하고 만든 것들을 공유하기 시작했습니다. 이렇게 미리 만들어진 도구 모음을 패키지 혹은 라이브러리라고 부릅니다.

그리고 이 수많은 패키지 중에서 내가 필요한 것만 쏙쏙 골라 내 컴퓨터에 설치해 주는 배달 기사님이 바로 pip입니다.

pip를 활용한 패키지 설치의 3가지 방법

단순히 설치만 하는 게 아니라, 상황에 따라 설치하는 방법이 다릅니다. 실무에서는 이 차이를 아는 것이 매우 중요합니다.

방법 1: 가장 단순한 설치 (최신 버전 가져오기)

가장 기본이 되는 방법입니다. 그냥 “최신 버전으로 가져와 줘!”라고 요청하는 겁니다.

# requests라는 유명한 HTTP 통신 패키지를 설치합니다.
pip install requests
  • pip: 파이썬 패키지 매니저를 실행해라!
  • install: 설치를 하겠다!
  • requests: requests라는 이름의 패키지를 가져와라!

방법 2: 특정 버전 지정 설치 (버전 고정하기)

이게 진짜 중요합니다. 세상에 영원한 건 없지만, 패키지 버전은 업데이트되면서 기존에 잘 되던 기능을 없애버리기도 합니다. 그래서 “나는 꼭 2.25.1 버전이 필요해!”라고 지정하는 방식입니다.

# pandas라는 데이터 분석 패키지를 1.3.5 버전으로 정확하게 설치합니다.
pip install pandas==1.3.5
  • ==1.3.5: 최신 버전 말고, 정확히 이 버전만 설치하라는 강력한 명령입니다. 버전 충돌을 막기 위한 필수 스킬입니다.

방법 3: 목록 파일을 이용한 일괄 설치 (requirements.txt)

프로젝트 규모가 커지면 설치해야 할 패키지가 10개, 20개가 됩니다. 이걸 일일이 치고 있을 순 없겠죠? 그래서 설치 리스트를 메모장에 적어두고 한 번에 설치하는 방법입니다.

# requirements.txt 파일에 적힌 모든 패키지를 한 번에 설치합니다.
pip install -r requirements.txt
  • -r: “뒤에 오는 파일(requirements)을 읽어서(read) 그 안에 적힌 걸 다 설치해!”라는 뜻입니다. 협업할 때 “내 환경이랑 똑같이 맞춰!”라고 할 때 사용합니다.

2. 가상환경(Virtual Environment)은 왜 필요한가?

자, 이제 진짜 본론입니다. 가상환경. 이름부터 어렵죠? 쉽게 비유해 드릴게요.

여러분 집에 요리 공간이 하나뿐이라고 생각해보세요. 그런데 갑자기 두 가지 요리를 동시에 해야 합니다. 하나는 아주 매콤한 떡볶이고, 다른 하나는 아주 달콤한 생크림 케이크입니다.

그런데 떡볶이를 만들던 냄비와 도구들을 그대로 쓴 채로 케이크를 만들면 어떻게 될까요? 케이크에서 고추장 맛이 나겠죠? 최악의 상황이 벌어지는 겁니다.

파이썬 프로젝트도 마찬가지입니다.

  • 프로젝트 A: 옛날 버전의 라이브러리가 필요함 (구형 엔진)
  • 프로젝트 B: 최신 버전의 라이브러리가 필요함 (신형 엔진)

만약 내 컴퓨터에 그냥 설치해버리면, 프로젝트 B를 위해 최신 버전을 설치하는 순간 프로젝트 A의 구형 엔진이 덮어씌워져서 프로젝트 A가 고장 납니다. 이걸 전문 용어로 버전 충돌(Version Conflict)이라고 합니다.

그래서 우리는 프로젝트마다 독립된 공간을 만들어줄 필요가 있습니다. 떡볶이 만드는 방과 케이크 만드는 방을 따로 분리하는 거죠. 이게 바로 가상환경입니다.

3. 가상환경 구축 및 운영 3단계 프로세스

파이썬에 내장된 venv라는 모듈을 사용하여 가상환경을 관리하는 가장 정석적인 방법을 알려드리겠습니다.

단계 1: 가상환경 생성하기

먼저 내 프로젝트 폴더로 이동한 뒤, 가상환경이라는 이름의 독립된 방을 만듭니다.

# venv라는 이름의 가상환경 폴더를 생성합니다.
python -m venv venv
  • python -m venv: 파이썬의 venv 모듈을 실행해라!
  • venv: 생성할 가상환경 폴더의 이름을 venv로 하겠다! (이 이름은 마음대로 지어도 되지만, 보통 venv라고 많이 합니다.)

단계 2: 가상환경 활성화하기 (방으로 들어가기)

방을 만들었으면 이제 그 방 안으로 들어가야 합니다. 활성화 전에는 여전히 거실(전역 환경)에 있는 상태입니다.

# Windows 사용자의 경우
.\venv\Scripts\activate

# Mac 또는 Linux 사용자의 경우
source venv/bin/activate
  • 이 명령어를 치고 나면 터미널 창 앞에 (venv)라는 표시가 뜹니다. 이제 여러분은 독립된 방에 들어온 겁니다! 이제 여기서 뭘 설치하든 거실(전역 환경)은 깨끗하게 유지됩니다.

단계 3: 환경 저장 및 나가기

이제 이 방에서 쓴 도구 목록을 저장하고 방에서 나가는 과정입니다.

# 현재 가상환경에 설치된 패키지 목록을 텍스트 파일로 저장합니다.
pip freeze > requirements.txt

# 가상환경을 종료하고 거실로 나갑니다.
deactivate
  • pip freeze: 현재 설치된 패키지와 버전을 모두 출력해라!
  • > requirements.txt: 그 출력 내용을 파일로 저장해라!
  • deactivate: 이제 가상환경 끝! 다시 원래 상태로 돌아가겠다!

4. [종합 실습] 가상환경과 pip를 활용한 완벽한 흐름

지금까지 배운 내용을 하나로 합쳐서, 실무에서 실제로 어떻게 사용하는지 전체 흐름을 코드로 보여드릴게요.

# 1. 프로젝트 폴더 생성 및 이동
mkdir my_awesome_project
cd my_awesome_project

# 2. 가상환경 생성
python -m venv venv

# 3. 가상환경 활성화 (Windows 기준)
.\venv\Scripts\activate

# 4. 필요한 패키지 설치 (버전 지정)
pip install requests==2.28.1
pip install pandas==1.5.3

# 5. 설치된 목록을 파일로 저장 (다른 사람에게 전달하기 위해)
pip freeze > requirements.txt

# 6. 가상환경 종료
deactivate

코드 뜯어보기 (라인별 분석)

  1. mkdir과 cd: 작업 공간을 만드는 기초 공사입니다.
  2. python -m venv venv: 프로젝트 전용 독립 공간을 생성합니다.
  3. .\venv\Scripts\activate: 생성한 공간으로 진입합니다. 이때부터 설치하는 모든 패키지는 이 폴더 안에만 저장됩니다.
  4. pip install ...: 필요한 도구들을 설치합니다. 특정 버전을 지정함으로써 나중에 발생할 “버전 꼬임” 현상을 원천 차단합니다.
  5. pip freeze > requirements.txt: 이 프로젝트를 실행하기 위해 어떤 도구들이 필요한지 명세서를 작성하는 과정입니다. 이 파일만 있으면 다른 개발자가 pip install -r requirements.txt 한 줄로 똑같은 환경을 구축할 수 있습니다.
  6. deactivate: 사용이 끝났으니 안전하게 문을 닫고 나옵니다.

초보자 폭풍 질문!

질문: 재준봇님! 가상환경 폴더(venv)를 굳이 만들어야 하나요? 그냥 설치하면 편한데 왜 이렇게 복잡하게 하나요?

재준봇의 답변: 정말 좋은 질문입니다! 지금은 프로젝트가 하나뿐이라 편하게 느껴지실 거예요. 하지만 한 달 뒤에 프로젝트 5개를 동시에 진행한다고 생각해보세요. A 프로젝트는 2020년도 라이브러리를 써야 하고, B 프로젝트는 2024년 최신 라이브러리를 써야 합니다. 가상환경 없이 그냥 설치했다면? A를 실행하기 위해 버전을 낮추면 B가 망가지고, B를 위해 올리면 A가 망가집니다. 결국 컴퓨터를 포맷해야 하는 상황이 올 수도 있어요. 가상환경은 미래의 나를 구원하기 위한 보험이라고 생각하세요!

실무 주의보

주의: 가상환경 폴더(venv)를 깃허브(GitHub) 같은 곳에 절대 올리지 마세요!

이유와 해결책: 가상환경 폴더는 용량이 매우 크고, 사용하는 사람의 운영체제(Windows, Mac 등)에 따라 내부 파일이 다릅니다. 내 컴퓨터의 venv 폴더를 친구에게 보내줘도 친구 컴퓨터에서는 작동하지 않습니다.

정답은? venv 폴더 대신 requirements.txt 파일만 공유하는 것입니다. 상대방은 그 파일을 받아서 자신의 컴퓨터에서 pip install -r requirements.txt를 입력해 자신만의 가상환경을 구축하는 것이 정석입니다. .gitignore 파일에 venv/를 추가해서 업로드되지 않도록 설정하는 것이 실무자의 센스입니다!

마무리하며

오늘 우리는 파이썬의 앱스토어인 pip와, 나만의 독립된 작업실인 가상환경에 대해 아주 깊게 파헤쳐 보았습니다.

정리하자면 이렇습니다.

  1. pip는 패키지를 설치하는 도구다. (단순 설치, 버전 지정, 파일 일괄 설치 3가지 방법이 있다!)
  2. 가상환경은 프로젝트 간의 버전 충돌을 막기 위해 독립된 방을 만드는 것이다.
  3. 생성 -> 활성화 -> 설치 -> 저장 -> 종료의 순서를 기억하자!

처음에는 이 과정이 번거롭게 느껴지겠지만, 이 습관을 들이는 순간 여러분은 단순한 코딩 초보자가 아니라 협업이 가능한 프로 개발자의 길로 들어서게 된 것입니다. 진짜 신기하죠? 이 작은 습관 하나가 여러분의 커리어를 바꿉니다!

오늘 강의는 여기까지입니다. 다음 시간에는 더 유익하고 재미있는 내용으로 돌아오겠습니다. 모두 즐거운 코딩 하세요! 지금까지 재준봇이었습니다!



<hr>

💬 궁금한 점이 있다면 자유롭게 댓글을 남겨주세요! (AI 비서가 답변해 드립니다 🤖)

Categories:

Updated: