파이썬을 처음 설치하고 예제 코드를 따라 치다 보면 반드시 만나는 벽이 있습니다. import pandas라는 한 줄을 실행했을 뿐인데 화면 가득 빨간 글씨로 ModuleNotFoundError: No module named 'pandas'가 뜨는 순간입니다. 비전공자 파이썬 pip 설치 방법을 모르면 여기서 학습이 멈추는 경우가 많습니다. 이 글에서는 pip이 무엇인지부터 실무에서 자주 쓰는 라이브러리를 설치하고 문제를 해결하는 순서까지 정리합니다.
비전공자 파이썬 pip 설치 방법, 뭐부터 해야 하나요
pip은 파이썬에 필요한 기능(라이브러리)을 인터넷에서 내려받아 설치해주는 도구로, 파이썬을 설치하면 대부분 자동으로 함께 설치됩니다. 명령 프롬프트(또는 터미널)를 열고 pip install 라이브러리이름 한 줄만 입력하면 됩니다. 예를 들어 엑셀 데이터를 다룰 때 자주 쓰는 pandas는 pip install pandas로 설치할 수 있습니다.
여기서 중요한 점은 pip 명령어는 파이썬 코드 파일(.py) 안이 아니라 명령 프롬프트, 파워셸, 또는 VS Code의 터미널 창에 입력해야 한다는 것입니다. 이 구분을 못 해서 코드 에디터 안에 pip install pandas를 그대로 붙여 넣고 에러가 난다며 당황하는 경우가 실무에서 정말 흔합니다.
명령 프롬프트 여는 법
윈도우 기준으로 시작 메뉴에서 “cmd”를 검색해 명령 프롬프트를 열거나, VS Code를 쓰고 있다면 상단 메뉴의 터미널 → 새 터미널을 선택하면 됩니다. 검은 화면에 커서가 깜빡이면 준비가 끝난 것입니다.
C:\Users\사용자>pip install pandas이렇게 입력하고 엔터를 누르면 다운로드 진행 상황이 표시되고, 마지막에 Successfully installed pandas-2.x.x 같은 문구가 나오면 설치가 완료된 것입니다.
실무에서 자주 쓰는 라이브러리와 설치 명령어
픽셀앤코드 교육 과정이나 사내 자동화 실습에서 비전공자가 가장 많이 쓰게 되는 라이브러리는 정해져 있습니다. 각각의 역할과 설치 명령어를 정리하면 다음과 같습니다.
- pandas: 엑셀·CSV 데이터를 표 형태로 다루는 라이브러리.
pip install pandas - openpyxl: 엑셀 파일(.xlsx)을 직접 읽고 쓰는 라이브러리.
pip install openpyxl - requests: API로 다른 프로그램의 데이터를 가져올 때 쓰는 라이브러리.
pip install requests - matplotlib: 그래프를 그려서 데이터를 시각화할 때 쓰는 라이브러리.
pip install matplotlib - beautifulsoup4: 웹페이지 정보를 가져올 때 쓰는 라이브러리.
pip install beautifulsoup4
여러 개를 한 번에 설치하고 싶다면 띄어쓰기로 나열하면 됩니다. pip install pandas openpyxl matplotlib처럼 입력하면 순서대로 설치가 진행됩니다.
pip install이 안 될 때 자주 나오는 오류 3가지
설치 명령어 자체는 간단하지만 실무 환경에서는 몇 가지 이유로 막히는 경우가 많습니다. 원인을 알면 대부분 5분 안에 해결됩니다.
”pip은 내부 또는 외부 명령이 아닙니다” 오류
파이썬을 설치할 때 “Add python.exe to PATH” 체크박스를 선택하지 않으면 이 오류가 발생합니다. 이 경우 파이썬을 재설치하면서 해당 체크박스를 반드시 선택하거나, 시스템 환경 변수에 파이썬 설치 경로를 직접 추가해야 합니다. 재설치가 가장 확실한 해결책입니다.
사내 방화벽·프록시 때문에 다운로드가 멈추는 경우
관공서나 보안이 강한 사내망에서는 외부 인터넷 접속이 제한되어 pip이 라이브러리 서버(PyPI)에 접속하지 못하는 경우가 있습니다. 이럴 때는 사내 IT 담당자에게 프록시 주소를 확인한 뒤 다음처럼 옵션을 추가해 실행합니다.
pip install pandas --proxy=http://프록시주소:포트번호권한 오류(Permission denied)
관리자 권한 없이 설치하려고 할 때 발생합니다. 명령 프롬프트를 “관리자 권한으로 실행”한 뒤 같은 명령어를 다시 입력하거나, 사용자 계정에만 설치하는 pip install pandas --user 옵션을 사용하면 해결되는 경우가 많습니다.
설치한 라이브러리 확인하고 버전 관리하기
지금까지 어떤 라이브러리가 설치되어 있는지 확인하려면 pip list 명령어를 입력합니다. 설치된 라이브러리 이름과 버전이 목록으로 나옵니다. 특정 라이브러리 하나만 확인하고 싶다면 pip show pandas처럼 입력하면 버전과 설치 위치를 보여줍니다.
업무용 스크립트를 여러 명이 함께 쓴다면, 어떤 라이브러리가 필요한지 목록으로 정리해두는 습관이 중요합니다. 이를 requirements.txt라는 파일로 만들어두면 새 PC에서도 pip install -r requirements.txt 한 줄로 필요한 라이브러리를 한꺼번에 설치할 수 있습니다.
# requirements.txt 예시
pandas==2.2.0
openpyxl==3.1.2
requests==2.31.0버전 번호까지 적어두면 나중에 다른 PC에서 실행했을 때 “우리 PC에서는 되는데 저 PC에서는 안 된다”는 문제를 줄일 수 있습니다. 이런 사소한 관리가 나중에 자동화 스크립트를 유지보수할 때 큰 차이를 만듭니다.
처음 실습할 때 실수하기 쉬운 부분
pip을 처음 접할 때 흔히 하는 실수 두 가지를 짚고 넘어가겠습니다. 첫째는 라이브러리 이름과 import 이름이 다른 경우입니다. 예를 들어 설치할 때는 pip install beautifulsoup4라고 입력하지만, 코드 안에서는 from bs4 import BeautifulSoup처럼 다른 이름으로 불러와야 합니다. 이 차이를 모르면 설치는 됐는데 import 오류가 난다며 헤매게 됩니다.
둘째는 파이썬이 여러 버전 설치되어 있을 때 생기는 혼동입니다. pip install pandas로 설치했는데도 코드 실행 시 계속 못 찾는다는 오류가 난다면, VS Code나 다른 에디터에서 사용 중인 파이썬 인터프리터와 pip이 설치한 파이썬이 서로 다른 버전일 가능성이 큽니다. 이럴 때는 pip install pandas 대신 python -m pip install pandas처럼 명령어 앞에 python -m을 붙이면, 지금 사용 중인 파이썬 버전에 정확히 설치할 수 있습니다.
라이브러리 설치는 파이썬 학습에서 가장 초반에 겪는 장벽이지만, 한 번 원리를 이해하면 이후 엑셀 반복 업무 자동화나 데이터 정리 실습을 진행할 때 막힘없이 넘어갈 수 있습니다. 픽셀앤코드는 경기 양주 지역 중소기업과 공공기관을 대상으로 비전공자 눈높이의 파이썬 실무 교육을 진행하고 있으며, 이런 설치 단계의 사소한 오류부터 직접 함께 확인하며 진행하는 방식으로 학습 시간을 줄이고 있습니다.