가장 흔한 원인은 스크립트를 실행하는 Python 환경과 패키지를 설치한 Python 환경이 다르기 때문입니다. 시스템에 여러 버전의 Python이 설치되어 있거나, 가상 환경 설정이 꼬였을 때 발생할 수 있습니다.
venv 가상 환경 사용
프로젝트별로 독립된 가상 환경을 사용하면 파이썬 버전이나 패키지 충돌 문제를 예방할 수 있습니다.
- 프로젝트 폴더로 이동합니다. (이미
E:\SourceCode\Python-test에 계십니다.)
- 가상 환경 생성: 명령 프롬프트에서 다음 명령어를 입력하여
venv라는 이름의 가상 환경을 만듭니다.
py -m venv venv
py -3.12 -m venv venv 와 같이 특정 버전으로 생성할 수도 있습니다.
- 가상 환경 활성화: 생성된 가상 환경을 활성화합니다.
.\venv\Scripts\activate
- 성공적으로 활성화되면 명령 프롬프트 줄 앞에
(venv) 표시가 나타납니다.
- 활성화된 가상 환경에 패키지 설치:
pip install selenium webdriver-manager
- 이제
pip는 현재 활성화된 venv 환경에 패키지를 설치합니다.
- 스크립트 실행:
python main.py
- 가상 환경이 활성화된 상태에서는
py 대신 python 명령어를 사용하는 것이 일반적입니다. 이 python은 venv 안의 파이썬 실행 파일을 가리킵니다.
- 작업 완료 후 가상 환경 비활성화:
deactivate
추가 확인 사항:
- IDE 사용 여부: Visual Studio Code, PyCharm 등의 IDE를 사용하고 있다면, IDE가 프로젝트에 대해 올바른 Python 인터프리터(특히 가상 환경을 생성했다면
venv\Scripts\python.exe)를 사용하도록 설정되어 있는지 확인하세요.
- PATH 환경 변수: 드물지만 시스템 PATH 환경 변수가 꼬여서 잘못된 파이썬이나 pip를 참조하는 경우도 있습니다. (위 방법들이 보통 이 문제를 우회합니다.)