Python SDK 추가하기
IntelliJ IDEA에서 일반적인 Python 모듈이나 내장 함수(builtins)를 인식하지 못하는 경우, 대부분의 원인은 Python SDK가 프로젝트에 등록되어 있지 않기 때문입니다. 다음 경로를 통해 Python SDK를 새로 생성하고 추가하면 됩니다.
File -> Project Structure -> Project -> Project SDK -> new
SDK를 추가할 때는 사용 중인 Python 인터프리터의 설치 경로를 홈 경로(home path)로 지정해야 합니다.
- Windows: C:\Python26 또는 C:\Python39 등 설치된 버전에 따른 경로
- Linux: /usr/bin/python2.7 또는 /usr/bin/python3 등
SDK가 정상적으로 등록되면 IntelliJ는 해당 디렉터리를 참조하여 코드 자동 완성 제안과 문서 힌트를 제공할 수 있게 됩니다. 설정을 마친 후에는 반드시 OK 버튼을 눌러 변경 사항을 적용하세요.
SDK 설정 후에도 인식되지 않는 경우
Python SDK가 이미 올바르게 구성되어 있는데도 여전히 내장 모듈(builtins)이 인식되지 않는 문제가 발생한다면, IDE의 캐시 손상이 원인일 수 있습니다. 이때는 다음 메뉴를 실행해 캐시를 초기화하고 IDE를 재시작해 보세요.
File -> Invalidate Caches/Restart
재시작 후 IntelliJ가 인덱스를 다시 구축하면서 Python 표준 라이브러리와 내장 모듈을 정상적으로 인식하게 됩니다. 그래도 문제가 지속된다면 Project Structure에서 해당 모듈의 SDK가 올바르게 지정되어 있는지 다시 한번 확인해 보시기 바랍니다.