VSCode에서 Git 연동하는 방법

Visual Studio Code(VSCode)는 내장된 Git 기능을 제공하여 소스 코드 관리에 매우 유용합니다. 개발자라면 반드시 쓰게될 git 사용법을 설명하겠습니다.

---

1. Git 설치 및 초기 설정
1. **Git 설치**  
   VSCode에서 Git을 사용하려면 먼저 Git을 설치해야 합니다. 아래의 공식 웹사이트에서 설치 파일을 다운로드하여 설치하세요.  
   - Git 다운로드: [https://git-scm.com](https://git-scm.com) 

2. **Git 설정**  
   설치 후 터미널에서 아래 명령어를 사용하여 사용자 이름과 이메일을 설정합니다.  
   ```bash
   git config --global user.name "Your Name"
   git config --global user.email "youremail@example.com"
   ```
   이 정보는 커밋 기록에 사용됩니다.

---

2. 프로젝트 폴더 준비
1. **폴더 생성**  
   Git과 VSCode에 연동할 프로젝트 폴더를 준비합니다.  
   ⚠️ **중요:** 폴더 경로에 한글, 공백, 특수 문자가 포함되지 않도록 하세요.  
   예: `C:\Projects\MyProject` (권장)  
   잘못된 예: `C:\내문서\내 프로젝트`

2. **VSCode에서 폴더 열기**  
   VSCode를 실행한 후, `파일(File)` → `폴더 열기(Open Folder)`를 클릭하여 프로젝트 폴더를 엽니다.

---

3. Git 초기화 및 연동
1. **Git 초기화**  
   터미널을 열고(단축키: `Ctrl + ~`), 아래 명령어로 Git 저장소를 초기화합니다.  
   ```bash
   git init
   ```
   초기화되면 폴더 내에 `.git` 디렉토리가 생성됩니다.

2. **원격 저장소 연결**  
   GitHub, GitLab 등의 원격 저장소를 생성한 후, 해당 URL을 복사하여 아래 명령어로 연결합니다.  
   ```bash
   git remote add origin https://github.com/username/repository.git
   ```

---

4. 변경사항 관리
1. **파일 상태 확인**  
   변경된 파일을 확인하려면 터미널에서 다음 명령어를 사용합니다.  
   ```bash
   git status
   ```

2. **변경사항 스테이징**  
   특정 파일을 스테이징하려면:  
   ```bash
   git add 파일명
   ```
   모든 파일을 스테이징하려면:  
   ```bash
   git add .
   ```

3. **커밋**  
   커밋 메시지를 작성하여 변경사항을 기록합니다.  
   ```bash
   git commit -m "커밋 메시지"
   ```

---

5. 원격 저장소에 푸시
스테이징 후 커밋이 완료되면 원격 저장소로 푸시합니다.  
```bash
git push -u origin main
```
- `main`은 기본 브랜치 이름입니다. 브랜치 이름이 다를 경우, 적절히 변경하세요.

---

6. VSCode에서 Git 시각화 기능 사용
VSCode의 **소스 제어(Source Control)** 탭(단축키: `Ctrl + Shift + G`)을 통해 변경사항, 스테이징, 커밋, 푸시 작업을 시각적으로 처리할 수 있습니다.  
- 스테이징: 변경된 파일 옆의 `+` 버튼 클릭  
- 커밋: 상단 텍스트 입력란에 메시지 입력 후 체크 표시 클릭  
- 푸시/풀: 오른쪽 하단의 버튼 클릭

---

7. 폴더 경로에 한글 포함 시 문제
Git은 폴더 경로나 파일명에 한글이 포함될 경우, 다음과 같은 문제가 발생할 수 있습니다.
- **경로 인식 문제:** 일부 운영 체제나 터미널 환경에서 경로를 제대로 읽지 못할 수 있습니다.  
- **인코딩 문제:** Git 기록에서 한글 경로나 파일명이 깨지는 경우가 있습니다.

이러한 문제를 방지하려면 **항상 영어와 숫자로만 경로와 파일명을 작성**하세요.

---

VSCode에서 Git 연동은 Git 초기화, 원격 저장소 연결, 변경사항 관리, 커밋 및 푸시 과정을 통해 이루어집니다. 폴더 경로에 한글이 포함되지 않도록 주의하면 Git과 VSCode를 더욱 안정적으로 사용할 수 있습니다. VSCode의 시각화 기능을 활용하면 Git 관리를 직관적으로 수행할 수 있습니다.