Windows·Mac·Linux Git 설치 방법과 VS Code 연동

1월 02, 2026

Git 설치 방법과 VS Code 연동 설정을 초보자도 따라할 수 있게 단계별로 설명합니다. Windows, Mac, Linux 환경별 설치부터 실전 활용까지 한번에 해결하세요.

Git이 개발자에게 필수인 이유

코드를 작성하다 보면 이전 버전으로 돌아가고 싶거나, 여러 명이 동시에 작업해야 하는 상황이 생깁니다. Git은 소스코드의 변경 이력을 관리해주는 버전 관리 시스템으로, 전 세계 개발자들이 가장 많이 사용하는 도구입니다.

특히 2026년 현재 GitHub, GitLab, Bitbucket 등 대부분의 협업 플랫폼이 Git을 기반으로 운영되고 있어, 개발자라면 반드시 익혀야 할 기술입니다. VS Code와 연동하면 터미널 명령어 없이도 직관적인 인터페이스로 Git을 활용할 수 있습니다.

Windows 환경에서 Git 설치하기

Git 공식 사이트에서 다운로드

Windows 사용자라면 Git 공식 홈페이지에서 설치 파일을 받을 수 있습니다. 검색창에 'Git for Windows'를 입력하거나 git-scm.com에 접속하면 자동으로 운영체제를 감지해 적합한 버전을 제안합니다.

다운로드한 실행 파일을 더블클릭하면 설치 마법사가 시작됩니다. 기본 설정으로 진행해도 대부분의 경우 문제없이 사용할 수 있지만, 몇 가지 옵션은 확인하는 것이 좋습니다.

설치 옵션 선택 가이드

설치 과정에서 여러 옵션이 나타나는데, "Git Bash Here"와 "Git GUI Here" 옵션을 체크하면 나중에 폴더에서 마우스 우클릭으로 바로 Git을 실행할 수 있어 편리합니다.

텍스트 에디터 선택 화면에서는 VS Code를 기본 에디터로 설정할 수 있습니다. 드롭다운 메뉴에서 'Use Visual Studio Code as Git's default editor'를 선택하세요.

PATH 환경 변수 설정은 "Git from the command line and also from 3rd-party software" 옵션을 권장합니다. 이렇게 하면 명령 프롬프트나 PowerShell 어디서든 Git 명령어를 사용할 수 있습니다.

Mac에서 Git 설치 및 확인

Homebrew를 활용한 간편 설치

Mac 사용자는 Homebrew 패키지 관리자를 이용하면 한 줄의 명령어로 Git을 설치할 수 있습니다. 터미널을 열고 다음 명령어를 입력하세요.

brew install git

Homebrew가 설치되어 있지 않다면 brew.sh 사이트에서 설치 스크립트를 복사해 실행하면 됩니다. 2026년 기준 최신 버전의 Git이 자동으로 설치됩니다.

Xcode Command Line Tools 활용

Homebrew 없이도 설치할 수 있는 방법이 있습니다. 터미널에서 git --version 명령어를 입력하면, Git이 설치되어 있지 않은 경우 자동으로 Command Line Tools 설치를 제안합니다.

설치가 완료되면 다시 git --version을 실행해 버전 정보가 나타나는지 확인하세요. Git 2.40 이상의 버전이라면 최신 기능을 모두 사용할 수 있습니다.

Linux 환경별 Git 설치 방법

Ubuntu/Debian 계열

Ubuntu나 Debian을 사용한다면 APT 패키지 관리자로 설치합니다. 터미널에서 다음 명령어를 순서대로 실행하세요.

sudo apt update
sudo apt install git

첫 번째 명령어로 패키지 목록을 최신화하고, 두 번째 명령어로 Git을 설치합니다. 관리자 권한이 필요하므로 비밀번호 입력을 요구할 수 있습니다.

Fedora/CentOS 계열

