파이썬 라이브러리 설치 및 관리 시 발생하는 주요 문제점과 해결 방법은 무엇인가요?

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

 

 

파이썬 라이브러리 설치 및 관리 시 발생하는 주요 문제점과 해결 방법은 무엇인가요?

파이썬 라이브러리 설치 및 관리 시 발생하는 주요 문제점은 파이썬 여러 버전 설치로 인한 라이브러리 공유 문제와 환경 변수 꼬임이며, 이를 해결하기 위해서는 VS Code에서 실행할 파이썬 버전을 라이브러리가 설치된 버전과 일치시키거나, 주피터 노트북을 활용하여 특정 파이썬 버전에 라이브러리를 설치하는 방법이 있습니다.

💡 파이썬 라이브러리란 무엇이며, pip를 이용한 주요 관리 명령어는 무엇인가요?

• 라이브러리: 누군가 미리 만들어 놓은 파이썬 코드로, 패키지 또는 모듈이라고도 불리며, 내부 라이브러리와 외부 라이브러리로 나뉩니다.
• pip 주요 명령어:
• pip --version: 설치된 pip 버전 확인
• pip list: 현재 파이썬 버전에 설치된 라이브러리 목록 출력
• pip list | findstr [문자열]: 특정 문자를 포함하는 라이브러리만 출력 (Windows)
• pip install --upgrade pip: pip 프로그램 업그레이드
• pip install [라이브러리명]: 특정 라이브러리 설치
• pip install [라이브러리명]==[버전]: 특정 버전의 라이브러리 설치
• pip uninstall [라이브러리명]: 라이브러리 삭제

 

파이썬 초보자들이 가장 흔히 겪는 'import 오류'를 근본적으로 해결하고, 파이썬 라이브러리를 효율적으로 관리하는 방법을 총정리합니다. pip 명령어의 실용적인 사용법부터 환경변수 설정, 그리고 여러 파이썬 버전 설치 시 발생하는 복잡한 문제들을 명쾌하게 해결하는 노하우까지 담겨 있습니다. 특히, 라이브러리가 꼬이는 원인을 정확히 진단하고, 주피터 노트북을 활용하여 원하는 파이썬 버전에 라이브러리를 정확히 설치하는 실질적인 팁을 제공하여 더 이상 코딩을 포기하는 일이 없도록 돕습니다.

 

1. 파이썬 라이브러리 설치 및 관리 개요

 

1. 목표: 파이썬 초보자들이 겪는 'import 오류'를 해결하고, 라이브러리 관리 방법을 총정리하는 것이 목표이다.

 

1. 주요 내용:
2. 라이브러리 개념 설명
3. pip 명령어 사용법
4. 파이썬 환경변수 관리 방법
5. 여러 파이썬 버전 설치 시 발생하는 문제 해결 방법

 

2. 파이썬 라이브러리 기본 개념

 

1. 라이브러리 정의: 누군가 미리 만들어 놓은 파이썬 코드를 의미한다.
2. 라이브러리를 사용하면 원하는 기능을 손쉽게 구현할 수 있다.
3. 라이브러리는 패키지, 모듈이라고도 불리며, 라이브러리 안에 패키지, 패키지 안에 모듈이 들어있는 개념으로 이해할 수 있다.
4. 결국 세 용어는 거의 비슷한 의미로 사용된다.

 

1. 라이브러리 종류:
2. 내부 라이브러리: 파이썬 설치 시 함께 설치되는 라이브러리로, 별도로 신경 쓸 필요가 없다.
3. 외부 라이브러리: 사용자가 직접 설치해서 사용해야 하는 라이브러리로, 관리가 필요하다.
4. 외부 라이브러리 예시:
5. 웹사이트 자동화: 셀레늄, 리퀘스트, 뷰티플스프, 뷰포, 크롤링 관련 라이브러리
6. 엑셀 자동화: 오픈파이 XL, xlwings
7. 데이터 분석/머신러닝: 판다스, 파이토치, T5 등 다양한 종류가 있다.
8. 이러한 외부 라이브러리들은 pip를 이용하여 설치하고 관리한다.

 

3. pip 명령어 사용법 및 실습

1. pip 정의: 파이썬 라이브러리를 관리해주는 프로그램이다.

 

