pip로 설치했는데 모듈이 없다고 할 때: Python 가상환경과 실행 경로 확인하기

👤 인스피

조회 수 5

2. 버전보다 경로를 먼저 확인합니다

python --version이 같다고 두 실행 환경이 같다는 뜻은 아닙니다. 동일 버전의 별도 설치나 가상환경이 존재할 수 있습니다. sys.executable은 현재 실행 파일 경로를 보여 줍니다. 프로그램을 VS Code에서 실행했을 때와 터미널에서 실행했을 때 각각 확인합니다.

pip --version은 설치 위치와 연결된 Python 정보를 함께 보여 줍니다. python -m pip는 선택한 Python을 기준으로 pip 모듈을 실행하므로 단독 pip 명령보다 관계가 명확합니다. 다만 python 자체가 다른 환경을 가리킨다면 이것만으로 해결되지 않습니다. 명령을 입력한 창과 실행 경로를 같이 기록하세요.

3. 프로젝트별 가상환경을 만듭니다

새 프로젝트 폴더에서 .venv를 만들면 패키지 환경을 구분하기 편합니다. 가상환경 폴더는 실행 기반 Python과 연결되며 다른 프로젝트의 패키지 목록과 분리됩니다. 가상환경을 만들었다고 편집기가 자동으로 그 환경을 선택했다고 단정하지 마세요.

Windows에서는 가상환경의 python.exe를 직접 지정해 실행할 수 있습니다. 활성화 스크립트가 실행 정책 때문에 막힌 상황에서도 경로를 직접 쓰는 방법은 환경 선택을 확인하는 데 도움이 됩니다. 이 글의 예제는 시스템 실행 정책을 전역으로 낮추는 명령을 요구하지 않습니다.

4. 활성화 없이 같은 환경을 사용하는 예제

아래 명령은 Windows에서 Python Launcher로 가상환경을 생성한 뒤 그 실행 파일로 버전과 pip 위치를 확인합니다. Launcher가 설치되지 않은 경우 실제 Python 경로를 사용하세요. package-name은 설명용 자리표시자이므로 그대로 설치하지 않습니다.

새 가상환경에는 프로젝트가 필요한 라이브러리를 별도로 설치해야 합니다. 설치를 마쳤다면 같은 python.exe로 프로그램을 실행합니다. 터미널 프롬프트에 .venv가 보이는지보다 실제 경로가 맞는지가 중요합니다. 경로에 공백이 있으면 CMD에서는 실행 파일을 따옴표로 묶고 PowerShell에서는 호출 연산자가 필요할 수 있습니다.

5. 설치 이름과 import 이름도 확인합니다

패키지 배포 이름과 코드의 import 이름이 항상 같지는 않습니다. 공식 설치 안내의 명령과 사용 예제를 함께 확인하세요. 또한 현재 폴더에 라이브러리와 같은 이름의 파일을 만들어 정상 모듈을 가리는 경우도 있습니다. 예를 들어 작업 파일 이름이 csv.py라면 표준 라이브러리 이름과 충돌할 수 있습니다.

오류 메시지의 마지막 줄만 보고 설치 누락으로 결론 내리지 마세요. 중첩된 의존 패키지에서 오류가 발생했을 수도 있습니다. 실행 파일, 작업 폴더, 전체 오류 경로와 설치 목록을 대조하면 단순 누락인지 버전 호환 문제인지 판단하기 쉬워집니다. 비밀 환경 변수 값은 확인 정보에 포함하지 않아도 됩니다.

6. VS Code와 배포 환경에 적용하기

VS Code에서는 Python 인터프리터 선택에서 프로젝트의 가상환경을 고른 뒤 실행 결과의 sys.executable을 다시 확인합니다. 다른 터미널이 이전 환경을 유지할 수 있으므로 새 터미널을 열어 비교하는 편이 좋습니다. 편집기 화면만 바뀌었다고 실제 프로그램 환경도 바뀐 것으로 판단하지 마세요.

