ckzg 패키지 설치 오류 해결하기

오늘은 파이썬 프로젝트에 ckzg 패키지를 설치하는 과정에서 발생한 오류와 그 해결 방법에 대해 정리합니다.

문제 상황

Building wheels for collected packages: ckzg
  Building wheel for ckzg (pyproject.toml) ... error
  error: subprocess-exited-with-error

  × Building wheel for ckzg (pyproject.toml) did not run successfully.
  │ exit code: 1
  ╰─> [6 lines of output]
      running bdist_wheel
      running build
      running build_ext
      'cl'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는
      배치 파일이 아닙니다.
      error: [WinError 2] 지정된 파일을 찾을 수 없습니다
      [end of output]

이 오류는 ckzg 패키지를 설치할 때 필요한 C 컴파일러인 cl.exe를 찾을 수 없어서 발생합니다.

원인 분석

ckzg 패키지는 빌드 과정에서 C 확장 모듈을 사용하는데, 이 과정에서 C 컴파일러가 필요합니다. Windows 환경에서는 보통 Microsoft의 C++ 컴파일러인 cl.exe가 사용됩니다.

하지만 기본적으로 Windows에는 이 컴파일러가 설치되어 있지 않기 때문에 직접 설치해야 합니다.

해결 방법

1. Microsoft Visual Studio Build Tools 설치하기

Microsoft에서 제공하는 Visual Studio Build Tools는 C++ 컴파일러와 필요한 개발 도구들을 포함하고 있습니다.

👉 다운로드 링크: Visual Studio Build Tools

설치할 때 반드시 C++ 빌드 도구 옵션을 선택해야 합니다.

2. 환경 변수 설정 확인

설치 후 명령 프롬프트에서 아래 명령어를 입력해 cl.exe가 정상적으로 인식되는지 확인합니다.

cl

정상적으로 인식되면 아래와 같은 출력이 나타납니다:

Microsoft (R) C/C++ Optimizing Compiler Version XX.XX for x64
Copyright (C) Microsoft Corporation. All rights reserved.

만약 인식되지 않는다면 환경 변수 설정에 문제가 있을 수 있습니다.

3. 패키지 재설치

모든 설정이 끝나면 명령 프롬프트를 다시 열고 패키지를 다시 설치합니다.

pip install ckzg

마무리

이번 오류는 Windows 환경에서 자주 발생하는 문제 중 하나입니다. 개발 환경에 필요한 도구들이 누락되어 발생하는 경우가 많기 때문에, 필수 빌드 도구 설치는 꼭 확인해야 합니다!

앞으로 비슷한 C 확장 모듈을 사용할 때도 이 과정을 참고하면 쉽게 해결할 수 있을 것 같습니다.