빠른 시작: VS Code에서 소스 제어 사용

Visual Studio Code에서 몇 분 안에 Git을 시작하고 실행하세요. 이 가이드에서는 리포지토리 설정, 변경 내용 저장 및 코드 동기화의 필수 사항을 다룹니다.

전제 조건

1. Git 설치: 컴퓨터에 Git이 설치되어 있는지 확인하세요. Git 다운로드

2. VS Code 열기: Visual Studio Code의 최신 버전을 설치했는지 확인하세요.

1단계: 프로젝트 열기

기존 Git 리포지토리 또는 로컬 프로젝트 폴더로 시작할 수 있습니다.

옵션 A: 리포지토리 로컬로 복제

GitHub, Azure DevOps 또는 다른 Git 공급자에 이미 호스팅된 코드를 작업하려는 경우 리포지토리를 복제하세요. 이전에 리포지토리를 복제한 경우 VS Code에서 폴더를 직접 열 수 있으며 VS Code는 Git 리포지토리를 자동으로 감지합니다.

VS Code에서 리포지토리 복제

1. 소스 제어 보기(⌃⇧G (Windows, Linux Ctrl+Shift+G))를 열고 리포지토리 복제를 선택하세요.

   

   또는 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))를 열고 Git: Clone을 입력하세요.

2. 리포지토리 URL을 입력합니다 (예: https://github.com/microsoft/PowerToys).

   GitHub에서 복제하는 경우 GitHub에서 복제를 선택하고 GitHub 계정에 로그인하여 리포지토리 목록을 볼 수도 있습니다.

3. 프로젝트를 저장할 컴퓨터의 상위 폴더를 선택합니다.

4. 복제된 리포지토리를 VS Code에서 열라는 메시지가 표시되면 열기를 선택합니다.

5. 작업 영역 신뢰 대화 상자에서 리포지토리를 신뢰할지 확인합니다.

   주의

   알고 있는 소스의 리포지토리만 신뢰하세요. 신뢰할 수 없는 코드는 컴퓨터에 해를 끼칠 수 있습니다.

옵션 B: 로컬 폴더에서 리포지토리 초기화

Git으로 새 프로젝트를 시작하려면 기존 로컬 폴더에서 리포지토리를 초기화할 수 있습니다. 이 옵션은 변경 내용을 추적하기 위해 폴더에 새 Git 리포지토리를 만듭니다.

1. VS Code에서 프로젝트 폴더를 엽니다 (파일 > 폴더 열기...).

2. 소스 제어 보기(⌃⇧G (Windows, Linux Ctrl+Shift+G))를 열고 리포지토리 초기화를 선택합니다.

   

   또는 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))를 열고 Git: Initialize Repository를 입력합니다.

2단계: 변경 및 검토

Git은 프로젝트의 파일 변경 내용을 추적합니다. VS Code의 소스 제어 보기는 명령줄을 사용하지 않고 이러한 변경 내용을 관리하는 허브입니다.

간단한 코드 변경을 수행하고 소스 제어 보기와 diff 편집기를 사용하여 검토해 보겠습니다.

1. 프로젝트의 기존 파일을 편집하고 저장합니다.

   새 리포지토리를 방금 초기화한 경우 다음 단계로 진행할 수 있습니다.

2. 소스 제어 보기(⌃⇧G (Windows, Linux Ctrl+Shift+G))를 엽니다.

   변경한 파일이 변경 내용 아래에 나열되고 옆에 "U"(추적되지 않음) 또는 "M"(수정됨) 아이콘이 표시되는 것을 볼 수 있습니다. Activity Bar의 소스 제어 아이콘도 영향을 받은 파일 수에 대한 배지로 표시됩니다.

   

3. 파일 변경 내용을 검토하려면 소스 제어 보기에서 해당 파일을 선택하여 diff 편집기를 엽니다.

   Diff 편집기는 현재 버전의 파일과 마지막으로 커밋된 버전 간의 차이를 보여줍니다. 창이 충분히 넓으면 diff 편집기가 나란히 비교를 표시하고, 그렇지 않으면 변경 내용이 인라인으로 표시됩니다.

   

   팁

   Copilot 구독이 있는 경우, 커밋하기 전에 변경 내용에 대한 AI 기반 코드 검토를 수행하려면 소스 제어 보기에서 코드 검토 버튼을 선택하세요.

   

