Git 인덱스 검사기

거의 항상 해당 항목에 assume-unchanged(git이 디스크에서 CE_VALID라 부르는 비트)나 skip-worktree가 붙어 있기 때문입니다. 둘 다 그 경로에 대해서는 인덱스를 믿고 lstat 비교를 건너뛰라는 뜻이며, 무언가가 지워 주기 전까지 인덱스에 그대로 남습니다. 그래서 증상이 영구적으로 보이고 편집기가 아니라 저장소를 따라다닙니다. 의미는 다릅니다. assume-unchanged는 느린 파일 시스템에 대해 사용자가 하는 약속이고, skip-worktree는 그 파일이 일부러 없거나 로컬에서 바뀐 상태이니 건드리지 말라는 선언입니다. 증상은 같지만요. 이 페이지는 둘을 세어 주고 해당 항목을 표시하므로, 문제의 경로에 git update-index --no-assume-unchanged나 --no-skip-worktree를 실행하면 됩니다.

각 항목은 git이 작업 트리 파일을 마지막으로 확인했을 때의 ctime, mtime, 장치 번호, 아이노드, uid, gid, 모드, 크기를 캐시해 둡니다. 다음 status에서 git은 lstat()을 호출해 비교하고, 모든 필드가 그대로면 파일이 바뀌었을 리 없으므로 읽지도 해시하지도 않습니다. 큰 저장소에서 status가 빠른 이유가 이것입니다. 모든 필드는 32비트로 잘리므로 설계상 근사값입니다. stat 블록이 통째로 0인 항목은 실제 파일과 한 번도 비교된 적이 없다는 뜻이며, git update-index --index-info나 충돌 스테이지가 그런 항목을 만듭니다. 그래서 1970년 날짜를 지어내지 않고 stat 데이터 없음으로 표시합니다.

버전 2가 기본입니다. 어떤 항목이든 확장 플래그 워드를 필요로 하는 순간 git은 버전 3으로 씁니다. skip-worktree와 intent-to-add가 들어갈 자리가 거기뿐이기 때문입니다. 그런 항목이 마지막으로 사라지면 조용히 2로 되돌아갑니다. 즉 파일 하나에 skip-worktree를 붙이는 것만으로 전체 파일이 다른 버전으로 다시 쓰입니다. 버전 4는 git update-index --index-version 4로 직접 켜는 선택 사항이며, 각 경로를 앞 경로와 비교해 압축합니다. 디렉터리가 깊은 저장소에서 실제로 공간을 아끼지만 파일을 앞에서부터만 읽을 수 있게 됩니다. 여기서는 세 버전을 모두 읽고, 버전은 추측하지 않고 헤더에서 가져옵니다.

항목 하나는 약 62바이트에 경로 길이를 더한 정도라서 파일 10만 개라도 몇 MB에 그칩니다. 그보다 훨씬 크다면 대개 확장 때문입니다. 추적되지 않은 파일 캐시(UNTR)는 버전 관리 밖의 모든 것을 디렉터리 단위로 기록하므로 작업 트리에 쌓인 잡동사니만큼 커집니다. 캐시된 트리(TREE)는 디렉터리마다 한 건씩 기록합니다. 파일이 아주 많은 저장소라면 git이 분할 인덱스를 쓰고 있을 수도 있는데, 이때 본체는 .git/sharedindex.<id>에 있고 열어 본 파일은 사실상 link 확장뿐입니다. 여기 확장 표가 각각의 크기를 보여 주므로 원인을 가장 빨리 찾을 수 있습니다.

마지막 20바이트(SHA-256 저장소라면 32바이트)는 그 앞의 모든 내용을 해시한 값이며 git이 파일을 다시 쓸 때마다 갱신합니다. 쓰기 도중 중단, 디스크 불량, 부분 복사 같은 잘림과 손상은 잡아내지만 고의적인 변조는 막지 못합니다. 파일을 고친 사람이 체크섬도 다시 계산할 수 있기 때문입니다. 값이 맞지 않으면 git은 그 인덱스를 아예 쓰지 않습니다. 다행히 복구할 수 있습니다. 인덱스 자체에는 내용이 없으므로 파일을 지우고 git reset을 실행하면 HEAD에서 다시 만들어집니다. 잃는 것은 어떤 경로가 스테이징돼 있었는지와 intent-to-add 항목 같은 배치이지, 이미 .git/objects에 있는 오브젝트가 아닙니다. 예외가 하나 있습니다. feature.manyFiles가 켜는 index.skipHash 설정에서는 git이 해시를 아예 계산하지 않고 이 자리에 0바이트 20개를 씁니다. 그래서 전부 0인 체크섬은 불일치가 아니라 계산하지 않음으로 표시됩니다.

아닙니다. 인덱스는 브라우저의 File API로 읽고 페이지 안의 자바스크립트가 해석하며, 보낼 서버 자체가 없습니다. 다른 형식보다 이 점이 더 중요합니다. .git/index는 비공개 저장소의 전체 경로 목록에 스테이징된 파일마다의 해시까지 담고 있어서, 웹 양식에 붙여 넣을 만한 것이 아니기 때문입니다. 페이지를 연 뒤 네트워크를 끊어도 모든 기능이 그대로 동작합니다.