파이썬 패키지 설치시 Windows 환경에서 "긴 경로 지원 오류" 문제 해결 방법

 

이번에는 텐서플로와 같은 패키지를 설치할때 종종 만나게되는 오류중 하나를 알아보겠습니다. Windows 운영 체제에서 파일 경로 길이에 제한이 있습니다. 일반적으로 260자 이상인 파일 경로는 사용할 수 없어, 특정 상황에서 오류를 발생시킵니다. 이 제한은 소프트웨어 설치 또는 파일 저장 과정에서 발생할 수 있으며, TensorFlow와 같은 대형 패키지를 설치할 때 특히 문제가 될 수 있습니다. 예를 들어, 다음과 같은 오류 메시지가 나타납니다:

 

> ERROR: Could not install packages due to an OSError: [Errno 2] No such file or directory… > HINT: This error might have occurred since this system does not have Windows Long Path support enabled.

 

이는 Windows Long Path 지원 기능이 활성화되지 않았기 때문에 발생하며, 이를 해결하는 방법에 대해 알아보겠습니다.

 

문제의 원인

 

Windows 환경은 기본적으로 파일 경로 길이를 260자로 제한합니다. 이로 인해, 경로가 깊거나 복잡한 구조로 되어 있는 소프트웨어를 설치하는 경우 문제가 발생할 수 있습니다. 예를 들어, Python 패키지 설치 과정에서 발생한 오류는 경로 길이 제한 때문입니다. 이를 해결하기 위해 Windows에서 경로 길이 제한을 제거하거나, 더 짧은 경로를 사용하는 방법이 필요합니다.

 

 

 

Windows Long Path Support 활성화 방법

 

레지스트리 편집기를 사용하여 활성화

 

Windows Long Path 지원을 활성화하려면 레지스트리를 수정하는 방법이 있습니다. 아래는 단계별로 수행하는 절차입니다:

1. 레지스트리 편집기 실행
   • Windows 키 + R을 눌러 실행 창을 엽니다.
   • regedit를 입력한 후 Enter를 눌러 레지스트리 편집기를 실행합니다.
2. 지정된 경로로 이동 레지스트리 편집기에서 아래 경로로 이동합니다:

   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
   

3. LongPathsEnabled 수정
   • 오른쪽 창에서 LongPathsEnabled 값을 찾습니다.
   • 해당 값이 없다면, 새 DWORD(32비트) 값을 생성하고 이름을 LongPathsEnabled로 설정합니다.
   • 값을 1로 변경하여 Long Path 지원을 활성화합니다.
4. 컴퓨터 재부팅 레지스트리 변경 사항을 적용하려면 시스템을 재부팅합니다

 

로컬 그룹 정책 편집기를 사용하여 활성화

 

로컬 그룹 정책 편집기를 사용하여 긴 경로를 활성화할 수 있습니다. 이 방법은 Windows Pro 이상 버전에서 사용할 수 있습니다.

1. 로컬 그룹 정책 실행
   • Windows 키 + R을 눌러 실행 창을 엽니다.
   • gpedit.msc를 입력한 후 Enter를 눌러 그룹 정책 편집기를 실행합니다.
2. 정책 설정 아래 경로로 이동합니다:

   컴퓨터 구성 > 관리 템플릿 > 모든 설정 > Win32 긴 경로 사용 허용
   

3. Win32 긴 경로 사용 허용 활성화
   • 해당 항목을 더블 클릭합니다.
   • 사용으로 설정한 후 확인을 눌러 설정을 저장합니다.
4. 재부팅 변경 사항이 적용되도록 시스템을 재부팅합니다.

 

Python 설치 경로 변경

긴 경로 제한을 회피하기 위해 Python과 관련 패키지를 더 짧은 경로에 설치하는 것도 해결 방법이 될 수 있습니다. 예를 들어, C:\Python과 같은 경로를 사용하여 Python을 설치하면 경로가 간소화되어 문제가 해결될 수 있습니다. 이후 pip install 명령을 다시 실행하여 패키지를 설치합니다.

 

TensorFlow 설치 시 옵션 사용

긴 경로 문제를 해결한 후에도 특정 패키지가 설치되지 않는다면, pip install 명령에 추가 옵션을 사용하는 것이 도움이 될 수 있습니다. 아래 명령은 캐시를 비활성화하여 설치를 시도합니다:

bash

pip install tensorflow --no-cache-dir

이 옵션은 설치 중 캐시 파일 경로의 길이를 줄여줄 수 있습니다.

 

---

제경우는 이런 오류가 발생했을때 첫번째 방법만으로도 해결했습니다. 하지만 파이썬을 좀 더 짧은 경로를 사용하는것이 좀더 편의성면에서 좋지 않을까하는 생각도 들었습니다.