재우니 개발자 블로그

 

이 가이드는 2025년 최신 자료를 바탕으로, 주니어 개발자도 쉽게 따라할 수 있도록 단계별로 설명합니다. 기존 가이드에서 개선할 점과 추가 정보를 반영했습니다.


1. Git이란?

Git은 소스 코드의 변경 이력을 관리하고, 여러 명이 동시에 협업할 수 있게 도와주는 분산 버전 관리 시스템입니다.

  • 주요 기능:
    • 코드 변경 이력 추적
    • 협업 환경 제공
    • 이전 상태로 손쉽게 복구
    • 오픈소스, 무료로 사용 가능

2. 설치 전 준비사항

  • 윈도우 10 이상 권장
  • 인터넷 연결 필요
  • 관리자 권한이 있는 계정

3. Git 다운로드 및 설치

공식 사이트에서 설치 파일 받기

  1. 웹 브라우저를 열고 git-scm 공식 사이트에 접속합니다.
  2. "Download for Windows" 버튼을 클릭해 최신 버전(예: 2.49.0, 2025년 3월 기준)을 다운로드합니다

설치 파일 실행 및 옵션 선택

  1. 다운로드한 설치 파일(Git-2.xx.x-64-bit.exe)을 더블 클릭합니다.
  2. "사용자 계정 컨트롤" 창이 뜨면 "예"를 클릭합니다.
  3. 라이선스 동의: "Next" 클릭
  4. 설치 경로 선택: 기본값 사용 권장, "Next" 클릭
  5. 컴포넌트 선택:
    • "Git Bash", "Git GUI" 체크 권장
    • "Windows Explorer integration" 체크 시 폴더에서 바로 Git Bash 실행 가능
    • "Desktop Shortcut" 체크하면 바탕화면에 바로가기 생성
    • 기타 옵션은 기본값 유지, "Next" 클릭[4][9]
  6. 시작 메뉴 폴더: 기본값 또는 "Don't create..." 선택 가능, "Next"
  7. 기본 에디터 선택:
    • Visual Studio Code, Vim, Nano 등 선택 가능
    • VS Code 설치되어 있다면 선택 추천
  8. 기본 브랜치 이름:
    • "Override the default branch name for new repositories" 선택 후 main 입력 권장
  9. 환경 변수 등록:
    • "Git from the command line and also from 3rd-party software" 선택
  10. OpenSSH 설정:
    • "Use bundled OpenSSH" 선택
  11. HTTPS 백엔드:
    • "Use the OpenSSL library" 선택
  12. 줄바꿈 방식:
    • "Checkout Windows-style, commit Unix-style line endings" 선택
  13. 터미널 에뮬레이터:
    • "Use MinTTY (the default terminal of MSYS2)" 선택
  14. 기타 옵션:
    • "Enable file system caching" 체크
    • "Enable Git Credential Manager" 체크
    • "Enable symbolic links"은 필요시 체크
  15. "Install" 클릭하여 설치 진행
  16. 설치 완료 후 "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 저장소 만들기

  1. 새 폴더 생성 (예: C:\gitTest)
  2. 폴더에서 마우스 우클릭 → "Git Bash Here" 선택
  3. 아래 명령어 입력
git init
  • .git 폴더가 생성되면 성공

7. 파일 추가 및 커밋

# 파일 추가
git add 파일명.txt

# 모든 파일 추가
git add .

# 상태 확인
git status

# 커밋
git commit -m "첫 커밋 메시지"

8. 원격 저장소(예: GitHub) 연결 (선택)

  1. GitHub 등에서 새 저장소 생성
  2. 아래 명령어로 원격 저장소 연결
git remote add origin https://github.com/사용자명/저장소명.git
git push -u origin main
  • SSH 사용 시 별도 키 등록 필요[6]

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