Git을 처음 설치하거나 새 서버에서는 커밋(Commit)을 하려고 하면 사용자 정보가 없다는 안내 에러가 발생하곤 합니다. Git은 누가 수정했는지 기록하는 도구라서 이름과 이메일을 등록해 주어야 합니다.
오늘은 터미널에서 Git 사용자 정보를 글로벌(Global) 및 로컬(Local)로 설정하고 확인하는 방법을 정리해 보겠습니다.
1. 전역(Global) 설정: 모든 프로젝트에 일괄 적용
리눅스 계정에서 앞으로 생성하거나 클론할 모든 Git 리포지토리에 동일한 사용자 정보를 적용하는 방법입니다.
큰따옴표 안에 본인의 이름(닉네임)과 이메일을 적어주세요. 깃허브(GitHub)를 사용하신다면 깃허브 계정 정보와 일치시키는 것이 좋습니다.
$ git config --global user.name "Your Name"
$ git config --global user.email "your_email@example.com"
2. 지역(Local) 설정: 특정 프로젝트에만 다르게 적용
공용 서버를 사용하거나, 리눅스 환경에서 개인 프로젝트와 회사 업무용 프로젝트를 분리해서 관리해야 할 때가 있습니다.
전역 설정을 무시하고, 내가 지금 위치한 특정 프로젝트 폴더 내에서만 다른 이름과 이메일을 쓰도록 설정할 수 있습니다. 프로젝트 디렉토리로 이동한 뒤 --global 옵션을 빼고 명령어를 실행합니다.
$ cd /path/to/your-project
$ git config user.name "Work Name"
$ git config user.email "work_email@company.com"
3. 설정된 내용 확인하기
등록된 이름과 이메일을 확인하는 명령어입니다.
전체 설정 리스트 확인
적용된 모든 Git 설정 값을 확인하고 싶을 때 사용합니다.
$ git config --list
특정 항목만 딱 짚어서 확인
이름이나 이메일을 개별적으로 확인할 수도 있습니다.
$ git config user.name
$ git config user.email
4. 잘못 입력했을 때 수정 및 삭제 방법
수정하고 싶다면 동일한 명령어를 올바른 값으로 다시 입력하면 덮어쓰기가 됩니다.
설정된 값 자체를 완전히 지워버리고 초기화하고 싶다면 --unset 옵션을 사용합니다.
# 글로벌 설정 삭제 시
$ git config --global --unset user.name
$ git config --global --unset user.email
# 로컬(특정 프로젝트) 설정 삭제 시
$ git config --unset user.name
$ git config --unset user.email
Git 사용자 설정은 리눅스 개발 환경 구축의 가장 기본적이면서도 중요한 첫 단계입니다. 특히 공용 서버나 여러 프로젝트를 오가는 환경이라면 글로벌(--global) 설정과 로컬 설정을 적절히 분리하여 커밋 로그가 꼬이지 않도록 주의하는 것이 좋습니다.
'Setting Log > Git' 카테고리의 다른 글
| [Git] Git 원격 저장소 핵심 명령어 및 Merge Conflict 해결 가이드 (0) | 2026.06.11 |
|---|