1. 자주 사용하는 pip 명령어:
2. pip --version: 설치된 pip 버전을 확인한다.
3. pip list: 설치된 라이브러리 목록을 출력한다.
4. pip list | findstr [문자열]: 특정 문자를 포함하는 라이브러리만 출력한다.
5. pip install --upgrade pip: pip 자체를 업그레이드한다.
6. pip install [라이브러리명]: 특정 라이브러리를 설치한다.
7. pip install [라이브러리명]==[버전]: 특정 버전의 라이브러리를 설치한다.
8. pip uninstall [라이브러리명]: 라이브러리를 삭제한다.

 

1. pip 명령어 실습:
2. 실습 환경: 파이썬과 비주얼 스튜디오 코드가 설치되어 있다고 가정하고 진행한다.
3. 터미널 실행: 비주얼 스튜디오 코드에서 새 터미널을 연다.

 

3.1. pip 버전 확인 및 환경변수 설정

1. pip 버전 확인:
2. 터미널에 pip --version을 입력하면 현재 설치된 pip 버전을 확인할 수 있다 (예: 22.2.2).
3. 만약 "pip 용어를 확인할 수 없습니다"라는 오류 메시지가 뜨면 환경변수가 제대로 설정되지 않은 경우이다.

 

1. 환경변수 확인 및 설정 (Windows 운영체제):
2. 확인 방법:
3. '내 PC'에서 우클릭 후 '속성'으로 들어간다.
4. '고급 시스템 설정'으로 이동한다.
5. '환경변수'로 들어간다.
6. '사용자 변수'나 '시스템 변수'의 'Path'에 파이썬 관련 환경변수가 설정되어 있으면 정상이다.
7. 설정 방법:
8. 환경변수가 설정되어 있지 않다면, 파이썬 설치 시 'Add Python to PATH' 옵션을 체크하지 않았기 때문이다.
9. 이 경우, 파이썬을 프로그램 추가/제거에서 삭제한 후, 파이썬 재설치 시 'Add Python to PATH'를 반드시 체크하고 설치해야 한다.

 

3.2. 라이브러리 목록 확인 및 검색

1. 설치된 라이브러리 목록 출력:
2. pip list를 입력하면 현재 파이썬 버전에 설치된 라이브러리 목록이 출력된다.
3. 강사의 파이썬 버전은 3.10.6이며, 한 개의 파이썬만 설치되어 있었다.

 

1. 특정 문자 포함 라이브러리 검색:
2. Windows: pip list | findstr [문자열] 명령어를 사용한다.
3. 예시: pip list | findstr py는 'py' 문자를 포함하는 라이브러리만 출력한다.
4. 대소문자 구별 없이 검색하려면 /i 옵션을 추가한다 (예: pip list | findstr /i py).
5. Linux/Mac: pip list | grep [문자열] 명령어를 사용한다.
6. 대소문자 구별 없이 검색하려면 -i 옵션을 추가한다 (예: pip list | grep -i py).

 

3.3. pip 및 라이브러리 설치/삭제

1. pip 업그레이드:
2. 새로운 pip 버전이 사용 가능하다는 메시지가 뜰 경우, pip install --upgrade pip 명령어를 사용한다.
3. 만약 빨간색 오류 메시지가 뜨면, python -m pip install --upgrade pip 명령어를 사용해야 정상적으로 업그레이드가 진행된다.
4. 업그레이드 후 pip --version으로 정상 업데이트 여부를 확인할 수 있다.

 

1. 특정 라이브러리 설치:
2. pip install [라이브러리명] 명령어를 사용한다 (예: pip install selenium).
3. 설치가 완료되면 'Successfully installed [라이브러리명] [버전]' 메시지가 출력된다.

 

1. 특정 버전 라이브러리 설치:
2. pip install [라이브러리명]==[버전] 명령어를 사용한다 (예: pip install selenium==4.3.0).
3. 기존 버전이 설치되어 있다면 삭제 후 지정된 버전으로 새로 설치된다.

 

1. 라이브러리 삭제:
2. pip uninstall [라이브러리명] 명령어를 사용한다 (예: pip uninstall selenium).
3. 삭제 여부를 묻는 메시지에 'Y'를 입력하면 삭제가 진행된다.

 

4. 여러 파이썬 버전 관리 및 Import 오류 해결

1. 여러 파이썬 버전 설치의 문제점:
2. 많은 사용자들이 여러 버전의 파이썬(예: 3.8, 3.9, 3.11, 아나콘다)을 설치하여 환경변수나 라이브러리가 꼬이는 문제가 발생한다.

 

4.1. 라이브러리 공유 문제

