FileNotFoundError: [WinError 3]

Windows‑API는 기본 설정에서 경로가 260 자(MAX_PATH) 를 넘으면 “파일을 찾을 수 없다(FileNotFoundError / WinError 3)”라는 모호한 예외를 내보낸다.

해결 방법 - Windows 긴 경로(> 260 자) 활성화

1. Windows 10 / 11 Pro
   • gpedit.msc → 컴퓨터 구성 > 관리 템플릿 > 시스템 > 파일 시스템 → “Win32 긴 경로 사용 가능하도록 설정” 항목을 사용 으로 변경
2. Home 버전 또는 스크립트 배포용
   관리자 PowerShell:

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" ` -Name LongPathsEnabled -PropertyType DWord -Value 1 -Force

 

참고

윈도우11 홈 버전에 로컬 그룹 정책 편집기 gpedit.msc 설치 : 네이버 블로그