[Python] No module named 'distutils' 에러 해결하기

🧐 개요

No module named 'distutils'

이번 포스트에서는 Python 환경에서 발생하는 No module named 'distutils' 에러를 해결하는 방법을 짧게 소개합니다.

 

🛠️ 해결 방법

아래의 명령어를 통해 'setuptools'를 설치하여 해당 에러를 해결할 수 있습니다.

pip install setuptools

'distutils'은 Python 내에 내장되어 있'던' 패키지 관리 도구입니다. 객체 지향 언어인 Python은 필요한 기능을 구현하여 패키징 및 모듈화를 수행하고 이를 공유할 수 있는데, 'distutils'는 이러한 패키지 빌드 및 빌드 과정에서의 작업들을 추상화하여 더욱 단순하게 동작할 수 있도록 도와줍니다. 오픈 소스에서, 또는 그룹에 의해 개발된 일부 패키지들은 동작을 위해 'distutils'를 요구하는 경우가 있습니다.

 

🤖 GPT의  추가적인 설명

'distutils'를 사용하여 간단한 프로젝트의 패키지화 및 배포를 수행할 수 있습니다. 그러나 더 복잡한 프로젝트나 의존성 관리, 버전 관리 등을 더 효과적으로 다루기 위해서는 'setuptools'와 같은 도구를 사용하는 것이 일반적입니다.

 

이런 이슈는 왜 발생할까?

이번에 새롭게 배포 및 개발되고 있는 Python 3.12.0 이상의 버전부터 'distutils'가 공식적으로 제거되었습니다. 따라서 현재 공식 패키지로 인정받지 못하는 일부 복잡한 패키지들의 경우 기본 Python 환경에서 동작하지 않을 수 있습니다(예를 들어 Microsoft의 Pyspark 확장 패키지인 SynapseML 등).

 

'distutils'의 보다 확장된 버전인 'setuptools'를 설치하면 다시 정상적으로 사용할 수 있습니다.