> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parallelane.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Git LFS
> 대용량 파일 관리
Git LFS로 관리되는 대용량 파일도 그대로 보고 다운로드할 수 있습니다.
ParalleLane은 git-lfs 바이너리를 설치하지 않습니다.
시스템에 git-lfs가 설치되어 있어야 하며, ParalleLane은 초기화(`git lfs install`)와 상태 표시를 담당합니다.
## LFS 상태 진단과 초기화
**설정 → ParalleLane → Git** 아래쪽 **Git LFS** 항목에서 상태를 확인합니다.
| 상태 | 표시 | 조치 |
| ------ | ---------------- | ------------------------------------------ |
| 설치 안 됨 | `설치 안 됨` 배지 | git-lfs를 설치합니다(예: `brew install git-lfs`). |
| 초기화 필요 | `초기화 필요` 배지 + 버전 | **초기화** 버튼으로 `git lfs install` 을 실행합니다. |
| 활성 | `활성` 배지 + 버전 | 추가 조치가 없습니다. |
진단과 초기화는 모두 **머신 전역** 기준이므로 저장소마다 따로 초기화할 필요가 없습니다.
git-lfs가 없는 환경에서는 `설치 안 됨` 배지만 표시되고 LFS 섹션과 배지도 나타나지 않습니다.
## diff에서 LFS 파일 보기
* **다운로드됨** — 실제 파일 내용(텍스트 diff, 이미지 미리보기)이 그대로 보입니다.
* **미다운로드** — diff 자리에 **Git LFS 객체** 카드가 뜨고 파일명·용량이 표시됩니다.
카드의 **다운로드** 버튼으로 그 파일 하나를 내려받습니다.
## 저장소 LFS 인벤토리
좌측 저장소(Repository) 탭의 **Git LFS** 섹션에서 LFS 파일 목록을 확인합니다(파일이 하나 이상 있을 때만 나타납니다).
각 행에 파일명·용량과 다운로드 여부가 표시되며, 최대 100개까지 보여 주고 그보다 많으면 `… 외 N개` 가 붙습니다.
섹션 헤더의 **미다운로드 받기** 버튼으로 받지 않은 파일을 모두 내려받습니다.
## LFS 배지
* **변경 파일 목록** — 커밋 상세나 워킹 카피의 파일 경로 오른쪽에 **LFS** 배지가 붙습니다.
* **프로젝트 사이드바** — `.gitattributes` 에 LFS 추적 규칙(`filter=lfs`)이 있는 저장소 행에 배지가 붙습니다.
[자식 저장소로 등록](/ko/settings/submodules)한 서브모듈 행도 마찬가지입니다.
