git 'Filename too long' — 윈도우 긴 경로를 켜도 파일이 커밋에서 빠지는 이유
경로가 260자를 넘는 폴더에서 git add가 'Filename too long' 경고만 내고 종료 코드 0으로 끝나 파일이 조용히 빠지는 현상을 재현했습니다. 윈도우 LongPathsEnabled가 켜져 있어도 git은 core.longpaths를 따로 켜야 하는 이유와 확인법을 정리했습니다.
폴더를 여러 겹으로 만들다 보면 경로가 길어져 "Filename too long" 이나 "파일 이름이 너무 깁니다" 같은 오류를 만나게 된다. 흔한 해결책은 윈도우의 긴 경로 사용(LongPathsEnabled) 을 켜는 것이다. 그런데 이 PC(윈도우 11 Home, Git 2.39.0)는 그 설정이 이미 켜져 있었는데도 git이 긴 경로의 파일을 놓쳤다. 더 곤란한 건, git이 오류 없이 끝나서 파일이 빠진 걸 알아채기 어렵다는 점이다. 2026년 11월 3일, 테스트 폴더 C:\lp-test 안에 이름이 긴 폴더를 8단계로 만들고 맨 안쪽에 메모.txt 하나를 넣어 확인했다.
윈도우 쪽은 이미 긴 경로를 허용하고 있었다
먼저 레지스트리 값과 실제 경로 길이를 봤다(조회만, 변경 없음).
reg query HKLM\SYSTEM\CurrentControlSet\Control\FileSystem /v LongPathsEnabled
powershell -NoProfile -Command "Get-ChildItem C:\lp-test -Recurse -File | ForEach-Object { $_.Name + ' 경로 길이: ' + $_.FullName.Length + '자' }"

- LongPathsEnabled = 0x1 — 켜져 있다
- 메모.txt의 전체 경로는 273자. 마이크로소프트 최대 경로 길이 제한 문서의 기존 한도 260자(MAX_PATH) 를 넘는다
이 상태에서 명령 프롬프트로 폴더를 만들고 파일을 쓰는 것, PowerShell로 목록을 읽는 것은 모두 문제없었다. 문서에도 나오듯 이 설정을 켜도 프로그램이 긴 경로를 지원해야 실제로 쓸 수 있다. git이 그런 경우였다.
git add는 경고만 내고 '성공'으로 끝났다
새 저장소를 만들고 파일을 추가했다.
cd /d C:\lp-test
git init -q
git add -A
echo 종료 코드 %errorlevel%
git -c core.quotepath=false status --short
git ls-files | find /c /v ""

git add -A→warning: could not open directory '...': Filename too long. 오류(error)가 아니라 경고(warning) 다- 종료 코드 0. .bat 파일이나 자동 배포처럼 종료 코드로 성공 여부를 판단하는 곳에서는 "정상"으로 넘어간다
git status도 같은 경고만 보여 주고 추가할 파일 목록이 비어 있다git ls-files개수 0. 메모.txt는 저장소에 들어가지 않았다
경고 문구를 놓치면 "커밋할 게 없네" 하고 넘어가게 된다. 다른 PC에서 저장소를 받으면 그 파일만 없는 상태가 된다.
core.quotepath=false 는 한글 파일 이름이 \353\205\204 같은 숫자로 바뀌어 보이지 않게 하는 옵션이다. 처음에 이 옵션 없이 status를 봤다가 경로 전체가 숫자로 나와 읽을 수가 없었다.
core.longpaths를 켜면 바로 들어간다
윈도우용 git(Git for Windows)에는 윈도우 설정과 별개로 자체 설정 core.longpaths 가 있다. 설치할 때 고른 옵션에 따라 값이 다를 수 있으니 직접 확인하는 게 낫다. 이 PC에서는 값이 비어 있었다(git config --get core.longpaths 결과 없음). 테스트 저장소를 새로 만들고 그 저장소에만 켰다.
git init -q
git config core.longpaths true
git config core.quotepath false
git add -A
git ls-files | find /c /v ""
git status --short

