이 가이드는 2025년 최신 자료를 바탕으로, 주니어 개발자도 쉽게 따라할 수 있도록 단계별로 설명합니다. 기존 가이드에서 개선할 점과 추가 정보를 반영했습니다.
1. Git이란?
Git은 소스 코드의 변경 이력을 관리하고, 여러 명이 동시에 협업할 수 있게 도와주는 분산 버전 관리 시스템입니다.
- 주요 기능:
- 코드 변경 이력 추적
- 협업 환경 제공
- 이전 상태로 손쉽게 복구
- 오픈소스, 무료로 사용 가능
2. 설치 전 준비사항
- 윈도우 10 이상 권장
- 인터넷 연결 필요
- 관리자 권한이 있는 계정
3. Git 다운로드 및 설치
공식 사이트에서 설치 파일 받기
- 웹 브라우저를 열고 git-scm 공식 사이트에 접속합니다.
- "Download for Windows" 버튼을 클릭해 최신 버전(예: 2.49.0, 2025년 3월 기준)을 다운로드합니다
설치 파일 실행 및 옵션 선택
- 다운로드한 설치 파일(
Git-2.xx.x-64-bit.exe
)을 더블 클릭합니다.
- "사용자 계정 컨트롤" 창이 뜨면 "예"를 클릭합니다.
- 라이선스 동의: "Next" 클릭
- 설치 경로 선택: 기본값 사용 권장, "Next" 클릭
- 컴포넌트 선택:
- "Git Bash", "Git GUI" 체크 권장
- "Windows Explorer integration" 체크 시 폴더에서 바로 Git Bash 실행 가능
- "Desktop Shortcut" 체크하면 바탕화면에 바로가기 생성
- 기타 옵션은 기본값 유지, "Next" 클릭[4][9]
- 시작 메뉴 폴더: 기본값 또는 "Don't create..." 선택 가능, "Next"
- 기본 에디터 선택:
- Visual Studio Code, Vim, Nano 등 선택 가능
- VS Code 설치되어 있다면 선택 추천
- 기본 브랜치 이름:
- "Override the default branch name for new repositories" 선택 후
main
입력 권장
- 환경 변수 등록:
- "Git from the command line and also from 3rd-party software" 선택
- OpenSSH 설정:
- HTTPS 백엔드:
- "Use the OpenSSL library" 선택
- 줄바꿈 방식:
- "Checkout Windows-style, commit Unix-style line endings" 선택
- 터미널 에뮬레이터:
- "Use MinTTY (the default terminal of MSYS2)" 선택
- 기타 옵션:
- "Enable file system caching" 체크
- "Enable Git Credential Manager" 체크
- "Enable symbolic links"은 필요시 체크
- "Install" 클릭하여 설치 진행
- 설치 완료 후 "Finish" 클릭
4. 설치 확인 및 초기 세팅
설치 확인
Win + S
→ "Git Bash" 또는 "명령 프롬프트" 실행
- 아래 명령어로 버전 확인
git --version
- 예시 출력:
git version 2.49.0.windows.1
기본 사용자 정보 등록
Git을 처음 사용할 때 한 번만 등록하면 됩니다.
git config --global user.name "홍길동"
git config --global user.email "your_email@example.com"
도움말 확인
git help -a
5. Git Bash & Git GUI 활용
- Git Bash: 리눅스 명령어와 Git 명령어를 함께 쓸 수 있는 터미널
- Git GUI: 마우스로 Git 기능을 사용할 수 있는 그래픽 툴 (주니어에게 추천)
- Windows Explorer Integration: 폴더에서 마우스 우클릭 → "Git Bash Here"로 바로 진입
6. 새 폴더에서 Git 저장소 만들기
- 새 폴더 생성 (예:
C:\gitTest
)
- 폴더에서 마우스 우클릭 → "Git Bash Here" 선택
- 아래 명령어 입력
git init
7. 파일 추가 및 커밋
# 파일 추가
git add 파일명.txt
# 모든 파일 추가
git add .
# 상태 확인
git status
# 커밋
git commit -m "첫 커밋 메시지"
8. 원격 저장소(예: GitHub) 연결 (선택)
- GitHub 등에서 새 저장소 생성
- 아래 명령어로 원격 저장소 연결
git remote add origin https://github.com/사용자명/저장소명.git
git push -u origin main
9. 설치 및 사용 팁
- winget으로 설치:
최신 Windows에서는 아래 명령어로도 설치 가능:
winget install --id Git.Git -e --source winget
- 업데이트:
새 버전이 나오면 공식 사이트에서 재설치하면 자동으로 업그레이드됨
- 설치 후 환경 변수 자동 등록
(별도 설정 필요 없음)
10. 자주 하는 실수 & 주의사항
- 줄바꿈 문제:
Windows와 Unix 줄바꿈 방식이 달라서, "Checkout Windows-style, commit Unix-style line endings" 옵션을 권장
- 이름/이메일 오타:
커밋 기록에 남으므로 정확히 입력
- 폴더 경로 한글/공백 주의:
가급적 영문, 공백 없는 경로 사용 추천
11. 추가 참고자료
Git for Windows 설치 옵션 상세 설명
아래는 Git for Windows 설치 시 자주 보게 되는 세 가지 옵션의 기능과 체크 여부를 판단할 수 있도록 자세히 설명한 내용입니다.
1. Enable file system caching
- 기능 설명:
이 옵션을 체크하면 Git이 파일 시스템 정보를 메모리에 캐싱합니다. 즉, Git이 파일이나 폴더의 변경 여부를 확인할 때 매번 디스크를 직접 읽지 않고, 한 번 읽어온 정보를 일정 시간 메모리에 저장해두었다가 재사용합니다.
- 장점:
- Git 명령어(
git status
, git add
, git commit
등) 실행 속도가 빨라집니다.
- 대용량 프로젝트나 파일이 많은 저장소에서 더욱 효과적입니다.
- 단점:
- 일반적인 사용 환경에서는 특별한 부작용이 없지만, 매우 드물게 파일 시스템의 변경을 실시간으로 반영하지 못하는 상황이 있을 수 있습니다.
- 체크 권장 여부:
대부분의 경우 체크(활성화)하는 것이 좋습니다. 성능 향상 효과가 크고, 특별한 문제가 발생하는 경우는 드뭅니다[1][4][6].
2. Enable Git Credential Manager
- 기능 설명:
Git Credential Manager(GCM)는 원격 저장소(예: GitHub, GitLab 등)에 접근할 때 사용하는 아이디/비밀번호, 토큰 등 인증 정보를 안전하게 저장하고 관리해주는 도구입니다.
- 주요 역할:
- 최초 인증 정보를 입력하면, 이후에는 자동으로 인증 정보를 불러와 입력 과정을 생략할 수 있습니다.
- 인증 정보를 Windows 자격 증명 관리자(Windows Credential Store)에 암호화하여 저장하므로, 보안성이 높습니다.
- SSH, HTTPS 모두 지원하며, WSL(Windows Subsystem for Linux)에서도 연동 가능합니다.
- 장점:
- 매번 비밀번호를 입력하지 않아도 되어 편리합니다.
- 인증 정보가 안전하게 관리됩니다.
- 단점:
- 별도의 인증 도구 사용을 원하지 않는 경우(예: 직접 관리하고 싶을 때)에는 비활성화할 수 있습니다.
- 체크 권장 여부:
대부분의 사용자는 체크(활성화)하는 것이 편리하고 안전합니다. 기업/조직 정책에 따라 직접 관리가 필요한 경우에만 비활성화하면 됩니다
3. Enable symbolic links
- 기능 설명:
이 옵션을 체크하면 Git이 윈도우에서도 심볼릭 링크(바로가기와 유사한 특수 파일)를 제대로 생성하고 추적할 수 있도록 해줍니다.
- 심볼릭 링크란?
- 파일 또는 폴더에 대한 "참조"를 만들어주는 일종의 링크입니다.
- 예를 들어,
A.txt
라는 파일의 심볼릭 링크를 B.txt
로 만들면, B.txt
를 열었을 때 실제로는 A.txt
의 내용을 보게 됩니다.
- 주의사항:
- 윈도우에서 심볼릭 링크를 사용하려면 "SeCreateSymbolicLink" 권한(일반적으로 관리자 권한)이 필요합니다.
- Windows 10 이상에서는 "개발자 모드"를 활성화하면 일반 사용자도 심볼릭 링크를 만들 수 있습니다.
- 기존에 이미 클론한 저장소에는 이 설정이 바로 적용되지 않습니다. 새로 클론할 때만 적용됩니다.
- 장점:
- 리눅스/유닉스 환경과 동일하게 프로젝트를 관리할 수 있습니다.
- 오픈소스 프로젝트 등에서 심볼릭 링크를 사용하는 경우 필수입니다.
- 단점:
- 권한 문제가 발생할 수 있고, 심볼릭 링크를 잘 모르면 혼란을 줄 수 있습니다.
- 체크 권장 여부:
- 오픈소스 프로젝트 등에서 심볼릭 링크를 사용할 일이 있다면 체크
- 개인 프로젝트나 심볼릭 링크가 필요 없는 경우에는 굳이 체크하지 않아도 무방합니다
요약 표
옵션명 |
기능 요약 |
체크 권장 여부 |
비고/주의사항 |
Enable file system caching |
파일 시스템 정보 캐싱으로 속도 향상 |
대부분 체크 권장 |
성능 향상, 부작용 거의 없음 |
Enable Git Credential Manager |
인증 정보 안전 저장 및 자동 입력 |
대부분 체크 권장 |
보안성↑, 입력 편의성↑ |
Enable symbolic links |
윈도우에서 심볼릭 링크 지원 |
필요 시에만 체크 |
관리자 권한/개발자 모드 필요 |
정리
- 최신 공식 사이트에서 설치 파일 다운로드
- 설치 옵션은 대부분 기본값, 에디터와 브랜치 이름만 신경쓰기
- 설치 후 Git Bash에서 버전 확인, 사용자 정보 등록
- 폴더 생성 →
git init
→ 파일 추가 및 커밋
- 필요시 Git GUI, winget 활용 가능
이 가이드를 따라하면 2025년 기준 윈도우에서 Git을 안전하게 설치하고, 바로 실무에 사용할 수 있습니다.
참고사이트
https://itconquest.tistory.com/entry/git-git-%EC%84%A4%EC%B9%98%ED%95%98%EA%B8%B0-%EC%9D%B4%ED%95%B4%ED%95%98%EA%B8%B0