.gitignore가 정상적으로 작동하지 않을 때 해결 방법

반응형

Git 프로젝트를 관리할 때 특정 파일이나 폴더를 버전 관리에서 제외하기 위해 .gitignore 파일을 사용하는 경우가 많습니다. 하지만 간혹 .gitignore가 제대로 작동하지 않아서, 무시하려는 파일이 여전히 Git에 포함되는 경우가 있습니다. 이번 포스팅에서는 .gitignore가 정상적으로 작동하지 않을 때 그 원인과 해결 방법을 알아보겠습니다.

반응형

.gitignore가 작동하지 않는 이유

.gitignore가 정상적으로 작동하지 않는 이유는 여러 가지가 있을 수 있습니다. 가장 흔한 원인은 이미 Git에 추적되고 있는 파일이 .gitignore에 추가되었기 때문입니다. Git은 한 번 추적하기 시작한 파일을 그대로 유지하려는 특성이 있습니다. 그 외에도 .gitignore 파일의 경로가 잘못되었거나, 형식이 올바르지 않은 경우도 문제를 일으킬 수 있습니다.

반응형

1. 이미 추적 중인 파일을 .gitignore에서 무시하도록 설정

이미 Git이 추적하고 있는 파일을 .gitignore에 추가해도, Git은 해당 파일을 계속 추적합니다. 이런 경우에는 Git이 해당 파일을 추적하지 않도록 수동으로 제거해줘야 합니다. 이를 위해서는 다음 명령어를 사용하세요:

git rm --cached 파일명

이 명령어는 Git의 추적 기록에서만 해당 파일을 제거하고, 실제 파일은 그대로 유지합니다. 이후 .gitignore에 해당 파일을 추가한 후 commit을 하면, 더 이상 Git이 해당 파일을 추적하지 않습니다.

예를 들어, config.json 파일을 Git에서 무시하고 싶다면 다음과 같이 입력할 수 있습니다:

git rm --cached config.json
echo "config.json" >> .gitignore
git add .gitignore
git commit -m "Add config.json to .gitignore"

반응형

2. .gitignore 파일 경로 및 형식 확인

때로는 .gitignore 파일이 올바른 위치에 있지 않거나, 잘못된 형식으로 작성되어 문제가 발생할 수 있습니다. .gitignore 파일은 프로젝트 루트 디렉토리에 위치해야 하며, 파일 경로는 상대적으로 작성되어야 합니다. 예를 들어, 다음과 같이 파일 경로를 정확하게 작성하세요:

# 특정 디렉토리 전체를 무시
logs/

# 특정 파일을 무시
config.json

또한, .gitignore 파일에서 각 항목은 개별적인 줄로 작성되어야 합니다. 만약 특수한 패턴을 무시하고자 한다면 와일드카드(*)를 사용할 수도 있습니다:

# 모든 .log 파일을 무시
*.log

반응형

3. 캐시된 Git 파일 무시하기

때로는 특정 파일이 캐시되어 Git이 여전히 해당 파일을 추적하는 경우가 있습니다. 이를 해결하려면 Git의 캐시를 초기화할 수 있습니다. 아래 명령어를 사용해 전체 Git 캐시를 지운 후 다시 .gitignore 규칙을 적용할 수 있습니다:

git rm -r --cached .
git add .
git commit -m "Clear Git cache and reapply .gitignore rules"

위 명령어는 Git이 추적 중인 모든 파일의 캐시를 지우고, .gitignore 규칙을 다시 적용합니다. 이후 더 이상 .gitignore에 추가된 파일은 Git에서 추적하지 않게 됩니다.

반응형

4. .gitignore 규칙을 덮는 특정 설정 확인

때로는 .gitignore 파일이 있음에도 불구하고, Git이 특정 파일을 계속 추적하는 경우가 있습니다. 이는 프로젝트에 .git/info/exclude 파일이나, 시스템 전역에 설정된 ~/.gitignore_global 파일이 존재하기 때문일 수 있습니다. 이러한 파일은 .gitignore보다 우선하여 적용될 수 있으니, 이 파일들이 제대로 설정되었는지 확인해보세요.

전역 설정을 수정하고 싶다면, 다음 명령어를 사용하여 전역 .gitignore 파일을 확인할 수 있습니다:

git config --global core.excludesfile ~/.gitignore_global

반응형

마무리

.gitignore가 제대로 작동하지 않을 때는 이미 추적 중인 파일이 있는지, 파일 경로나 규칙이 올바르게 설정되어 있는지 확인해야 합니다. 위에서 소개한 방법들을 순차적으로 적용하면 대부분의 문제를 해결할 수 있을 것입니다.

해당 포스팅을 통해 .gitignore가 정상적으로 작동하지 않을 때 문제를 해결하는 데 도움이 되셨으면 합니다.