HOWTO · Git
Git에서 파일과 폴더를 재귀적으로 추가하기
이 튜토리얼은 git add 명령을 통해 Git에 파일과 폴더를 재귀적으로 추가하는 방법을 보여줍니다.
이 페이지의 내용
Git은 파일 변경사항을 인덱스에 스테이징합니다. 인덱스는 다음 커밋을 준비하기 위해 Git이 사용하는 영역입니다. 중첩 디렉터리 안의 파일까지 포함하려면 git add에 저장소 전체 또는 특정 디렉터리 경로를 지정하세요. 이 명령은 변경사항을 스테이징할 뿐, 커밋을 만들거나 원격 저장소로 보내지는 않습니다.
git add로 파일을 재귀적으로 스테이징하기
git add에 디렉터리 경로를 지정하면 Git은 해당 경로 아래의 하위 디렉터리에 있는 파일을 포함해 스테이징 대상 변경사항을 처리합니다. 작업 트리 전체의 변경사항은 git add -A로 스테이징할 수 있고, 현재 디렉터리부터 아래쪽의 변경사항은 git add .로 스테이징할 수 있습니다. 이 명령들에는 별도의 재귀 옵션이 필요하지 않습니다.
경로 범위가 중요합니다. 하위 디렉터리에서 실행한 명령은 해당 명령이 정하는 경로 범위에만 적용됩니다. 저장소 전체를 스테이징하려면 저장소 루트에서 실행하고, 일부만 선택하려면 디렉터리 경로를 지정하세요. 무시 규칙을 의도적으로 재정의하지 않는 한 추적되지 않는 파일에는 무시 규칙이 계속 적용됩니다.
저장소 루트에서 모든 변경사항 스테이징하기
저장소 전체의 변경사항을 스테이징하려면 먼저 저장소 루트 디렉터리로 이동한 다음 git add -A를 실행하세요. 이 명령은 작업 트리 전체의 추가, 수정, 삭제를 스테이징합니다. 프로젝트의 여러 위치에서 파일을 변경했고 저장소 전체를 한 번에 선택하려는 경우 유용합니다.
Git이 설치된 셸에서 다음 자체 완결형 예제를 실행하세요. 예제는 임시 저장소를 만들고 중첩된 파일 두 개를 추가한 뒤, 루트에서 변경사항을 스테이징하고 간단한 상태를 출력합니다. 스크립트가 끝나면 임시 디렉터리가 삭제됩니다.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
work_dir="$(mktemp -d)"
trap 'rm -rf "$work_dir"' EXIT
cd "$work_dir"
git init -q
mkdir -p src/lib
printf 'app\n' > README.md
printf 'module\n' > src/lib/module.txt
git add -A
git status --short
현재 디렉터리부터 아래쪽의 변경사항만 스테이징하려면 git add .를 사용하세요. 저장소 루트에서 실행하면 일반적으로 git add -A와 같은 작업 트리 경로가 대상이 됩니다. 하위 디렉터리에서 실행하면 git add .는 해당 디렉터리와 그 하위 항목만 대상으로 하지만, git add -A는 저장소 전체의 변경사항을 스테이징합니다. 저장소 전체를 일관되게 선택하려면 루트에서 git add -A를 실행하세요.
특정 디렉터리 스테이징하기
프로젝트의 한 영역만 스테이징하려면 저장소 루트에서 git add path/to/directory/를 실행하고, 예시 경로를 원하는 디렉터리 경로로 바꾸세요. Git은 해당 경로 아래에 있는 스테이징 대상 추가 파일과 수정 파일을 포함합니다. 디렉터리 경로를 지정하면 그 디렉터리에서 삭제된 추적 파일도 스테이징되어 인덱스에 삭제 내용이 반영됩니다.
작업 트리의 다른 위치에 관련 없는 변경사항이 있을 때는 범위를 좁혀 스테이징하는 것이 유용합니다. 스테이징하기 전에 경로가 의도한 디렉터리를 가리키는지 확인하세요. git add는 선택한 변경사항을 별도의 디렉터리 복사본이 아니라 인덱스에 기록합니다. 파일 하나만 스테이징하려면 디렉터리 대신 파일 경로를 지정하세요.
무시된 파일 처리하기
.gitignore 파일은 일반적인 스테이징에서 제외할 추적되지 않은 경로를 Git에 알려줍니다. 예를 들어 *.log와 같은 패턴을 지정하면 생성된 로그 파일을 git add -A, git add . 또는 디렉터리 경로를 이용한 스테이징에서 제외할 수 있습니다. 무시 규칙은 빌드 결과물, 로컬 설정 등 커밋에 포함하지 않아야 할 파일을 제외하는 데 유용합니다.
무시된 파일 중 특정 파일을 추적해야 한다면 먼저 해당 파일이 무시되는 이유를 확인한 다음 git add -f path/to/file로 그 경로를 지정해 스테이징하세요. 강제 옵션은 지정한 경로에 적용되는 무시 규칙을 재정의합니다. 해당 파일이 저장소에 있어야 하는 경우에만 사용하세요. 생성 파일이나 비공개 파일을 강제로 인덱스에 넣으면 원치 않는 내용이 노출될 수 있습니다. .gitignore에 패턴을 추가해도 Git이 이미 추적 중인 파일은 추적 대상에서 제거되지 않습니다.
커밋 전에 스테이징된 변경사항 검토하기
스테이징한 뒤 git status를 실행하면 어떤 경로가 스테이징되었는지, 스테이징되지 않은 변경사항이 남아 있는지 확인할 수 있습니다. 간단히 보려면 git status --short를 사용하세요. 첫 번째 상태 열은 스테이징된 경로를, 두 번째 열은 스테이징되지 않은 변경사항을 나타냅니다. 특히 저장소 전체를 스테이징한 뒤에는 커밋하기 전에 목록을 검토해 무시된 파일이나 관련 없는 파일이 포함되지 않았는지 확인하세요.
스테이징은 커밋을 준비하는 단계입니다. 커밋은 스테이징된 스냅샷을 로컬 저장소의 기록에 남기며, 푸시는 커밋을 원격 저장소로 보내는 별도의 작업입니다. 재귀적으로 스테이징해도 커밋하거나 푸시할 필요는 없습니다. 커밋하기 전에 의도한 경로를 다시 스테이징해 인덱스를 수정할 수 있습니다.