Red Hat 계열 배포판에서는 DNF나 YUM을 사용합니다. Fedora 최신 버전은 다음과 같이 설치하세요.

sudo dnf install git

CentOS 7 이하 버전에서는 sudo yum install git 명령어를 사용합니다. 설치 후 git --version으로 정상 설치를 확인하세요.

VS Code에서 Git 기본 설정하기

사용자 정보 등록

Git을 처음 사용하기 전에 이름과 이메일을 등록해야 합니다. 이 정보는 커밋 이력에 기록되므로 정확하게 입력하세요. VS Code 터미널을 열고 다음 명령어를 입력합니다.

git config --global user.name "홍길동"
git config --global user.email "example@email.com"

이메일은 GitHub나 GitLab에서 사용하는 것과 동일하게 설정하는 것이 좋습니다. 그래야 커밋 이력이 프로필과 연결됩니다.

VS Code Git 확장 기능 확인

VS Code는 기본적으로 Git 기능이 내장되어 있습니다. 왼쪽 사이드바에서 소스 제어 아이콘(가지 모양)을 클릭하면 Git 관련 기능을 사용할 수 있습니다.

추가로 GitLens 확장 프로그램을 설치하면 더욱 강력한 기능을 활용할 수 있습니다. 확장 마켓플레이스에서 'GitLens'를 검색해 설치하세요. 코드 라인별 작성자, 수정 시간 등을 실시간으로 확인할 수 있습니다.

첫 Git 저장소 만들기

새 프로젝트에서 시작하기

VS Code에서 프로젝트 폴더를 열고 Ctrl+Shift+P(Mac은 Cmd+Shift+P)를 눌러 명령 팔레트를 엽니다. 'Git: Initialize Repository'를 입력하고 실행하세요.

현재 폴더에 .git 숨김 폴더가 생성되면서 Git 저장소로 초기화됩니다. 이제 파일 변경사항을 추적할 수 있는 준비가 완료됩니다.

파일 추가와 첫 커밋

소스 제어 탭에서 변경된 파일 목록을 확인할 수 있습니다. + 버튼을 클릭해 스테이징 영역에 추가하고, 상단의 메시지 입력창에 '첫 커밋' 같은 설명을 작성한 뒤 체크 버튼을 누르면 커밋이 완료됩니다.

VS Code의 타임라인 기능을 활용하면 파일별 변경 이력을 시각적으로 확인할 수 있습니다. 탐색기에서 파일을 선택하고 하단의 타임라인 패널을 펼치면 모든 커밋 기록이 나타납니다.

브랜치 생성과 병합 실습

브랜치로 안전하게 작업하기

새로운 기능을 개발할 때는 별도의 브랜치를 만들어 작업하는 것이 안전합니다. VS Code 하단 상태바에서 현재 브랜치 이름을 클릭하면 브랜치 목록이 나타납니다.

'새 분기 만들기'를 선택하고 feature/login 같은 이름을 입력하세요. 이제 이 브랜치에서 작업한 내용은 메인 브랜치에 영향을 주지 않습니다.

변경사항 병합하기

작업이 완료되면 다시 메인 브랜치로 전환합니다. 명령 팔레트에서 **'Git: Merge Branch'**를 실행하고 방금 작업한 브랜치를 선택하세요.

충돌이 발생하면 VS Code가 시각적인 병합 에디터를 제공합니다. 어떤 변경사항을 유지할지 선택하고 저장하면 병합이 완료됩니다.

GitHub와 연동해 협업하기

원격 저장소 연결

GitHub에서 새 저장소를 만든 뒤 제공되는 HTTPS 주소를 복사합니다. VS Code 터미널에서 다음 명령어로 원격 저장소를 등록하세요.

git remote add origin https://github.com/username/repository.git

이제 'Git: Push' 명령으로 로컬 커밋을 GitHub에 업로드할 수 있습니다. 처음 푸시할 때는 GitHub 계정 인증을 요구합니다.

