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

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

부모 저장소가 가리키는 커밋으로 체크아웃합니다. 초기화(--init)가 항상 함께 실행되므로 초기화되지 않은 서브모듈도 한 번에 처리됩니다.
  • 개별 업데이트 — 서브모듈 항목을 우클릭하고 업데이트 를 선택합니다.
  • 전체 업데이트 — 섹션 헤더의 새로고침 버튼(모든 서브모듈 업데이트)을 누릅니다. 이때만 --recursive 가 붙어 중첩 서브모듈까지 처리됩니다.
서브모듈 섹션만 펼친 저장소(Repository) 패널에서 서브모듈 항목을 우클릭해 업데이트·제거 메뉴가 열린 모습

자식 저장소로 열기

저장소(Repository) 탭의 서브모듈 항목을 더블클릭 하면(필요하면 자동 초기화 후) 프로젝트(Projects) 사이드바에 부모 저장소 밑으로 자식 저장소 행이 나타나고 자동 선택됩니다. 이후 그래프·워킹 카피·fetch/pull이 모두 이 서브모듈을 대상으로 동작합니다. Git LFS로 추적되는 서브모듈이면 행에 LFS 배지가 함께 표시됩니다. Git LFS를 참고하세요.
자식 저장소 행에 마우스를 올리면 나타나는 X 버튼(사이드바에서 제거)은 사이드바 등록만 해제하며, .gitmodules 나 실제 파일은 건드리지 않습니다.

서브모듈 추가 / 제거

섹션 헤더의 서브모듈 추가(+) 버튼을 누르고 저장소 URL(필수), 경로(필수, 부모 기준 상대 경로), 브랜치 (선택) 를 입력해 추가 합니다.
”사이드바에서 내리기”와 “Git에서 제거”는 다릅니다. 호버 X는 사이드바 등록만 해제하고, 우클릭 메뉴의 제거 는 Git에서 실제로 제거합니다.