경고 없이 끝났고 git ls-files 1개, git status 에 A(추가됨) 로 메모.txt가 나왔다.
하나 더 확인한 것이 있다. 처음 저장소에서 이 옵션을 그 명령에만 붙여(git -c core.longpaths=true add -A) 추가한 뒤, 옵션 없이 git status 를 보니 같은 파일이 AD 로 나왔다. "추가는 됐는데 작업 폴더에서는 지워졌다"는 뜻이다. 파일은 그대로 있는데 git이 긴 경로를 못 읽어서 없는 것으로 본 것이다. 그러니 한 번만 붙이지 말고 저장소 설정으로 켜 두는 게 맞다.
긴 경로 문제 점검 순서
| 확인 | 방법 | 이 PC 결과 |
|---|---|---|
| 윈도우 긴 경로 설정 | reg query ... /v LongPathsEnabled | 0x1(켜짐) |
| 경로 길이 | PowerShell FullName.Length | 273자 |
| git 설정 | git config --get core.longpaths | 비어 있음 → 경로 누락 |
| 실제로 올라갔는지 | git ls-files, git status | 켜기 전 0개, 켠 뒤 1개 |
- git 저장소가 깊은 폴더 안에 있다면
git config core.longpaths true를 저장소에 켠다. 자주 쓰면--global로 켤 수도 있다 - 종료 코드만 믿지 말고 결과 파일 수를 센다
- 근본적으로는 저장소를
C:\work처럼 짧은 위치에 두는 게 가장 확실하다. 경로 길이는 폴더 위치까지 포함해서 세기 때문이다
확인이 끝난 뒤 테스트 폴더는 지웠다. git 저장소의 .git 폴더 안 파일은 읽기 전용이라, 탐색기가 아닌 방법으로 지울 때는 읽기 전용 속성을 먼저 풀어야 했다. 명령어가 안 먹을 때 어느 프로그램이 실행되는지부터 보려면 '내부 또는 외부 명령이 아닙니다' 오류와 where 명령을 참고하면 된다.
자주 묻는 질문
03윈도우 경로 길이 제한은 몇 자인가요?
마이크로소프트 문서 기준으로 기존 제한(MAX_PATH)은 260자이고, 윈도우 10 1607 이후로는 LongPathsEnabled 설정과 프로그램 쪽 지원이 함께 있어야 그보다 긴 경로를 쓸 수 있습니다.
git config --global 로 켜야 하나요?
이 글에서는 테스트 저장소에만 git config core.longpaths true 를 적용했습니다. 긴 경로 저장소를 자주 다룬다면 --global 로 켤 수 있지만, 먼저 저장소 하나에서 결과를 확인해 보는 편이 안전합니다.
git add 가 성공했는지 어떻게 확인하나요?
종료 코드만 보면 안 됩니다. 이 PC에서는 경고가 나도 종료 코드가 0이었습니다. git ls-files 로 실제로 올라간 파일 수를 세거나 git status 결과에 파일이 보이는지 확인합니다.
참고 자료
같은 카테고리의 글
04텍스트·CSV 한글이 '源泥쐶닋'·'���'로 깨질 때 — UTF-8과 CP949 바이트로 구분하기
같은 내용을 UTF-8, UTF-8(BOM), CP949로 저장해 명령 프롬프트(코드 페이지 949·65001)와 PowerShell에서 열어 봤습니다. 깨진 모양으로 원래 인코딩을 짐작하는 법, 파일 앞 바이트로 확인하는 법, Get-Content -Encoding 옵션까지 정리했습니다.
4분'address already in use' 포트 3000 충돌 — 누가 쓰는지 찾고 비우는 법
개발 서버를 켰는데 EADDRINUSE(address already in use :::3000) 오류가 날 때, netstat -ano와 tasklist, Get-NetTCPConnection으로 포트를 쓰는 프로그램을 찾고 종료한 뒤 다시 띄우기까지 직접 재현한 과정을 정리했습니다.
3분python3를 치면 'Python'만 나오거나 스토어가 열릴 때 — 앱 실행 별칭과 PATH
파이썬을 설치했는데 python3 명령이 'Python' 한 단어만 출력하고 끝나거나 Microsoft Store가 열릴 때, 원인인 앱 실행 별칭(0바이트 python3.exe)과 PATH 순서, py 런처로 버전을 고르는 방법을 직접 확인해 정리했습니다.
3분디스크 정리 4.39GB vs 설정 앱 임시 파일 37.8GB — 같은 PC인데 숫자가 9배 다른 이유
cleanmgr로 C드라이브를 계산해 '최대 4.39GB'와 기본 체크 323MB를 확인하고, 설정 앱의 임시 파일 37.8GB·추천 정리 5.00GB와 나란히 비교했습니다. 두 도구가 세는 범위가 다른 이유와 체크하기 전에 볼 항목을 직접 확인한 화면으로 정리했습니다.
3분