> ## 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.

# 서브모듈

> 서브모듈 보기·업데이트

서브모듈은 저장소(Repository) 탭의 **서브모듈** 섹션에서 관리합니다.
자식 저장소로 열면 일반 저장소처럼 그래프·워킹 카피·원격 동기화를 쓸 수 있습니다.

## 서브모듈 업데이트 / 초기화

부모 저장소가 가리키는 커밋으로 체크아웃합니다.
초기화(`--init`)가 항상 함께 실행되므로 초기화되지 않은 서브모듈도 한 번에 처리됩니다.

* **개별 업데이트** — 서브모듈 항목을 우클릭하고 **업데이트** 를 선택합니다.
* **전체 업데이트** — 섹션 헤더의 새로고침 버튼(**모든 서브모듈 업데이트**)을 누릅니다.
  이때만 `--recursive` 가 붙어 중첩 서브모듈까지 처리됩니다.

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/settings-submodule-update.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=5c0e47a87b9b7c93b63bee3656646dec" alt="서브모듈 섹션만 펼친 저장소(Repository) 패널에서 서브모듈 항목을 우클릭해 업데이트·제거 메뉴가 열린 모습" width="2266" height="1784" data-path="images/settings-submodule-update.png" />
</Frame>

## 자식 저장소로 열기

저장소(Repository) 탭의 서브모듈 항목을 **더블클릭** 하면(필요하면 자동 초기화 후) 프로젝트(Projects) 사이드바에 부모 저장소 밑으로 자식 저장소 행이 나타나고 자동 선택됩니다.
이후 그래프·워킹 카피·fetch/pull이 모두 이 서브모듈을 대상으로 동작합니다.

Git LFS로 추적되는 서브모듈이면 행에 **LFS** 배지가 함께 표시됩니다.
[Git LFS](/ko/settings/git-lfs)를 참고하세요.

<Tip>자식 저장소 행에 마우스를 올리면 나타나는 X 버튼(**사이드바에서 제거**)은 사이드바 등록만 해제하며, `.gitmodules` 나 실제 파일은 건드리지 않습니다.</Tip>

## 서브모듈 추가 / 제거

<Tabs>
  <Tab title="추가">
    섹션 헤더의 **서브모듈 추가**(`+`) 버튼을 누르고 **저장소 URL**(필수), **경로**(필수, 부모 기준 상대 경로), **브랜치 (선택)** 를 입력해 **추가** 합니다.
  </Tab>

  <Tab title="제거">
    서브모듈 항목을 우클릭하고 **제거** 를 선택한 뒤 확인 다이얼로그에서 **제거** 를 누르면 Git에서 실제로 제거됩니다.

    <Warning>제거하면 서브모듈 내부의 커밋되지 않은 변경은 사라집니다.
    자식 저장소로 등록되어 있으면 사이드바에서도 함께 내려갑니다.</Warning>
  </Tab>
</Tabs>

<Note>"사이드바에서 내리기"와 "Git에서 제거"는 다릅니다.
호버 X는 사이드바 등록만 해제하고, 우클릭 메뉴의 **제거** 는 Git에서 실제로 제거합니다.</Note>