Git 설치 방법과 필수 초기 설정을 운영체제별로 상세히 안내합니다. Windows, Mac, Linux 환경에서 Git을 올바르게 설치하고 사용자 정보, SSH 키 등 기본 설정을 완료하는 방법을 알아보세요.
Windows에서 Git 설치하기
Windows 사용자라면 Git for Windows를 다운로드해서 설치하는 것이 가장 간단합니다. 공식 웹사이트에서 제공하는 설치 파일을 받아 진행하면 되는데요, 설치 과정에서 몇 가지 선택 사항이 나옵니다.
설치 파일을 실행하면 먼저 기본 에디터 선택 화면이 나타납니다. Vim, Notepad++, Visual Studio Code 등 다양한 옵션이 있지만, 초보자라면 Visual Studio Code를 선택하는 것을 추천합니다. Vim은 사용법이 까다로워 처음 접하는 분들에게는 어려울 수 있거든요.
다음으로 PATH 환경 변수 설정을 선택해야 합니다. “Git from the command line and also from 3rd-party software” 옵션을 선택하면 명령 프롬프트와 PowerShell에서 Git 명령어를 사용할 수 있습니다. 이 옵션이 가장 편리하고 일반적입니다.
줄바꿈 처리 방식도 중요한데요, “Checkout Windows-style, commit Unix-style line endings”를 선택하면 Windows와 다른 운영체제 간 호환성 문제를 예방할 수 있습니다.
설치가 완료되면 Git Bash라는 터미널 프로그램도 함께 설치됩니다. 이것은 리눅스 스타일의 명령어를 Windows에서 사용할 수 있게 해주는 도구입니다.
Git 공식 다운로드: https://git-scm.com/download/win
Mac에서 Git 설치하기
Mac 사용자는 여러 가지 방법으로 Git을 설치할 수 있습니다. 가장 간단한 방법은 Xcode Command Line Tools를 통한 설치입니다.
터미널을 열고 다음 명령어를 입력하면 Git이 자동으로 설치됩니다:
xcode-select --install
이 명령어를 실행하면 팝업 창이 나타나면서 설치를 진행할지 물어봅니다. 설치를 진행하면 Git뿐만 아니라 다른 개발 도구들도 함께 설치되죠.
Homebrew를 사용하는 방법도 있습니다. Homebrew는 Mac용 패키지 관리자로, 다양한 개발 도구를 쉽게 설치하고 관리할 수 있게 해줍니다. Homebrew가 이미 설치되어 있다면 다음 명령어로 Git을 설치할 수 있습니다:
brew install git
Homebrew를 통해 설치하면 최신 버전의 Git을 사용할 수 있고, 업데이트도 간편합니다. brew upgrade git 명령어 하나로 최신 버전으로 업그레이드할 수 있거든요.
macOS 10.9 이상 버전에는 기본적으로 Git이 설치되어 있지만, 오래된 버전일 수 있습니다. 터미널에서 git --version 명령어로 현재 버전을 확인해보세요.
Linux에서 Git 설치하기
Linux는 배포판마다 패키지 관리자가 다르기 때문에 설치 방법도 조금씩 다릅니다. 하지만 모두 매우 간단합니다.
Ubuntu/Debian 계열에서는 APT 패키지 관리자를 사용합니다:
sudo apt update sudo apt install git
Fedora/CentOS/RHEL 계열에서는 DNF 또는 YUM을 사용합니다:
sudo dnf install git (Fedora 22 이상) sudo yum install git (이전 버전)
Arch Linux에서는 Pacman을 사용합니다:
sudo pacman -S git
설치가 완료되면 git --version 명령어로 제대로 설치되었는지 확인할 수 있습니다. 2026년 현재 Git의 최신 안정 버전은 2.40대 이상이며, 정기적으로 업데이트되고 있습니다.
Linux에서는 소스 코드로부터 직접 컴파일하여 설치하는 방법도 있습니다. 최신 기능을 먼저 사용하고 싶거나 특정 설정으로 컴파일하고 싶을 때 유용하지만, 일반 사용자에게는 패키지 관리자를 통한 설치를 추천합니다.
Git 공식 문서 한글판: https://git-scm.com/book/ko/v2
사용자 정보 설정하기
Git 설치가 완료되었다면 가장 먼저 해야 할 일은 사용자 정보 설정입니다. Git은 모든 커밋에 작성자 정보를 기록하기 때문에 이름과 이메일을 설정해야 합니다.
터미널이나 Git Bash를 열고 다음 명령어를 입력하세요:
git config --global user.name "홍길동" git config --global user.email "hong@example.com"
여기서 --global 옵션은 전역 설정을 의미합니다. 컴퓨터의 모든 Git 저장소에서 이 정보를 사용하게 됩니다. 특정 프로젝트에서만 다른 정보를 사용하고 싶다면 해당 프로젝트 폴더에서 --global 옵션 없이 명령어를 실행하면 됩니다.
이메일 주소는 GitHub 계정의 이메일과 동일하게 설정하는 것이 좋습니다. 그래야 GitHub에서 커밋 이력이 제대로 연결되거든요. GitHub에서 비공개 이메일을 사용하고 싶다면 설정에서 제공하는 noreply 이메일 주소를 사용할 수 있습니다.
설정이 제대로 되었는지 확인하려면:
git config --global user.name git config --global user.email
또는 모든 설정을 한 번에 보려면:
git config --list
기본 에디터 설정하기
Git은 커밋 메시지를 작성하거나 충돌을 해결할 때 텍스트 에디터를 사용합니다. 기본적으로 Vim이나 Vi가 설정되어 있는데, 이 에디터들은 사용법이 독특해서 처음 사용하는 분들이 당황하실 수 있습니다.
자신이 편한 에디터로 변경하는 것을 추천합니다. Visual Studio Code를 사용한다면:
git config --global core.editor "code --wait"
Sublime Text를 사용한다면:
git config --global core.editor "subl -n -w"
Notepad++ (Windows):
git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"
Nano (Linux/Mac):
git config --global core.editor "nano"
--wait 옵션이나 -w 옵션은 Git이 에디터가 닫힐 때까지 기다리도록 하는 설정입니다. 이 옵션이 없으면 Git이 에디터를 열자마자 바로 다음 작업을 진행해버려서 문제가 생길 수 있습니다.
줄바꿈 설정하기
Windows와 Linux/Mac은 줄바꿈 문자를 다르게 처리합니다. Windows는 CRLF(Carriage Return + Line Feed)를 사용하고, Linux/Mac은 LF(Line Feed)만 사용하죠. 이 차이 때문에 협업할 때 문제가 생길 수 있습니다.
Windows 사용자라면:
git config --global core.autocrlf true
이 설정은 체크아웃할 때는 LF를 CRLF로 변환하고, 커밋할 때는 CRLF를 LF로 변환합니다. Windows에서 작업하면서도 저장소에는 LF로 저장되도록 하는 거죠.
Mac/Linux 사용자라면:
git config --global core.autocrlf input
이 설정은 커밋할 때만 CRLF를 LF로 변환하고, 체크아웃할 때는 변환하지 않습니다. 실수로 CRLF가 포함된 파일이 저장소에 들어가는 것을 막아줍니다.
팀 전체가 같은 운영체제를 사용한다면 이 설정이 필요 없을 수도 있지만, 크로스 플랫폼 협업을 한다면 반드시 설정해야 합니다.
SSH 키 생성 및 등록하기
GitHub, GitLab 같은 원격 저장소와 안전하게 통신하려면 SSH 키를 설정하는 것이 좋습니다. 비밀번호를 매번 입력하지 않아도 되고, 보안도 더 강력하거든요.
먼저 SSH 키가 이미 있는지 확인해봅니다:
ls -al ~/.ssh
id_rsa와 id_rsa.pub 또는 id_ed25519와 id_ed25519.pub 파일이 있다면 이미 SSH 키가 있는 것입니다. 없다면 새로 생성해야 합니다.
SSH 키 생성하기:
ssh-keygen -t ed25519 -C "your_email@example.com"
Ed25519 알고리즘을 지원하지 않는 오래된 시스템이라면:
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
명령어를 실행하면 키를 저장할 위치와 암호를 입력하라고 합니다. 기본 위치를 사용하려면 그냥 엔터를 누르고, 추가 보안을 원한다면 암호를 설정하세요.
생성된 공개 키를 복사합니다:
cat ~/.ssh/id_ed25519.pub
출력된 내용을 복사해서 GitHub 설정의 SSH Keys 섹션에 추가하면 됩니다. GitHub 우측 상단 프로필 사진을 클릭하고 Settings → SSH and GPG keys → New SSH key를 선택하세요.
기본 브랜치 이름 설정하기
Git의 기본 브랜치 이름은 전통적으로 master였지만, 최근에는 main을 사용하는 것이 표준이 되어가고 있습니다. GitHub도 2020년부터 기본 브랜치 이름을 main으로 변경했죠.
새로 만드는 저장소의 기본 브랜치 이름을 main으로 설정하려면:
git config --global init.defaultBranch main
이 설정을 하면 git init 명령어로 새 저장소를 만들 때 자동으로 main 브랜치가 생성됩니다. 기존 프로젝트의 브랜치 이름을 변경하고 싶다면 별도의 작업이 필요합니다.
자격 증명 저장하기
HTTPS를 통해 원격 저장소에 접근할 때 매번 사용자 이름과 비밀번호를 입력하는 것은 번거롭습니다. 자격 증명 헬퍼를 사용하면 한 번 입력한 정보를 저장해둘 수 있습니다.
Windows에서는:
git config --global credential.helper wincred
또는 최신 버전의 Git for Windows를 사용한다면:
git config --global credential.helper manager
Mac에서는:
git config --global credential.helper osxkeychain
Linux에서는:
git config --global credential.helper cache
이 설정은 자격 증명을 15분간 메모리에 저장합니다. 더 오래 저장하고 싶다면:
git config --global credential.helper 'cache --timeout=3600'
초 단위로 설정하므로 3600은 1시간을 의미합니다.
별칭(Alias) 설정하기
자주 사용하는 Git 명령어는 별칭을 만들어두면 편리합니다. 긴 명령어를 짧게 줄일 수 있거든요.
유용한 별칭 몇 가지:
git config --global alias.co checkout git config --global alias.br branch git config --global alias.ci commit git config --global alias.st status
이제 git checkout 대신 git co만 입력해도 됩니다. 더 복잡한 명령어도 별칭으로 만들 수 있습니다:
git config --global alias.lg "log --oneline --graph --all --decorate"
이제 git lg만 입력하면 보기 좋게 정리된 커밋 히스토리를 볼 수 있습니다.
Git 설정 파일 직접 수정하기
모든 Git 설정은 .gitconfig 파일에 저장됩니다. 이 파일을 직접 열어서 수정할 수도 있습니다:
git config --global --edit
이 명령어는 기본 에디터로 설정 파일을 엽니다. 여러 설정을 한꺼번에 수정하거나, 복잡한 설정을 추가할 때 유용합니다.
전역 설정 파일의 위치는:
- Windows:
C:\Users\사용자명\.gitconfig - Mac/Linux:
~/.gitconfig
프로젝트별 설정은 해당 프로젝트의 .git/config 파일에 저장됩니다.
설정 확인 및 문제 해결
설정이 제대로 되었는지 확인하는 방법은 여러 가지가 있습니다. 전체 설정을 보려면:
git config --list --show-origin
이 명령어는 각 설정값이 어느 파일에서 왔는지도 함께 보여줍니다. 같은 설정이 여러 곳에 있을 때 어느 것이 적용되는지 파악하기 좋습니다.
특정 설정값만 확인하려면:
git config user.name
일반적인 문제와 해결 방법:
- Git 명령어를 찾을 수 없다는 오류가 나올 때: PATH 환경 변수에 Git이 추가되지 않았을 가능성이 큽니다. 재설치하거나 수동으로 PATH에 추가하세요.
- 커밋할 때 작성자 정보가 없다는 오류: user.name과 user.email이 설정되지 않았습니다. 위에서 설명한 대로 설정하세요.
- SSH 연결이 안 될 때: SSH 키가 제대로 등록되었는지, ssh-agent가 실행 중인지 확인하세요.
마치며
Git 설치와 초기 설정은 복잡해 보이지만, 한 번만 제대로 해두면 앞으로 개발 작업이 훨씬 수월해집니다. 사용자 정보 설정, SSH 키 등록, 에디터 설정 정도만 완료해도 기본적인 Git 사용에는 문제가 없습니다.
처음에는 명령어가 낯설고 어려울 수 있지만, 자주 사용하다 보면 자연스럽게 익숙해집니다. 중요한 것은 버전 관리의 개념을 이해하고, 필요할 때마다 찾아보며 학습하는 자세입니다.
Git을 제대로 활용하면 코드의 이력을 추적하고, 실수를 되돌리고, 팀원들과 효율적으로 협업할 수 있습니다. 개발자로서 성장하는 데 있어 Git은 필수 도구이니, 지금부터라도 차근차근 익혀보세요.