[macOS] 맥북에서 깃(Git) 프로젝트 폴더 이동 및 .DS_Store 완벽 해결 가이드

목차 숨기기

맥북에서 자바 알고리즘 공부나 개발 프로젝트를 진행하다 보면, 폴더 구조를 정리하거나 데스크톱에 있던 폴더를 다른 곳으로 옮겨야 할 때가 있습니다. 이때 “깃허브(GitHub)와 연동되어 있는데 폴더를 그냥 옮겨도 될까?” 하는 걱정이 들 수 있죠.

오늘은 맥북에서 로컬 저장소를 안전하게 이동하는 방법과, 맥 사용자라면 누구나 겪는 불청객인 .DS_Store 파일을 깃허브에서 영구적으로 퇴출하는 방법을 정리해 보겠습니다.

결론부터 말씀드리면, 폴더를 그냥 드래그해서 옮겨도 깃 설정은 깨지지 않습니다. 모든 커밋 이력과 원격 저장소 정보는 폴더 내 숨겨진 .git 폴더에 들어있기 때문입니다.

IDE 종료: 인텔리제이(IntelliJ)나 VS Code 등 해당 폴더를 사용 중인 프로그램을 모두 종료합니다.
폴더 이동: Finder에서 원하는 위치로 폴더를 드래그 앤 드롭하거나 터미널의 mv 명령어를 사용합니다.
경로 확인: 터미널을 열고 새 위치로 이동한 뒤 깃 상태를 확인합니다.Bashcd /새로운/경로/폴더명 git remote -v
IDE에서 다시 열기: 편집기를 실행해 ‘Open’ 메뉴로 새 경로의 폴더를 선택합니다. (환경 설정 경로가 바뀌었다면 IDE의 안내에 따라 다시 지정해 주세요.)

맥북의 Finder는 폴더의 보기 옵션을 저장하기 위해 .DS_Store라는 숨김 파일을 자동으로 생성합니다. 이 파일이 깃허브 저장소에 올라가면 협업 시 혼란을 주고 저장소가 지저분해집니다.

1단계: 원격 저장소에서 기존 파일 제거 로컬 파일은 그대로 두고, Git의 관리 대상(Index)에서만 제외합니다.

Bash

git rm -r --cached .DS_Store

2단계: .gitignore 설정 프로젝트 루트 폴더의 .gitignore 파일에 아래 내용을 추가하여 앞으로 발생할 파일을 차단합니다.

Plaintext

# macOS metadata
.DS_Store

3단계: 시스템 전역(Global) 설정 (강력 추천) 모든 프로젝트마다 설정하기 번거롭다면, 맥북 시스템 전체에서 .DS_Store를 무시하도록 설정할 수 있습니다.

Bash

# 전역 ignore 파일 생성
echo ".DS_Store" >> ~/.gitignore_global

# Git 전역 설정에 등록
git config --global core.excludesfile ~/.gitignore_global

맥북 개발 환경은 처음에 세팅해둘 것이 몇 가지 있지만, 한 번 잡아두면 매우 쾌적한 개발이 가능합니다. 특히 .DS_Store 전역 설정은 맥북을 새로 세팅할 때 필수적인 과정이니 꼭 적용해 보시기 바랍니다.

오늘의 기록이 저와 같은 맥북 사용자분들께 도움이 되었길 바랍니다!

답글 남기기 응답 취소