편집기와 Git 준비하기

VS Code의 Git 기능은 PC에 설치된 Git을 사용합니다. 먼저 Git 공식 설치 안내를 확인하고 설치를 마친 뒤 VS Code를 다시 엽니다. 통합 터미널에서 다음 명령이 버전을 출력하는지 확인하세요.

git --version

버전이 나오지 않으면 Git 설치·PATH·편집기 재시작을 먼저 점검합니다. GitHub 로그인 화면만 반복해서 열어도 설치된 Git을 찾지 못하는 문제는 해결되지 않습니다.

연습에는 기존 저장소 밖의 새 폴더를 사용합니다. 회사 프로젝트나 기존 사이트 폴더에서 초기화를 반복하지 마세요.

새 폴더를 저장소로 초기화하기

  1. 새 git-practice 폴더를 만들고 File > Open Folder로 엽니다.
  2. Ctrl+Shift+G로 소스 제어 화면을 열고 Initialize Repository를 선택합니다. 버튼이 없으면 명령 팔레트에서 Git: Initialize Repository를 실행합니다.
  3. 이 연습 저장소에 기록할 이름과 이메일을 설정합니다. 아래 명령은 --global을 사용하지 않으므로 현재 저장소에만 적용됩니다.
git config user.name "Practice Writer"
git config user.email "writer@example.com"

위 이름과 이메일은 연습용입니다. 실제 프로젝트에서는 커밋에 기록해도 되는 본인 정보를 사용하세요. 이 정보는 커밋 작성자 표시이며 GitHub 비밀번호나 로그인 자격 증명이 아닙니다.

첫 커밋에 넣을 파일 고르기

폴더에 README.md를 만들고 다음 내용을 저장하세요.

# 연습 프로젝트

상태: 초안
  1. 소스 제어의 변경 목록에서 README.md를 선택해 내용을 확인합니다. 새 파일에는 보통 추적되지 않음을 뜻하는 U가 표시됩니다.
  2. 파일 옆의 +로 스테이징합니다. 파일이 스테이징된 변경 목록으로 이동합니다.
  3. 커밋 메시지에 Add practice README를 입력하고 Commit을 선택합니다.
  4. 소스 제어 그래프에서 방금 메시지의 커밋을 열어 README.md가 포함됐는지 확인합니다.

파일 저장은 디스크에 내용을 쓰는 동작이고, 커밋은 스테이징한 내용을 Git 이력에 남기는 동작입니다. 여기까지는 서버에 업로드하지 않습니다.

여러 변경 중 원하는 것만 남기기

첫 커밋 다음에 README.md의 상태를 검토 중으로 바꾸고, 별도 notes.md 파일에는 개인 연습 메모를 적었다고 가정해 보겠습니다.

단계 README.md notes.md 다음 커밋에 들어갈 내용
두 파일을 저장한 직후 변경됨 새 파일 아직 스테이징하지 않음
README만 + 선택 스테이징됨 변경 목록에 남음 README의 상태 변경
커밋 완료 해당 변경이 이력에 저장됨 계속 변경 목록에 남음 notes는 이번 커밋에서 제외

커밋 전에 스테이징된 파일을 다시 열어 비교하세요. 스테이징 후 같은 파일을 또 수정하면 그 파일이 스테이징 목록과 일반 변경 목록에 동시에 보일 수 있습니다. 두 목록은 각각 커밋할 버전과 그 이후 편집을 나타냅니다.

이미 추적 중인 파일의 일부 줄만 넣으려면 diff 편집기에서 필요한 범위를 선택하고 Stage Selected Ranges를 사용합니다. 원하는 줄이 스테이징된 diff에 들어갔는지 다시 확인한 뒤 커밋하세요. 새 파일 전체를 처음 추가하는 단계와 혼동하지 않습니다.

되돌리기와 업로드 버튼 구분하기

하려는 일 사용할 동작 남는 것
커밋 대상에서 파일 빼기 스테이징 목록의 -로 해제 편집 내용은 작업 폴더에 유지
편집 자체 버리기 변경 취소 동작 저장하지 않은 수정이 사라질 수 있음
로컬 이력 저장 Commit 현재 저장소의 커밋
원격 저장소에 보내기 Push 또는 Publish 원격 연결·권한이 필요한 외부 반영
원격 변경과 맞추기 Pull 또는 Sync 원격 변경 통합, Sync에는 push도 포함

커밋에서 제외하려는 목적이라면 변경 취소 대신 스테이징 해제를 사용하세요. 원격에 보내려는 단계가 아니라면 Publish나 Sync를 누를 필요가 없습니다.

커밋이 안 될 때 확인하기

  • 작성자 이름·이메일 오류: 현재 저장소에서 설정한 값을 확인합니다. git config user.name과 git config user.email로 읽을 수 있습니다.
  • 스테이징된 변경이 없음: 커밋에 넣을 파일을 명시적으로 선택합니다. 편집기를 저장했다는 사실만으로 스테이징되지는 않습니다.
  • 파일을 고쳤는데 변경 목록이 비어 있음: 연 폴더가 해당 저장소인지, .gitignore 제외 대상인지 확인합니다.
  • Push 인증 오류: 로컬 커밋 문제와 별개입니다. 원격 주소·계정 권한을 기존 GitHub 협업 안내에서 확인합니다.

목적별 가이드

하려는 일 가이드
웹에서 GitHub 저장소 만들기 GitHub 첫 저장소
별도 데스크톱 앱에서 작업하기 GitHub Desktop 사용법
원격 브랜치·PR로 협업하기 GitHub 협업 가이드
Python 파일을 실행하기 VS Code Python 실행·디버깅

참고 자료

2026년 11월 11일 공식 문서 기준입니다. 위 파일과 diff는 자체 연습 사례이며 실제 VS Code GUI·GitHub 계정에서 수행한 기록이 아닙니다.