1. 라이브러리는 서로 공유되지 않는다:
2. 예시: 파이썬 3.10.6에 requests, selenium, openpyxl을 설치한 후, 파이썬 3.11.3을 새로 설치하면 3.11.3에는 이 라이브러리들이 전혀 설치되어 있지 않다.
3. 따라서 파이썬 코드를 3.11.3 버전으로 실행하면 requests, selenium, openpyxl을 Import할 수 없다는 오류가 발생한다.
4. 이 경우, 3.11.3 버전에 해당 라이브러리들을 새로 설치해야 한다.
5. 해결책: 라이브러리를 설치한 파이썬 버전과 VS Code에서 실제로 코드를 실행할 파이썬 버전을 일치시키는 것이 매우 중요하다.

 

4.2. 환경변수 우선순위 문제

1. 환경변수 우선순위:
2. 여러 파이썬 버전이 설치되어 있으면 환경변수에 여러 파이썬 경로가 나열되는데, 위에 있는 경로일수록 우선순위가 높다.
3. pip나 python 관련 명령어를 사용하면 환경변수 목록에서 가장 위에 있는 파이썬 버전으로 실행된다.
4. 따라서 pip install 명령어를 사용하면 맨 위에 있는 파이썬 버전에 라이브러리가 설치된다.
5. 환경변수 순서를 변경하여 원하는 파이썬 버전에 라이브러리를 설치할 수도 있지만, 이 과정은 번거롭고 까다롭다.
6. 해결책: 환경변수를 직접 편집하지 않고 원하는 파이썬 버전에 라이브러리를 설치하는 방법을 실습을 통해 알아본다.

 

4.3. 여러 파이썬 버전 설치 및 Import 오류 해결 실습

1. 새로운 파이썬 버전 설치:
2. 파이썬 3.11.3 버전을 새로 설치하며, 이때 환경변수 설정을 체크하고 설치를 진행한다.

 

1. 환경변수 및 VS Code 확인:
2. 설치 완료 후 환경변수를 확인하면 3.11 관련 경로 두 개가 맨 위에 추가된 것을 볼 수 있다.
3. VS Code를 재시작하면 인터프리터 선택 목록에 3.11.3 버전이 추가된 것을 확인할 수 있다.

 

1. 터미널에서 파이썬 및 pip 버전 확인:
2. 터미널에서 python을 입력하면 3.11.3 버전이 실행되는 것을 확인할 수 있다.
3. pip --version을 입력하면 3.11 버전의 pip가 설정된 것을 확인할 수 있다.
4. pip list를 확인하면 이전에 설치된 라이브러리 목록이 확 줄어든 것을 볼 수 있는데, 이는 라이브러리가 서로 공유되지 않음을 다시 한번 보여준다.

 

1. Import 오류 상황 재현:
2. 현재 test.py 파일은 파이썬 3.10.6 버전으로 실행되고 있다.
3. 이 상태에서 pip install selenium을 실행하면 라이브러리는 환경변수 우선순위에 따라 3.11.3 버전에 설치된다.
4. 이후 test.py에서 from selenium import webdriver를 시도하면 ModuleNotFoundError가 발생한다.
5. 이는 라이브러리가 설치된 파이썬 버전(3.11.3)과 코드가 실행되는 파이썬 버전(3.10.6)이 다르기 때문에 발생하는 흔한 오류이다.

 

1. Import 오류 해결 방법:
2. VS Code 인터프리터 변경: VS Code 하단에서 파이썬 인터프리터를 클릭하여 3.11.3 버전으로 변경하면 오류 없이 코드가 실행된다.
3. 주피터 노트북 활용 (권장):
4. 특정 파이썬 버전에 라이브러리를 설치하고 싶을 때, 주피터 노트북을 활용할 수 있다.
5. 주피터 노트북에서 원하는 인터프리터(예: 3.10.6)를 선택한다.
6. 코드 셀에 pip install selenium을 입력하고 실행하면, 선택된 3.10.6 버전에 셀레늄이 설치된다.
7. 이후 test.py에서 인터프리터를 3.10.6으로 변경하고 실행하면 ModuleNotFoundError가 발생하지 않는다.
8. 이 방법은 파이썬을 삭제하거나 환경변수를 수동으로 변경하는 번거로운 과정 없이 원하는 버전에 라이브러리를 설치할 수 있는 장점이 있다.

 

5. 마무리

 

 

파이썬 기초강의 1~8강 바로가기