VSCode에서 Git & GitHub 사용하기

기본 내장 기능

VSCode는 Git을 기본으로 지원합니다. 별도 설치 없이 사이드바의 Source Control 패널(단축키: Ctrl+Shift+G / Cmd+Shift+G)에서 대부분의 작업이 가능합니다.

---

 

Source Control 패널 기본 사용법

변경 파일 확인 & 스테이징

• 패널을 열면 변경된 파일 목록이 나타납니다.
• 파일 옆 + 버튼 클릭 → git add 와 동일합니다.
• Changes 섹션 옆 + 버튼 클릭 → git add . 와 동일합니다.

커밋

• 상단 메시지 입력창에 커밋 메시지를 입력합니다.
• Commit 버튼 클릭 (또는 Ctrl+Enter / Cmd+Enter)합니다.

Push / Pull

• 패널 상단 ... 메뉴 → Push / Pull 선택합니다.
• 또는 하단 상태 바의 브랜치 옆 ↑↓ 아이콘을 클릭합니다.

 

---

 

유용한 내장 기능

Diff 보기

• 변경된 파일을 클릭하면 이전 버전과 현재 버전을 나란히 비교합니다.
• 줄 단위로 어떤 내용이 추가/삭제됐는지 바로 확인 가능합니다.

Gutter Indicator

• 에디터 왼쪽 여백에 파란/초록/빨간 줄이 표시됩니다.
  • 파란 줄 : 수정된 줄입니다.
  • 초록 줄 : 새로 추가된 줄입니다.
  • 빨간 삼각형 : 삭제된 줄이 있는 위치입니다.
• 클릭하면 변경 내용을 미리 보거나 되돌릴 수 있습니다.

Timeline

• 파일 탐색기에서 파일을 우클릭 → Open Timeline 또는 하단 TIMELINE 패널에서 해당 파일의 커밋 이력을 확인합니다.

 

---

 

추천 확장 프로그램

GitLens

Git 기능을 크게 강화해주는 확장입니다. 무료 기능만으로도 충분히 유용합니다.

• 각 줄에 마지막으로 수정한 커밋 정보(누가, 언제, 무슨 메시지로)를 인라인으로 표시합니다.
• 파일/브랜치의 전체 히스토리를 시각적으로 탐색할 수 있습니다.
• 커밋 간 diff 비교가 편리합니다.

설치: Extensions(Ctrl+Shift+X) → GitLens 검색 → 설치

Git Graph

커밋 히스토리를 그래프로 시각화해줍니다. 브랜치 분기/병합 흐름을 한눈에 파악하기 좋습니다.

• 명령 팔레트(Ctrl+Shift+P) → Git Graph: View Git Graph 로 실행합니다.
• 각 커밋을 클릭하면 변경 내용 확인 및 체크아웃이 가능합니다.

설치: Extensions → Git Graph 검색 → 설치

---

터미널에서 Git 병행 사용

VSCode 내장 터미널(Ctrl+`` )에서 git 명령어를 직접 입력하는 게 더 편할 때도 많습니다. GUI(Source Control 패널)와 CLI(터미널)를 섞어 쓰는 게 효율적입니다.

• GUI로 편한 것 : diff 확인, 부분 스테이징, 파일별 변경 내용 시각화
• CLI로 편한 것 : git log, git revert, git reset, 브랜치 작업 등

---

 

GitHub 연동

GitHub 계정 연결

1. VSCode 좌하단 계정 아이콘 클릭 → Sign in with GitHub 선택합니다.
2. 브라우저에서 인증을 완료하면 자동으로 연결됩니다.

연결 후 GitHub Pull Request, Issues 확장 등을 사용하면 VSCode 내에서 PR 생성/리뷰도 가능합니다.

저장소 클론

명령 팔레트(Ctrl+Shift+P) → Git: Clone → GitHub URL 입력 또는 GitHub에서 직접 선택합니다.

---

자주 쓰는 단축키 정리

작업	단축키 (Windows/Linux)	단축키 (macOS)
Source Control 열기	Ctrl+Shift+G	Cmd+Shift+G
터미널 열기	Ctrl+``	Cmd+``
명령 팔레트	Ctrl+Shift+P	Cmd+Shift+P
파일 탐색기	Ctrl+Shift+E	Cmd+Shift+E
확장 프로그램	Ctrl+Shift+X	Cmd+Shift+X

---

생물정보학 작업 시 유의 사항

• Jupyter Notebook(.ipynb)은 내부가 JSON 형식이라 diff가 지저분하게 보입니다.
• nbstripout 을 설치해두면 Output을 자동으로 제거하고 커밋해서 diff가 깔끔해집니다.

pip install nbstripout
nbstripout --install  # 현재 저장소에 적용

• 분석 스크립트는 기능 단위로 커밋하면 나중에 이력 추적이 편합니다.
• 대용량 데이터 파일은 커밋하지 않고 .gitignore에 추가합니다. 필요하면 git-lfs를 사용합니다.