https://docs.python.org/3/tutorial/modules.html#the-module-search-path

모듈 탐색 경로

  1. 먼저 같은 이름의 빌트인 모듈이 있는지 확인 (sys.builtin_module_names)
  2. 없으면 sys.path 순서대로 패키지 디렉터리 혹은 파일을 찾음
  3. sys.path 초기 구성
    • 실행 스크립트가 있는 디렉터리 (파일이 없이 실행하면 현재 디렉터리) - 심볼릭 링크라면 실제 파일 위치
    • PYTHONPATH에 있는 디렉터리 목록
    • 파이썬 기본 경로 (표준 라이브러리, site-packages 등)
  4. 스크립트 디렉터리가 sys.path 앞쪽에 있어서, 같은 이름의 표준 라이브러리 모듈보다 먼저 로드 될 수 잇음
  5. 실행 중에도 sys.path를 수정할 수 있지만, 일반적으로는 가상환경/패키징으로 관리하는 편이 안전함

← python 3.14으로