cd /path/to/your/project
git init
git branch -M main
git add .gitignore .gitattributes
git commit -m "Initial Commit" # main 브랜치 설정 후 최초 커밋 해야 함
git remote add origin [url]
git push -u origin main
git switch -c <new 브런치> # dev 브랜치를 생성하고 여기에 기록하고 싶을 때
git add .
git commit -m "~~~ Commit"
git push --set-upstream origin <new 브런치> # GitHub에는 dev 브랜치가 없기 때문에 해당 명령어 실행
1. GitHub에 New Repository 생성
깃허브 로그인 후 New repository 생성
README, .gitignore 추가하지 말고 Create repository 클릭
저장소 비워둬야 로컬이랑 충돌 ❌
이미 README, .gitignore, 파일 등이 올라가 있으면 로컬 프로젝트랑 커밋 기록이 달라서 error 발생 이럴 땐 "git pull origin main --allow-unrelated-histories"로 병합, 로컬이나 원격 중 하나를 초기화
2. 로컬 저장소(PC)의 프로젝트 폴더 Git 초기화
2-1. 터미널에서 프로젝트 폴더로 이동
cd /path/to/your/project
2-2. Git 초기화 (처음 한 번만 하면 됨)
git init: 폴더를 Git 저장소로 만듦
git status: Git 상태 확인, 현재 작업 디렉토리의 변경 사항 및 스테이징 영역의 상태 확인
git init
#git status
3. Git에 파일 추가 및 커밋
3-1. 모든 파일 Git에 추가 (스테이징 영역에 추가)
git add . : 상위 폴더의 모든 하위 폴더 및 파일 추가
git add "A Project" "B Project" : 상위 폴더 안 특정 하위 폴더(A Project, B Project) 및 파일 추가
폴더에 공백이 포함된 경우에는 따옴표로 묶어서 사용
git add .
#git add "A Project" "B Project"
3-2. 커밋 생성
git commit -m : 커밋 생성 및 커밋 메시지 작성
git log : 저장소의 커밋 히스토리 확인 명령어
git commit -m "Initial commit"
# git log
4. 기본 브랜치 설정
4-1. 기본 브랜치설정 (처음 한 번만 하면 됨)
git branch -M main: main 브랜치에 업데이트
'-M' : 브랜치명 변경
git branch <브랜치명>: 브랜치 생성
git branch : 로컬 브랜치 목록 조회 (옵션 -r, -a)
git branch -M main
#git branch
4-2. 브랜치 생성 및 전환, 병합
git switch/merge 추가 설명은 아래 7-3 참고
만약, develop 브랜치에서 개발 작업을 한 후 main에 병합하지 않고,
develop 브랜치 그대로 git push를 사용해 업로드 시
"fatal: The current branch develop has no upstream branch." 라는 에러 메시지가 뜨는데
이는 develop 브랜치가 원격 저장소에는 업데이트 되지 않은 상태이기 때문에 발생하는 문제
해결 : git push --set-upstream origin develop 명령어 사용하면 됨.
#git switch -c develop
# develop 브랜치에서 개발 작업 후 -> git add -> git commit -m
#git switch main
#git merge develop
5. 원격 저장소 연결 및 푸시
5-1. 원격 저장소 연결 (처음 한 번만 하면 됨)
git remote add <원격 저장소명> <원격 저장소 URL> : 로컬 저장소에 원격 저장소(GitHub Repository) 연결
git pull origin <브랜치명> : 원격 저장소의 변경 사항을 로컬에 병합 (동기화)
원격 저장소(GitHub)의 변경 사항을 가져와 로컬(PC)에 병합
--allow-unrelated-histories : 서로 다른 커밋 히스토리 강제 병합
주로 이런 상황에서 사용
1️⃣ GitHub에서 README.md /. gitignore를 먼저 생성한 후
2️⃣ 로컬에서 git init 후 커밋하고 푸시하려고 할 때 → 히스토리가 달라서 충돌남 → 그래서 '--allow-unrelated-histories'로 강제 병합 허용
git push origin <브랜치명>: 로컬에서 만든 커밋을 원격 저장소에업로드
로컬 저장소의 main 브랜치를 GitHub에 업로드
'-u' : upstream 트래킹 정보 설정. (다음부터 원격 저장소와 브랜치 생략 가능)
git push만 입력해도 origin의 main 브랜치로 푸시됨
#git pull origin main --allow-unrelated-histories
git push -u origin main
6. GitHub 확인
GitHub Repository에 파일 업로드 확인 가능
6. 추가 : GitHub에 로컬 저장소(PC)의 프로젝트 폴더 구조 그대로 업로드
6-1. 폴더 구조 업로드 (요구 조건)
로컬 저장소(PC)의 "E:\Source Code" 폴더 안에 'A Project', 'B Project', 'C Project'의 하위 폴더가 있고, 각 폴더에는 프로젝트별 코드 파일 및 기타 파일이 존재함. 이 Source Code 폴더의 구조 그대로 원격 저장소(GitHub)에 업데이트하고 싶음.
6-2. 2번(로컬 저장소(PC)의 프로젝트 폴더 Git 초기화)까지는 동일
New Repository 생성git 초기화가 되어 있는 상태.git 폴더 생성된 모습
6-3. Git에 파일 추가 및 커밋 - git add, git commit
모든 폴더 및 파일 추가
git add .
git commit -m "Add All Folders"
상위 폴더 내 특정 하위 폴더 및 파일만을 추가
git add "A Project" "B Project"
git commit -m "Add folders a and b"
전체 폴더 추가 및 커밋
6-4. 원격 저장소(GitHub Repository) 연결 및 푸시 - git pull, git push
git branch -M main
git remote add origin https://github.com/YourUsername/YourRepositoryName.git
# GitHub에서 리포지토리를 먼저 생성하였으므로 git push 전 git pull 먼저 실행
git pull origin main --allow-unrelated-histories
# 로컬 저장소(Source Code 폴더)의 main 브랜치를 GitHub에 업로드
git push -u origin main
해당 Repository URL 복사GitHub(원격 저장소)의 내용들을 PC(로컬 저장소)로 병합 후 PC의 폴더 및 파일들을 GitHub에 업데이트
6-5. Source Code 폴더 구조 및 파일들이 그대로 GitHub Repository에 잘 업로드되었는지 확인