정상 환경을 찾았다면 설치한 직접 의존성을 기록하고 재현 가능한 설치 절차를 마련합니다. 가상환경 폴더를 통째로 다른 컴퓨터로 옮기는 방식은 경로와 운영체제 차이에 취약합니다. 새 환경을 만들어 의존성을 설치하는 흐름을 사용하세요. 생성에 실패하면 원본 프로젝트는 보존한 채 새 환경에서 다시 확인합니다.

7. 모듈 오류를 전달할 때 포함할 정보

다른 개발자에게 도움을 요청할 때는 프로그램 실행 명령, sys.executable 결과, Python 버전과 오류 전체 경로를 함께 전달합니다. 설치 성공 메시지만 보내면 어느 환경인지 알기 어렵습니다. pip 목록이 아주 길다면 먼저 문제가 된 패키지와 직접 의존성부터 확인하세요. 사용자 이름 등이 포함된 로컬 경로는 필요에 따라 가릴 수 있습니다.

패키지가 있어야 하는 가상환경에서 python -m pip show로 설치 정보를 확인하고, 간단한 import 한 줄을 실행해 봅니다. 그 한 줄이 성공한다면 실제 프로그램의 작업 폴더나 다른 의존 모듈이 원인일 수 있습니다. 반대로 import부터 실패하면 설치 이름과 실행 환경 관계를 먼저 확인합니다. 전체 앱을 반복 실행하는 것보다 작은 진단이 빠를 수 있습니다.

새 환경에서 재현할 때는 기존 환경을 지우지 않습니다. 다른 이름의 시험 환경을 만들고 필요한 최소 의존성만 설치해 비교하세요. 기존 환경에는 작업 중 필요한 설정이나 패키지가 있을 수 있습니다. 정상적인 환경을 찾았다고 이전 환경을 곧바로 정리할 필요도 없습니다. 어떤 차이가 성공과 실패를 만들었는지 기록한 뒤 정리합니다.

실행에 필요한 데이터 파일과 프로그램 경로도 확인합니다. 가상환경은 Python 패키지를 구분하는 수단이며 입력 폴더나 시스템 프로그램을 자동으로 설치해 주는 기능은 아닙니다. 별도의 OCR 실행 파일이나 외부 도구가 필요하면 그 설치 위치도 점검해야 합니다. 모듈이 로드됐지만 외부 실행 파일이 없다는 오류는 다른 단계입니다.

마지막에는 실제 작업 한 건을 같은 실행 파일로 처리해 결과 파일까지 확인합니다. import 성공만으로 GUI, 파일 접근과 외부 호출이 전부 정상이라고 판단하지 마세요. 최소 재현과 실제 작업 검증을 나누면 개선한 범위와 남은 문제를 분명하게 설명할 수 있습니다. 이 절차를 README에 남기면 새 컴퓨터에서 시작할 때도 도움이 됩니다.

8. 따라 하는 예제

명령과 코드는 학습용입니다. 설명에 표시된 실행 환경을 구분하고 새 시험 폴더 또는 모의 입력으로 시작하세요.

예제 코드

py -3 -m venv .venv
.venv\Scripts\python.exe -c "import sys; print(sys.executable); print(sys.prefix != sys.base_prefix)"
.venv\Scripts\python.exe -m pip --version

REM 필요한 실제 패키지 이름으로 바꿔서 실행
REM .venv\Scripts\python.exe -m pip install package-name

REM 프로그램 실행 예시
REM .venv\Scripts\python.exe app.py

9. 검증 결과와 해석

확인 항목	결과 또는 검증 범위
가상환경 생성	임시 폴더에 생성 성공
환경 분리 확인	sys.prefix != sys.base_prefix → True
외부 패키지 설치	이번 실습에서는 실행하지 않음

Python 3.12에서 pip 설치를 생략한 임시 가상환경을 생성하고 환경 분리 값을 확인했습니다. Windows 활성화 스크립트와 VS Code UI 자체는 실행 검증하지 않았습니다.