Pull과 Push로 동기화

팀원이 작업한 내용을 받아오려면 **'Git: Pull'**을 실행합니다. 원격 저장소의 최신 변경사항이 로컬로 다운로드됩니다.

로컬에서 작업한 커밋을 공유하려면 **'Git: Push'**를 사용하세요. VS Code는 자동으로 푸시가 필요한 커밋이 있는지 확인하고 알림을 표시합니다.

실전 Git 활용 팁

.gitignore로 불필요한 파일 제외

프로젝트 루트에 .gitignore 파일을 만들어 Git이 무시할 파일을 지정할 수 있습니다. node_modules 폴더나 환경 변수 파일처럼 공유할 필요 없는 파일을 등록하세요.

node_modules/
.env
*.log

VS Code는 .gitignore에 등록된 파일을 회색으로 표시해 시각적으로 구분할 수 있게 해줍니다.

커밋 메시지 작성 규칙

좋은 커밋 메시지는 협업의 시작입니다. 첫 줄은 50자 이내로 요약하고, 필요하면 빈 줄 다음에 상세 설명을 추가하세요.

feat: 로그인 API 연동 기능 추가

사용자 인증을 위한 JWT 토큰 처리 로직 구현
- API 엔드포인트 연결
- 토큰 저장 및 갱신 처리

Conventional Commits 형식을 따르면 자동화 도구와의 호환성도 좋아집니다.

자주 발생하는 문제 해결

인증 오류 해결

GitHub 연동 시 인증 오류가 발생하면 Personal Access Token을 사용하세요. GitHub 설정에서 토큰을 생성하고, 비밀번호 대신 입력하면 됩니다.

VS Code는 Credential Manager를 통해 인증 정보를 안전하게 저장합니다. 한 번 로그인하면 이후에는 자동으로 인증됩니다.

병합 충돌 해결

같은 파일의 같은 부분을 여러 사람이 수정하면 병합 충돌이 발생합니다. VS Code는 충돌 부분을 강조 표시하고, 'Accept Current Change', 'Accept Incoming Change' 같은 버튼을 제공합니다.

복잡한 충돌은 3-way merge 뷰를 활용하세요. 현재 변경사항, 들어오는 변경사항, 공통 조상을 동시에 비교하며 수정할 수 있습니다.

Git 학습을 위한 추천 리소스

공식 문서와 튜토리얼을 참고하면 더 깊이 있는 학습이 가능합니다. Git 공식 홈페이지에서 한글 문서를 제공하며, VS Code 공식 사이트에도 Git 연동 가이드가 있습니다.

실습 환경이 필요하다면 Git 연습 사이트를 활용하세요. 브라우저에서 직접 명령어를 입력하며 배울 수 있어 초보자에게 유용합니다.

YouTube에는 한글 Git 강의가 많이 있습니다. 실무 중심의 워크플로우를 다루는 영상을 찾아보면 현업에서 어떻게 활용하는지 감을 잡을 수 있습니다.

지금 바로 시작하세요

Git과 VS Code의 조합은 2026년 현재 가장 효율적인 개발 환경 중 하나입니다. 초기 설정만 완료하면 버전 관리, 협업, 코드 리뷰까지 하나의 도구로 해결할 수 있습니다.

처음에는 복잡해 보일 수 있지만, 기본 명령어 몇 개만 익히면 일상적인 작업은 충분히 처리할 수 있습니다. commit, push, pull 세 가지만 기억해도 협업에 참여할 수 있습니다.

무엇보다 중요한 것은 직접 사용해보는 것입니다. 개인 프로젝트를 만들어 하루 한 번씩 커밋하는 습관을 들이면, 어느새 Git이 자연스러운 개발 도구가 되어 있을 것입니다.

👉 Git 공식 다운로드: https://git-scm.com/downloads
👉 VS Code 다운로드: https://code.visualstudio.com/download

가이드론