3단계: 스테이징 및 커밋

Git은 변경 내용을 저장하기 위해 스테이징(준비) 및 커밋(저장)의 두 단계 프로세스를 사용합니다. 소스 제어 보기에서 변경 내용은 먼저 변경 내용 아래에 나열되고 스테이징한 후 커밋할 준비가 된 스테이징된 변경 내용으로 이동합니다.

1. 변경 내용을 스테이징하려면 다음 중 하나를 수행하세요.

   • 변경 내용 목록에서 파일에 마우스를 올리고 + (플러스)를 선택하여 스테이징하세요.

     

   • 변경 내용 목록에서 파일에 마우스 오른쪽 버튼을 클릭하고 변경 내용 스테이징을 선택하세요.

   • 변경 내용 헤더에 마우스를 올리고 + (플러스) 버튼을 선택하여 모든 변경 내용을 한 번에 스테이징하세요.

2. (선택 사항) 필요한 경우 변경 내용을 스테이징 취소하거나 변경 내용을 삭제할 수 있습니다.

   • 파일을 스테이징 취소하려면 스테이징된 변경 내용 목록에서 해당 파일에 마우스를 올리고 - (마이너스) 버튼을 선택하세요.

   • 파일 변경 내용을 삭제하려면 변경 내용 목록에서 해당 파일에 마우스 오른쪽 버튼을 클릭하고 변경 내용 삭제를 선택하세요.

3. 스테이징된 변경 내용을 커밋하려면 커밋 메시지를 제공할 수 있습니다.

   1. 소스 제어 보기 맨 위 텍스트 상자에 커밋 메시지를 입력합니다.

      커밋 메시지 입력 상자의 반짝임 아이콘 을 선택하여 스테이징된 변경 내용을 기반으로 커밋 메시지를 생성하기 위해 AI를 사용할 수도 있습니다.

   2. 커밋을 선택하여 변경 내용을 Git 기록에 커밋합니다.

      

      커밋 후 스테이징된 변경 내용은 소스 제어 보기에서 지워지고 로컬 Git 기록에 저장됩니다.

      참고

      스테이징된 변경 내용만 커밋에 포함됩니다. 스테이징되지 않은 변경 내용이 있으면 향후 커밋을 위해 변경 내용 아래에 나열된 상태로 유지됩니다.

4. 커밋 기록을 보려면 소스 제어 보기에서 소스 제어 그래프를 선택하세요.

   

4단계: 서버와 동기화

리포지토리가 원격 서버(예: GitHub 또는 Azure DevOps)에 연결되어 있으면 로컬 커밋을 원격 리포지토리와 동기화할 수 있습니다.

1. 소스 제어 보기(⌃⇧G (Windows, Linux Ctrl+Shift+G))를 엽니다.

2. 변경 내용 동기화를 선택하여 원격에서 최신 변경 내용을 가져오고 로컬 커밋을 푸시합니다.

   

   대안으로, 상태 표시줄은 동기화 상태를 표시하고 동기화 아이콘(회전 화살표)을 선택하여 변경 내용을 동기화할 수 있게 해줍니다.

3. 서버에서 새 변경 내용을 가져오고 커밋을 푸시하려면 선택하세요.

4. 개별적으로 가져오거나 푸시하려면 소스 제어 보기에서 타원 메뉴(...)를 선택하고 가져오기 또는 푸시를 선택하세요.

   

다음 단계

이제 기본 사항을 알았으므로 더 많은 기능을 살펴보세요.

• 브랜치 및 작업 트리 - 브랜치 관리 및 병렬 개발에 대해 알아보세요.
• 리포지토리 및 원격 - 원격 리포지토리 복제, 게시 및 동기화에 대해 알아보세요.
• 병합 충돌 해결 - 브랜치를 병합할 때 충돌을 처리하는 방법을 알아보세요.
• GitHub와 함께 작업하기 - Pull Request 및 문제에 대해 알아보세요.
• 문제 해결 - Git 문제를 진단하고 해결합니다.
• 소스 제어 개요 - 소스 제어 기능에 대한 전체 참조.