Git 설정 / 전역과 로컬 설정부터 core.autocrlf / Git 단축키(alias)

현대 소프트웨어 개발에서 빼놓을 수 없는 버전 관리 시스템인 Git🥰. Git을 제대로 활용하려면 다양한 설정 옵션을 이해하고, 자신의 작업환경에 맞게 맞춤화하는 것이 중요하다. 이번 글은 Git 설정의 기본 개념부터, 전역(global) 설정과 로컬(local) 설정의 차이, 그리고 유용한 단축키(alias) 설정 방법에 대한 내용이다.

1. Git 설정의 기본 이해: 전역 설정과 로컬 설정

Git 설정은 크게 세 가지 레벨로 나뉜다.

• 시스템 설정 (system) : 컴퓨터에 설치된 모든 사용자와 저장소에 영향을 미치는 설정. /etc/gitconfig 같은 곳에 저장된다.
• 전역 설정 (global) : 현재 사용자의 모든 저장소에 적용되는 설정. 보통 ~/.gitconfig에 저장된다.
• 로컬 설정 (local) : 특정 Git 저장소에만 적용되는 설정으로, 저장소 내부 .git/config에 저장된다.

전역 설정은 “모든 프로젝트에 공통 적용”된다. 반면, 로컬 설정은 “특정 프로젝트에만” 영향을 준다. 예를 들어, 여러 저장소를 운영할 때 프로젝트마다 다른 사용자 이름을 쓰고 싶으면 로컬 설정을 활용하면 된다.

 

2. 전역 설정과 로컬 설정 차이의 실제 예시

# 전역 사용자 이름 설정
git config --global user.name "Lody"

# 특정 저장소 내에서만 사용자 이름 변경
cd ~/myproject
git config user.name "Project Specific Name"

이때 myproject 저장소에서는 로컬 설정이 우선 적용되어 Project Specific Name이 사용된다. 다른 저장소에서는 전역 설정인 Lody가 기본값이다.

 

3. 설정값 확인하기: git config --list 명령어

git config --list 명령어를 쓰면 현재 사용자 환경에서 적용 중인 모든 설정값을 한 번에 보여준다. 여기에는 시스템, 전역, 로컬 설정이 모두 포함된다. 만약 같은 설정이 여러 곳에 있으면, 가장 우선순위가 높은 설정(로컬 > 전역 > 시스템)이 출력된다.

• 시스템 설정만 보고 싶으면:
• git config --system --list
• 전역 설정만 보고 싶으면:
• git config --global --list
• 로컬 설정만 보고 싶으면 (저장소 안에서 실행):
• git config --local --list

 

4. 편집기 설정과 에디터 변경

Git에서 커밋 메시지 작성 같은 작업을 할 때 편집기가 자동으로 열린다. 이때 기본 편집기는 보통 vi라는 터미널 기반 편집기로 설정되어 있다. vi는 초보자에게는 다소 사용법이 어려울 수 있다. 따라서 자신이 익숙한 편집기로 바꾸는 것이 좋다.

예를 들어 VS Code로 바꾸려면 아래처럼 설정한다.

git config --global core.editor "code --wait"

• code는 VS Code 실행 명령어다.
• --wait 옵션은 편집기가 닫힐 때까지 Git이 기다리도록 한다.

만약 VS Code에서 code 명령어가 동작하지 않는다면, VS Code 내에서 command + shift + p를 눌러 Shell Command: Install 'code' command in PATH를 실행해 PATH에 등록해야 한다.

 

5. 줄바꿈 문제와 core.autocrlf 설정

운영체제마다 줄바꿈 문자가 다르기 때문에, Windows와 macOS/Linux 간 협업 시 줄바꿈 때문에 문제가 발생하는 경우가 많다. Windows는 줄바꿈을 CRLF (Carriage Return + Line Feed)로, macOS/Linux는 LF (Line Feed)로 처리한다.

Git은 이를 자동으로 처리할 수 있도록 core.autocrlf 설정을 제공한다.

• Windows 사용자라면 다음처럼 설정한다.

git config --global core.autocrlf true

이렇게 하면 Windows에서는 체크아웃 시 줄바꿈을 CRLF로 변환하고, 커밋할 때는 다시 LF로 변환해 저장소 내에서는 통일성을 유지한다.

• macOS, Linux 사용자라면 아래 설정을 권장한다.

git config --global core.autocrlf input

이 경우 체크아웃 시 줄바꿈 변환을 하지 않고, 커밋할 때만 줄바꿈을 LF로 변환한다. macOS/Linux 기본 줄바꿈 형식을 유지하면서도, 저장소 내 줄바꿈은 일관되게 관리할 수 있다.

 

6. 기본 브랜치명과 pull 기본 전략 설정

기본 브랜치명도 최근 main으로 많이 바뀌었다. 프로젝트 생성 시 기본 브랜치 이름을 설정하려면 아래처럼 한다.

git config --global init.defaultBranch main

또한 git pull 명령어의 병합 전략도 설정할 수 있다.

• 병합(Merge) 방식:

git config --global pull.rebase false

• 리베이스(Rebase) 방식:

git config --global pull.rebase true

리베이스 방식은 깔끔한 커밋 히스토리를 유지하는 데 도움이 된다.

 

7. 유용한 Git 단축키(alias) 만들기

Git 명령어를 짧게 줄여 쓸 수 있는 단축키(alias)를 만들면 작업 효율이 크게 올라간다.

git config --global alias.cam "commit -am"

이렇게 하면 git cam '메시지' 명령으로 바로 커밋할 수 있다.

만약 단축키를 삭제하고 싶다면, 전역 설정 파일을 열어서(alias 항목을) 지우거나, 아래 명령어로 삭제한다.

git config --global --unset alias.cam

 

 

8. Git 도움말과 문서 활용법

Git에는 git help라는 강력한 도움말 기능이 있다. 모르는 명령어가 있으면 git help 명령어를 쳐서 기본 설명과 옵션을 확인할 수 있다.

화면이 less라는 터미널 뷰어처럼 동작해서, j로 내리고, k로 올리고, :q로 종료할 수 있다.

웹에서 설명을 보고 싶으면, 명령어 끝에 -w 옵션을 붙여서 웹브라우저로 열 수도 있다.

git help commit -w

---

Git 설정은 단순하지만, 세밀하게 다룰수록 개발 생산성이 올라간다. 특히 전역과 로컬 설정 차이를 명확히 이해하고, 작업에 맞게 에디터와 줄바꿈 설정을 조절하며, 자주 쓰는 명령어를 단축키로 만들어 두면 훨씬 편하다는 것!🧚🏻

 

깃 단축키 설정 문서