Category
Preparing references and filters for this topic. 이 주제의 레퍼런스와 필터를 준비하고 있습니다.
파일 복사 대신 Git으로 commit·branch·diff·remote를 사용해 변경 의도와 복구 지점을 남기되, uncommitted·unpushed 변경의 보호 범위를 구분하는 방법입니다.
git status
git switch -c feature/search-filter
# 변경하고 검토한 뒤
git add -p
git commit -m "Add search filter"
git push -u origin feature/search-filterworktree·index·HEAD의 두 diff를 구분하고 `add`·`add -p`·`commit`이 각각 어느 상태를 바꾸는지 확인해 의도 단위 commit을 만드는 방법입니다.
HEAD commit --(git diff --staged)--> index --(git diff)--> worktree
git commit git add / git add -pblob·tree·commit·annotated tag object와 branch·HEAD ref의 역할, repository object format과 `cat-file`·`rev-parse`로 실제 연결을 확인하는 방법입니다.
blob: file content
<- tree: name, mode, blob/subtree 연결
<- commit: root tree, parent commit(s), metadata
<- branch / tag ref
HEAD -> current branch ref -> current commitHEAD가 branch ref를 따르는 일반 상태와 commit을 직접 가리키는 detached 상태를 구분하고, 실험 commit을 branch·tag·remote로 보존하는 방법입니다.
git status
git switch --detach <commit-or-tag>
# 의미 있는 수정이 생겼다면
git switch -c experiment/from-old-state
git push -u origin experiment/from-old-stateworktree·index·HEAD 사이의 상태와 short format의 XY 코드를 읽어 stage·commit·discard 전의 다음 행동을 고르는 방법입니다.
git status
# 보고 판단하기
- Changes not staged for commit
- Changes to be committed
- Untracked filesworktree 변경을 검토해 index에 stage하고, commit으로 로컬 ref를 이동한 뒤 push로 원격 ref를 갱신하는 기본 흐름입니다.
git add <file>
git commit -m "의도를 설명하는 메시지"
git pushclone의 초기 설정, fetch의 remote-tracking ref 갱신, pull의 fast-forward·merge·rebase 통합 선택과 shared branch 안전선을 구분하는 방법입니다.
# 처음 가져올 때
git clone <url>
# 원격 변경만 먼저 확인할 때
git fetch
git log HEAD..origin/main --oneline
# 원격 변경을 받아와 현재 브랜치에 반영할 때
git pulluntracked path에 적용되는 .gitignore 패턴, negation·directory 경계, 이미 tracked인 파일의 `rm --cached`와 비밀 정보 회수 범위를 구분하는 방법입니다.
node_modules/
dist/
*.log
.env
!.env.exampletracked·untracked·ignored 변경을 `stash push`로 임시 보관하고 apply·pop·drop의 충돌·보존 차이와 branch commit의 장기 보관 기준을 구분하는 방법입니다.
# 현재 변경을 이름과 함께 임시 저장
git stash push -m "wip: login form validation"
# 다른 브랜치로 이동해 긴급 작업 처리
git switch main
# 원래 브랜치로 돌아와 복원
git switch feature/login
git stash popuntracked·ignored 파일을 `git clean`으로 제거할 때 dry-run·interactive·directory·ignored 범위를 분리하고 복구 불가 삭제를 피하는 방법입니다.
# 삭제될 파일 미리 보기
git clean -n
# untracked 파일 삭제
git clean -f
# untracked 디렉터리까지 삭제
git clean -fd
# .gitignore에 걸린 파일까지 삭제
git clean -fdxsystem·global·local·worktree·command config의 우선순위와 worktree config 활성 조건, `user.name`·`user.email`의 실제 출처를 확인하는 방법입니다.
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --local user.email "work@example.com"
git config --list --show-origin --show-scope.gitattributes의 text·eol·-text를 이용해 index 정규화와 checkout line ending을 구분하고, 대규모 renormalize diff를 안전하게 나누는 방법입니다.
* text=auto
*.sh text eol=lf
*.bat text eol=crlf
*.ps1 text eol=crlf
*.png -text
*.jpg -text
*.pdf -texttracked path를 worktree와 index에서 함께 삭제하는 `rm`, 로컬 파일을 남기는 `rm --cached`, rename·외부 변경을 stage하는 `mv`·`add -u`를 구분하는 방법입니다.
# 파일을 작업 트리와 인덱스에서 함께 삭제
git rm old.txt
# 파일은 남기고 Git 추적만 중단
git rm --cached .env
# 디렉터리 단위 삭제
git rm -r legacy/
# 파일 이름 변경을 스테이징
git mv old-name.js new-name.js
# 외부에서 삭제하거나 이름 바꾼 변경을 스테이징
git add -ubranch ref를 만들고 worktree를 switch한 뒤 fast-forward·merge commit·conflict 중 실제 통합 결과를 검토하는 기본 흐름입니다.
git switch -c feature/login
# 작업 후
git switch main
git merge feature/loginrebase가 local commit을 새 부모 위에 다시 만드는 방식, merge와의 기록 차이, shared branch·force-with-lease·abort 경계를 구분하는 방법입니다.
git switch feature/login
git fetch origin
git rebase origin/main
# 충돌이 없으면 완료, 충돌 시
# 해결 후 git add <file>
# git rebase --continuemerge·rebase가 멈춘 충돌 상태에서 base/ours/theirs의 의도를 확인하고, resolve·stage·continue 또는 abort·test까지 끝내는 방법입니다.
# 1. 충돌 파일 확인
git status
# 2. 파일 안의 충돌 마커를 직접 편집해 최종 내용 결정
# <<<<<<< HEAD
# 현재 브랜치 내용
# =======
# 병합 대상 브랜치 내용
# >>>>>>> feature/login
# 3. 해결 완료 표시
git add <file>
# 4. 진행 계속
git merge --continue # merge 중이었다면
git rebase --continue # rebase 중이었다면실제 remote ref, local remote-tracking ref, local branch와 upstream 관계를 구분해 fetch·push·pull의 기본 대상을 확인하는 방법입니다.
git switch -c feature/login --track origin/feature/login
git branch -vv
git push -u origin feature/login공유 object database와 ref를 사용하는 linked worktree에서 branch별 HEAD·index·config 경계, same-branch lock과 remove/prune 정리 흐름을 다루는 방법입니다.
# 새 worktree 추가 (브랜치가 없으면 -b로 생성)
git worktree add ../project-hotfix hotfix/login-bug
# worktree 목록 확인
git worktree list
# 작업 완료 후 worktree 제거
git worktree remove ../project-hotfixGit client hook의 실행 시점·exit code·core.hooksPath와 version-controlled setup, `--no-verify` 우회 및 CI/server 검증의 강제 범위를 구분하는 방법입니다.
# 1. husky 설치 및 초기화
npm install --save-dev husky
npx husky init
# 2. pre-commit 훅 추가 (lint-staged 실행)
echo "npx lint-staged" > .husky/pre-commit
# 3. lint-staged 설정 (package.json)
# "lint-staged": {
# "*.{ts,tsx}": ["eslint --fix", "prettier --write"]
# }
# 4. commit-msg 훅으로 메시지 형식 강제
echo 'npx commitlint --edit "$1"' > .husky/commit-msgsuperproject가 기록한 gitlink commit을 재현하는 consumer 흐름과 submodule upstream branch를 의도적으로 통합하는 maintainer 흐름을 분리하는 방법입니다.
# 서브모듈 추가
git submodule add https://github.com/org/shared-lib libs/shared-lib
# 저장소 클론 후 서브모듈 초기화 및 체크아웃
git clone https://github.com/org/my-project
git submodule update --init --recursive
# consumer: 상위 저장소가 기록한 gitlink commit을 재현
git submodule update --init --recursive
# maintainer: submodule upstream을 의도적으로 통합한 뒤
# 상위 저장소에 gitlink 변경 반영
cd libs/shared-lib
git fetch origin
git merge --ff-only origin/main
cd ../..
git add libs/shared-lib
git commit -m "chore: update shared-lib gitlink"대상 commit에 붙는 fixup·squash marker와 interactive rebase autosquash 범위를 확인해 개인 PR branch의 history를 정리하는 방법입니다.
# 고칠 대상 커밋 확인
git log --oneline
# 대상 커밋에 붙일 fixup 커밋 생성
git add src/auth.js
git commit --fixup=a1b2c3d
# 대상 커밋 이후 범위를 대화형 rebase로 정리
git rebase -i --autosquash origin/main
# 원격 개인 브랜치 갱신
git push --force-with-leaseremote alias·fetch/push URL·refspec의 역할을 구분하고, origin/upstream 교체 뒤 fetch·history·push 대상을 검증하는 방법입니다.
git remote -v
git remote add origin <url>
git remote get-url origin
git remote set-url origin <new-url>
git remote rename origin upstream
git remote remove old-originamend가 마지막 commit을 새 object로 바꾸는 범위와 force-with-lease가 remote-tracking ref를 lease로 사용하는 조건을 구분하는 방법입니다.
로컬 마지막 커밋 수정
git add <file>
git commit --amend
스테이지 변경 없이 메시지만 수정
git commit --amend -m "New message"
이미 push한 내 작업 브랜치 갱신
git push --force-with-lease
피해야 할 기본값
git push --force원격에 없는 branch가 아닌 로컬 stale remote-tracking ref를 `fetch --prune`·`remote prune`·`--prune-tags`로 정리하는 범위를 구분하는 방법입니다.
git fetch --prune origin
git branch -r
# fetch 없이 stale remote-tracking refs만 정리
git remote prune origin
# 기본 fetch 때 자동 정리
git config --global fetch.prune truecommit DAG·range는 `log`로, worktree/index/commit tree 사이 실제 줄 변화는 `diff`·`show`로 읽어 변경 맥락을 확인하는 방법입니다.
git log --oneline --graph --decorate
git diff
git diff --stagedreset의 ref·index·worktree mode와 revert의 새 inverse commit을 구분해 local rewrite·shared history 취소·uncommitted 손실 위험을 판단하는 방법입니다.
# 로컬에서 아직 정리 중이면
git reset --soft HEAD~1
# 이미 공유된 커밋을 취소하려면
git revert <commit>원본 commit의 diff를 target branch에서 새 commit으로 재현하는 cherry-pick의 dependency·conflict·duplicate history와 backport 선택 기준을 다루는 방법입니다.
git switch release/1.0
git cherry-pick a1b2c3d
# 여러 커밋을 순서대로 적용
git cherry-pick a1b2c3d e4f5g6h
# 범위 지정 (이전 커밋 제외, 이후 커밋 포함)
git cherry-pick a1b2c3d..e4f5g6hlightweight·annotated·signed tag와 explicit push, shared release tag의 move/delete·force update policy를 구분해 재현 가능한 release 기준점을 남기는 방법입니다.
# annotated tag 생성
git tag -a v1.0.0 -m "Release 1.0.0"
# 원격에 tag 전송 (커밋 push와 별개다)
git push origin v1.0.0
# 모든 tag를 원격에 전송
git push origin --tagslocal HEAD·branch ref 이동 기록에서 reset·rebase·amend 전 commit을 찾고, branch로 보존하되 reflog expiry·GC·uncommitted 손실 한계를 구분하는 방법입니다.
# HEAD 이동 기록 보기
git reflog
# 출력 예시
# abc1234 HEAD@{0}: reset: moving to HEAD~2
# def5678 HEAD@{1}: commit: Add login validation
# ghi9012 HEAD@{2}: commit: Init auth module
# 원하는 시점으로 복구
git reset --hard HEAD@{2}
# 또는 dangling commit에서 새 브랜치 생성
git branch recover-login def5678재현 가능한 good/bad 판정으로 commit DAG의 회귀 범위를 줄이고, `bisect run` exit code·skip·flaky test의 불확실성을 다루는 방법입니다.
git bisect start
git bisect bad # 현재 상태가 문제 있음
git bisect good v1.2.0 # 확실히 정상이었던 태그 또는 커밋
# Git이 중간 커밋을 checkout해 줌
# 테스트 후 판정
git bisect good # 또는 git bisect bad
# 원인 커밋이 특정되면 출력됨
git bisect reset # 원래 브랜치로 복귀sparse checkout의 worktree 경로 선택과 partial clone의 blob 전송 지연을 분리하고, cone/non-cone·server filter·reapply·worktree별 설정을 검증하는 방법입니다.
git clone --filter=blob:none --no-checkout <url> monorepo
cd monorepo
git sparse-checkout init --cone
git sparse-checkout set apps/web packages/ui
git switch main
# 현재 선택 경로 확인 또는 전체 worktree 복원
git sparse-checkout list
git sparse-checkout disablerestore의 source·target(worktree/index) 조합을 구분해 unstage, path discard, 특정 commit 파일 복원, patch 단위 선택을 안전하게 수행하는 방법입니다.
# 작업 트리 변경만 버리기
git restore app.js
# 스테이징만 해제하고 파일 수정은 유지
git restore --staged app.js
# 특정 커밋의 파일 내용으로 되돌리기
git restore --source=HEAD~1 -- app.js
# 일부 hunk만 골라서 되돌리기
git restore --patch app.js현재 줄의 마지막 변경 commit을 찾는 `blame`과 범위·함수의 변화 과정을 보는 `log -L`, whitespace·move·copy 추적 한계를 구분하는 방법입니다.
# 파일 전체 줄별 마지막 변경 커밋 확인
git blame src/auth.js
# 특정 줄 범위만 확인
git blame -L 40,80 src/auth.js
# 공백 변경을 무시하고 확인
git blame -w src/auth.js
# 줄 범위의 변경 히스토리 추적
git log -L 40,80:src/auth.js`A..B`·`A...B`의 commit set과 `git diff`의 merge-base 해석, `~`·`^` 부모 선택을 명령별 질문과 함께 구분하는 방법입니다.
git log main..feature
git log main...feature
git diff main...feature
git show HEAD~1
git show HEAD^2GitHub Desktop에서 변경 검토, 로컬 커밋, 원격 동기화, Pull Request 생성까지의 Git 상태 변화를 정리합니다.
Sourcetree에서 변경을 stage해 커밋 단위를 만들고, 히스토리와 원격 상태를 확인하는 기준을 정리합니다.
VS Code Source Control에서 편집 중인 변경을 검토하고 stage, commit, sync, 충돌 해결로 이어 가는 기준을 정리합니다.
GitKraken Desktop에서 commit graph와 diff를 이용해 브랜치 관계를 확인하고, 위험한 Git 동작을 구분하는 기준을 정리합니다.
Fork에서 변경을 나누어 커밋하고, 그래프를 읽으며, 공유 전 히스토리를 정리하는 기준을 정리합니다.
GitHub Desktop에서 변경 검토, 커밋, 브랜치 전환, 원격 동기화에 쓰는 macOS와 Windows 단축키를 정리합니다.