Git Groups

VS Code 소스 컨트롤 탭에서 변경된 파일을 그룹으로 분류하고, 그룹 단위로 커밋할 수 있는 확장입니다.

이런 경험 있으신가요?

"파일 10개를 수정했는데, 3개는 로그인 기능, 4개는 버그 수정, 3개는 리팩토링... 한번에 커밋하자니 히스토리가 지저분하고, 브랜치로 나누자니 서로 종속적이라 충돌이 나고..."

기존 방법들의 한계:

• 브랜치 분리 — 기능 간 종속성이 있으면 충돌 지옥, 매번 merge/rebase 해야 함
• git stash — 임시 저장일 뿐, 분류 도구가 아님. stash pop 할 때 충돌 가능
• 수동 git add — 파일 하나씩 골라서 커밋. 파일이 많으면 실수하기 쉬움
• 결국 "일단 다 커밋" — 히스토리가 뒤섞여서 나중에 추적이 어려움

Git Groups는 다르게 접근합니다

변경 파일을 그대로 두고, 포스트잇처럼 그룹으로 분류만 합니다.

• 파일은 워킹트리에 그대로 — 충돌 없음
• 그룹별로 Stage → Commit — 깔끔한 커밋 히스토리
• 브랜치 전환 없이 여러 작업을 동시에 정리
• 드래그 & 드롭으로 간편하게 분류

Changes 10개 파일
  ↓ 그룹으로 분류
🏷 로그인 기능 (3개) → Commit "feat: add login"
🏷 버그 수정 (4개)   → Commit "fix: resolve timeout"
🏷 리팩토링 (3개)    → Commit "refactor: clean up utils"

설치

VS Code 확장 탭(Ctrl+Shift+X)에서 "Git Groups" 검색 후 설치

사용방법

1. 그룹 만들기

소스 컨트롤 탭(Ctrl+Shift+G)을 열면 GIT GROUPS 섹션이 보입니다.

• Changes 옆 [+] 버튼 클릭 → 그룹 이름 입력
• 또는 Ctrl+Shift+P → Git Groups: Create Group

2. 파일을 그룹에 넣기

• 파일 우클릭 → Add to Group... → 그룹 선택
• 또는 파일을 그룹으로 드래그 & 드롭
• 여러 파일 선택 후 한번에 드래그도 가능

3. 그룹 단위로 커밋하기

방법 A: 그룹째로 커밋

1. Changes의 그룹 옆 [↑] 버튼으로 Stage (그룹이 Staged Changes로 이동)
2. Staged Changes에서 그룹 옆 [✓] 버튼 클릭
3. 커밋 메시지 입력 → 완료

방법 B: 개별 파일 관리

• Changes 파일 옆 [↑] → Stage
• Staged 파일 옆 [↓] → Unstage
• Changes 파일 옆 [✗] → 작업 되돌리기 (discard)

전체 Stage/Unstage

• Changes 옆 [↑] → 전체 Stage
• Staged Changes 옆 [↓] → 전체 Unstage

4. 그룹 관리

• 이름 변경: 그룹 선택 후 F2, 또는 우클릭 → Rename Group
• 삭제: 그룹 옆 [🗑] 버튼, 또는 우클릭 → Delete Group
• 파일 제거: 그룹 내 파일 우클릭 → Remove from Group

5. AI 그룹명 생성 (GitHub Copilot 필요)

Staged Changes의 그룹 옆 [✨] 버튼을 클릭하면, diff를 분석해서 그룹명을 자동 생성합니다.

예: feat: add user authentication, fix: resolve login timeout

GitHub Copilot이 설치되어 있어야 동작합니다.

6. 기타

• 전체 접기/열기: 상단 토글 버튼
• 새로고침: 상단 [↻] 버튼 (파일 변경 시 자동 갱신됨)
• diff 보기: 파일 클릭

구조

GIT GROUPS
├── Staged Changes               [✓ 커밋][↓]
│   ├── 🏷 로그인 기능  [✨][✓][↓][🗑]
│   │   ├── auth.ts          M
│   │   └── login.vue        M
│   └── config.yaml          A       [↓]
│
── ── ── ── ── ── ──
│
├── Changes                        [↑][+]
│   ├── 🏷 버그 fix       [↑][✗][🗑]
│   │   └── utils.ts         M
│   ├── readme.md            M       [↑][✗]
│   └── app.py               M       [↑][✗]

기능 요약

라이선스

MIT