깃(Git)과 깃허브(GitHub) 연동 (MacOS)

진정·2025년 4월 24일
post-thumbnail

About Git

MacOS 환경에서 깃(Git)과 깃허브(GitHub)를 연동하는 전체적인 과정을 복습 -> 이후, 깃과 깃허브를 통해 효율적으로 프로젝트를 관리하고 협업할 수 있도록 기본적인 개념부터 실제 연동 순서, 그리고 활용 방법까지 정리해봄


1. 깃(Git) 설치 및 초기 설정

#깃 버전 확인
git --version
  • 만약 깃이 설치되어 있다면 설치된 버전 정보가 출력될 것 / 만약 "command not found"와 같은 메시지가 나타난다면 깃을 설치해야 함
  • macOS에서는 Homebrew를 통해 간단하게 깃을 설치할 수 있음
brew install git
  • 깃 설치가 완료되면 다시 git --version 명령어를 입력하여 설치를 확인합니다.

이제 깃 사용자 정보를 설정해야 함 => 이 정보는 커밋(commit) 기록에 남게 되며 터미널에 다음 명령어를 입력하고 본인의 이름과 이메일 주소로 변경

git config --global user.name "본인 이름"
git config --global user.email "본인 이메일 주소"

2. 깃허브(GitHub) 계정 생성 및 리포지토리 만들기

  1. 깃허브 웹사이트 오른쪽 상단의 "+" 버튼을 클릭하고 "New repository"를 선택
  2. 리포지토리 이름(Repository name)을 입력 (예: my-project)
  3. 리포지토리 설명(Description, optional)을 추가
  4. Public 또는 Private 설정을 선택
  5. "Add a README file" 옵션을 선택하면 리포지토리에 대한 간단한 설명을 담은 README.md 파일이 자동으로 생성됨
  6. ".gitignore" 템플릿과 "License"는 필요에 따라 선택하거나 나중에 추가할 수 있음(license는 보통 MIT License로 선택)
  7. "Create repository" 버튼을 클릭하여 새로운 리포지토리를 생성
  8. 리포지토리가 생성되면 해당 리포지토리의 주소(URL)가 표시되며, 이 주소는 나중에 로컬 저장소와 연결할 때 사용됨 (예: https://github.com/본인_계정명/my-project.git)

3. 로컬 저장소 생성 및 깃허브 리포지토리 연동

  1. 터미널을 열고 프로젝트를 저장할 폴더로 이동 (예: cd ~/Documents/Projects)

  2. 새로운 프로젝트 폴더를 만들고 이동

mkdir my-local-project
cd my-local-project
  1. 현재 폴더를 깃 로컬 저장소로 초기화
git init
  • 이 명령어를 실행하면 현재 폴더 안에 .git이라는 숨겨진 폴더가 생성 - 이 폴더에 깃 관련 정보들이 저장됨
  1. 로컬 저장소와 깃허브 원격 리포지토리를 연결 - 앞에서 생성한 깃허브 리포지토리의 주소(URL)를 사용하여 다음 명령어를 입력
git remote add origin https://github.com/본인_계정명/my-project.git
  • origin은 원격 리포지토리의 기본 이름으로 사용됨 (특별한 이유가 없다면 origin을 사용하는 것이 일반적)
  1. 원격 리포지토리가 제대로 연결되었는지 확인
git remote -v
  • 이 명령어를 실행하면 origin이라는 이름으로 연결된 원격 리포지토리의 주소(fetch, push)가 표시됨

4. 변경 사항 커밋 및 깃허브에 푸시(Push)

PUSH : 로컬에서 작업한 내용(파일 추가, 수정 등)을 깃허브 리포지토리로 업로드하는 과정

  1. 프로젝트 폴더에 필요한 파일들을 추가하거나 수정 (vim 활용)

  2. 변경 사항을 스테이징(staging-스테이징은 커밋할 변경 사항을 선택하는 과정) 모든 변경 사항을 스테이징하려면 다음 명령어를 사용

git add .
  1. 특정 파일만 스테이징하려면 파일 이름을 명시
git add 파일명1 파일명2
  1. 스테이징된 변경 사항을 커밋 (커밋은 변경 사항에 대한 설명을 남기는 작업)
git commit -m "커밋 메시지 작성 (예: Initial commit, Add new feature)"
  1. 로컬 커밋을 깃허브 원격 리포지토리로 푸시 / 처음 푸시할 때는 -u 또는 --set-upstream 옵션을 사용하여 로컬 브랜치와 원격 브랜치를 연결해 주는 것이 좋음
git push -u origin main
또는
git push --set-upstream origin main
  • 일반적으로 기본 브랜치 이름은 main 또는 master입니다. 깃허브에서 새로 생성한 리포지토리의 기본 브랜치 이름이 무엇인지 확인하고 해당 이름으로 명령어를 실행하세요. (최근에는 main이 기본으로 설정되는 경우가 많습니다.)

5. 깃허브 리포지토리 내용 가져오기 (Clone & Pull)

  • 다른 사람의 리포지토리나 이전에 깃허브에 올려둔 리포지토리를 로컬로 가져오고 싶을 때는 클론(clone)을 사용
  • 이미 로컬 저장소에서 작업을 하던 중 원격 리포지토리의 변경 사항을 가져오고 싶을 때는 풀(pull)을 사용
  1. 클론 (Clone): 원격 리포지토리를 통째로 복사하여 로컬에 새로운 폴더를 만듬
git clone https://github.com/본인_계정명/my-project.git
  1. 풀 (Pull): 로컬 저장소에서 작업 중 원격 리포지토리의 최신 변경 사항을 가져와 병합 - 먼저 해당 로컬 저장소 폴더로 이동한 후 다음 명령어를 실행
git pull origin main

0개의 댓글