커밋 & 푸시

diff를 검토하고 AI Agent가 변경한 내용에 만족하면 커밋하고 푸시할 차례입니다. 이 가이드는 스테이징부터 원격 리포지토리에 푸시하기까지 전체 워크플로우를 안내합니다.

변경 사항 스테이징

스테이징하면 이 커밋에 어떤 변경 사항을 포함할지 정확히 선택할 수 있습니다. 예를 들어 기능 코드와 설정 변경을 별도로 커밋하고 싶을 수 있습니다.

Git 패널에서 수정된 모든 파일이 Unstaged Changes 섹션에 표시됩니다:

• 파일 옆의 체크박스를 체크하여 개별적으로 스테이징
• Stage All을 클릭하여 모든 변경 파일을 한 번에 스테이징
• 파일의 스테이징을 해제하려면 체크를 해제합니다 — Unstaged로 돌아갑니다

스테이징된 파일은 사이드바 상단의 Staged Changes 섹션으로 이동합니다. 스테이징된 파일만 커밋에 포함됩니다.

전체 파일 대신 개별 hunk(파일의 섹션)를 스테이징할 수도 있습니다. diff 뷰에서 hunk 위에 마우스를 올리고 나타나는 + 버튼을 클릭하여 해당 섹션만 스테이징합니다. 파일에 관련 없는 두 가지 변경 사항이 있고 그중 하나만 지금 커밋하고 싶을 때 유용합니다.

커밋 메시지 작성

파일이 스테이징되면 Git 패널 하단의 텍스트 필드에 커밋 메시지를 입력합니다.

좋은 커밋 메시지는 기록을 읽기 쉽게 만듭니다 — 미래의 자신과 프로젝트의 다른 사람을 위해. 몇 가지 팁:

• 명령법을 사용 — "Added login form"이나 "Adding login form"이 아닌 "Add login form"으로 작성
• 무엇이 왜 변경되었는지 설명 — "fix bug"보다 "Fix null check in user.ts"가 더 유용합니다
• 첫 줄을 72자 미만으로 유지 — 대부분의 git 도구는 목록 뷰에서 더 긴 메시지를 자릅니다
• 필요하면 본문 추가 — 첫 줄 다음에 Enter를 두 번 눌러 아래에 더 긴 설명 추가

명확한 커밋 메시지 예시:

• Add email validation to signup form
• Fix crash when user list is empty
• Update API base URL for production

커밋

메시지 필드 아래의 Commit 버튼을 클릭합니다. 스테이징된 변경 사항이 새 커밋으로 로컬 git 기록에 저장되고 스테이징된 파일 섹션이 지워집니다.

커밋이 이제 브랜치 기록에 표시됩니다. 취소해야 하면 기록 뷰에서 커밋을 우클릭하고 Undo Commit을 선택합니다 — 변경 사항을 잃지 않고 스테이징 해제된 파일로 돌아갑니다.

원격에 푸시

커밋하면 변경 사항이 로컬에 저장됩니다. GitHub, GitLab 또는 기타 원격으로 보내려면:

1. Git 패널 툴바에서 Push 버튼(위쪽 화살표 아이콘)을 클릭
2. 브랜치가 이미 원격에 존재하면 커밋이 즉시 푸시됩니다
3. 원격에 아직 없는 새 브랜치라면 Publish Branch를 클릭합니다 — 원격에 브랜치를 생성하고 커밋을 푸시합니다

자격 증명을 요청받으면 입력하거나 SSH 키 인증으로 전환할 수 있습니다. 자격 증명이 자동으로 처리되도록 GitHub 계정을 연결하는 방법은 Git Accounts를 참조하세요.

변경 사항 풀

원격에서 변경 사항을 가져오려면(예: 팀원이 무언가를 푸시한 경우):

1. 툴바에서 Pull 버튼(아래쪽 화살표 아이콘)을 클릭
2. 원격 변경 사항이 가져와져 로컬 브랜치에 병합됩니다

병합 충돌이 있으면 Git 패널이 충돌하는 파일을 강조 표시합니다. 각 파일을 열어 충돌을 해결한 후 해결 사항을 스테이징하고 커밋합니다.

푸시 후 변경 사항이 원격에 있으며 팀원이 사용하거나 풀 리퀘스트 준비가 됩니다. Git 패널은 브랜치가 원격과 최신 상태임을 표시합니다.