Appearance
부록 2. Git 명령과 옵션 일람
관련 차시: 2차시 로컬 저장소 · 3차시 커밋 · 4차시 이력 수정 · 5차시 원격 연동
수업에서 쓰는 Git 명령을 필수, 참고, 실행하지 않는 명령으로 나눕니다. 처음에는 필수만 사용하고, 참고는 해당 차시를 마친 뒤 강사 설명과 함께 실행합니다. 같은 명령이라도 옵션에 따라 되돌릴 수 있는 범위가 달라지므로, 모르는 옵션은 먼저 git status와 git diff로 현재 상태를 확인합니다.
왜 필요한가
git commit은 -m이 있으면 한 줄 메시지로 끝나지만, 없으면 vi 편집기가 열립니다. git push는 처음 한 번 -u를 붙여야 다음부터 브랜치 이름을 줄일 수 있습니다. git add .는 편리하지만 의도하지 않은 파일까지 담을 수 있습니다. 이런 차이를 알고 있어야 초보자가 명령을 외우는 대신 상황에 맞게 고를 수 있습니다. 반대로 reset --hard, push --force처럼 작업을 잃을 수 있는 옵션은 수업에서 사용하지 않습니다.
핵심 개념
- 작업 공간의 변경은
git status와git diff로, stage된 변경은git diff --cached로 확인합니다. -m은 커밋 메시지를 인라인으로 넣고,-u는 첫 push에서 업스트림을 연결합니다.-a는 이미 추적 중인 파일의 변경만 담습니다. 새 파일은git add가 필요합니다.--oneline,--graph,--all은 이력을 읽기 쉽게 만듭니다.--amend는 공유 전 최근 커밋을 고치고,--abort는 진행 중인 병합을 취소합니다.--hard,--force,-D,-fd는 되돌리기 어려운 작업을 만듭니다.
필수 명령
| 명령 | 의미와 사용 상황 |
|---|---|
git status | 현재 변경과 stage 상태 확인 |
git diff | 작업 파일 변경 확인 |
git add 파일명 | 다음 커밋에 넣을 파일 선택 |
git commit -m "메시지" | 선택한 변경을 기록 |
git commit -am "메시지" | 이미 추적 중인 파일의 변경만 자동 stage 후 커밋. 새 파일은 담지 않음 |
git log --oneline | 짧은 커밋 이력 확인 |
git log --graph --oneline --all | 브랜치 흐름 확인 |
git push | 로컬 커밋을 원격에 보냄 |
git pull origin main | 원격 변경을 로컬에 통합 |
git switch -c 이름 | 새 브랜치 생성과 이동 |
git restore --staged 파일명 | stage 해제, 작업 파일 보존 |
git init | 빈 폴더를 Git 저장소로 초기화 |
git config --global user.name "이름" | 커밋 작성자 이름 등록 |
git config --global user.email "이메일" | 커밋 작성자 이메일 등록 |
git remote add origin 주소 | 원격 저장소 주소 등록 |
git remote -v | 등록된 원격 주소 확인 |
git push -u origin main | 첫 업로드와 업스트림 설정 |
참고 명령
| 명령 | 의미와 사용 상황 |
|---|---|
git diff --cached | stage된 변경 확인 |
git log -n 3 | 최근 3개 커밋 확인 |
git log --stat | 파일별 변경 통계 확인 |
git merge --no-ff | merge 커밋을 남기는 병합 |
git tag -a v1.0.0 -m "메시지" | 작성자와 설명이 포함된 주석 태그 생성 |
git tag v0.1.0 | 가벼운 태그 생성 |
git branch -d 이름 | 병합 완료된 브랜치 삭제 |
git config --local user.name "이름" | 이 저장소에만 작성자 이름 등록 |
git clone 주소 | 원격 저장소를 별도 폴더에 복제 |
git revert HEAD | 공유 후 커밋을 안전하게 되돌림 |
git merge --abort | 진행 중인 병합 취소 |
git checkout 브랜치명 | 브랜치 전환(과거 명령) |
git add . | 현재 폴더의 모든 변경을 stage |
git status --short | 변경 상태를 짧게 표시 |
git log --decorate | 브랜치와 태그 이름을 함께 표시 |
git diff --staged | stage된 변경 확인(--cached와 같음) |
실행하지 않는 명령
| 명령 | 위험 | 대신 쓰는 방법 |
|---|---|---|
git reset --hard | 추적 파일 변경 유실 가능 | git revert로 커밋을 되돌리고, 작업 파일은 커밋 전 백업에서 복구 |
git push --force | 원격 이력 덮어쓰기 위험 | git pull 후 일반 git push |
git clean -fd | 추적되지 않은 파일 삭제 | git status로 확인하고 필요한 파일만 직접 정리 |
git branch -D 이름 | 병합 여부와 관계없이 브랜치 강제 삭제 | 병합 후 git branch -d 이름 |
차시별로 다시 보기
- 1–2차시:
git --version,git config,git init,git status,git add→ 1차시 · 2차시 - 3차시:
git commit,git log,git reset <파일명>→ 3차시 - 4차시:
git commit --amend,git revert,.gitignore→ 4차시 - 5차시:
git remote,git push,git pull,git clone→ 5차시 - 6차시: Pages 배포와 갱신 → 6차시
- 10차시:
git branch,git switch,git tag→ 10차시 - 11차시:
git merge, 충돌 해결,git log --graph→ 11차시 - 12차시: 브랜치 push와 Pull Request → 12차시
주의
USER,REPO,ISSUE_NUMBER같은 자리표시자는 실제 값으로 바꿉니다.- 공백이 있는 경로는 따옴표로 감쌉니다.
- 토큰을 URL, 명령, 파일, AI 대화에 넣지 않습니다.
- 오류가 난 뒤에는 다음 명령을 연속 실행하지 말고
git status로 상태를 확인합니다.