[3편] 깃(Git) 첫 연동 시 꼭 알아야 할 글로벌 설정과 기본 명령어 흐름

파이썬 설치도 끝내고 VS Code 터미널 보안 설정까지 마쳤다면, 이제 본격적으로 개발자 필수 도구인 형상 관리 시스템을 마주할 차례다. 혼자서 코딩을 하든 여러 사람과 협업을 하든 코드를 안전하게 관리하고 기록하기 위해서는 깃(Git)이 반드시 필요하다. 하지만 처음 컴퓨터에 깃을 설치하고 터미널에서 첫 커밋(Commit)을 날리려고 할 때, 엉뚱한 에러를 마주하거나 내 이름이 아닌 정체불명의 계정으로 기록이 남아서 당황하는 초보자들이 적지 않다.

이 문제를 미연에 방지하고 원활한 코드 관리를 시작하기 위해 반드시 거쳐야 하는 초기 세팅과 명령어 흐름을 정리해 보았다.

[소제목] 깃을 설치한 직후 가장 먼저 해야 할 글로벌(Global) 설정

새로운 컴퓨터나 노트북에 깃을 설치했다면, 운영체제나 깃 프로그램 자체는 내가 누구인지 알지 못한다. 내 컴퓨터에서 작성한 코드가 나중에 깃허브(GitHub) 등의 원격 저장소에 기록될 때, 어떤 사람의 계정으로 남을지 정해주는 식별 작업이 필요하다.

직접 겪어본 바에 따르면, 깃을 설치한 직후 터미널에 사용자 이름과 이메일을 등록하는 글로벌 설정부터 하지 않으면 나중에 커밋을 할 때 경고 문구가 뜨거나 아예 커밋이 거부되는 상황이 발생한다.

터미널을 켜고 다음 명령어를 입력해 보자. 여기서 이메일과 이름은 본인이 깃허브에 가입할 때 사용한 주소와 닉네임을 적어넣는 것이 가장 안전하다.

git config --global user.name "본인영문이름" git config --global user.email "본인깃허브이메일"

이 설정을 한 번만 해두면, 앞으로 내 컴퓨터에서 생성하는 모든 깃 프로젝트는 이 정보를 기준으로 작성자 기록을 남기게 된다. 설정이 잘 되었는지 확인하고 싶다면 git config --list 명령어를 입력해 목록에서 방금 입력한 이름과 이메일이 정확히 들어가 있는지 눈으로 직접 확인해 보면 된다.

[소제목] 깃의 3가지 핵심 영역과 기본 명령어 흐름

깃을 처음 접할 때 가장 헷갈리는 부분은 내 컴퓨터의 파일들이 어떤 단계를 거쳐서 저장되는지 그 흐름을 이해하는 것이다. 깃은 파일의 상태를 크게 세 가지 영역으로 나누어 관리한다.

1. 작업 디렉토리(Working Directory): 현재 내가 열심히 코드를 작성하고 수정하는 일반적인 폴더 상태다.

2. 스테이징 영역(Staging Area): 다음 버전으로 기록할 파일들만 골라서 잠깐 올려두는 대기실 같은 공간이다.

3. 저장소(Repository): 대기실에 있던 파일들을 확정 지어서 영구적으로 역사에 기록하는 최종 저장 공간이다.

이 구조를 머릿속에 담아두고 실제 프로젝트 폴더에서 주로 쓰는 명령어 순서를 익히면 혼란을 크게 줄일 수 있다.

• git init: 현재 내 프로젝트 폴더를 깃이 관리하도록 초기화하는 명령어로, 딱 한 번만 쓴다.

• git status: 현재 어떤 파일이 수정되었고 어떤 파일이 대기실에 올라가 있는지 상태를 보여준다. 가장 자주 쓰는 명령어다.

• git add [파일명 또는 .]: 수정된 파일 중에서 저장소에 담을 준비가 된 파일을 스테이징 영역으로 보낸다. 점(.)을 쓰면 폴더 안의 모든 변경사항을 한 번에 올린다.

• git commit -m "메시지": 대기실에 모아둔 파일들에 대해 "이번 수정은 이런 이유로 했다"는 메모를 남기며 하나의 버전으로 확정한다.

[소제목] 초보자가 자주 하는 실수와 주의사항

깃을 처음 쓸 때 초보자들이 가장 많이 하는 실수는 수십 개의 파일을 무작정 git add .로 묶어서 커밋할 때 커밋 메시지를 대충 적는 것이다. "수정함", "테스트" 같은 성의 없는 메시지를 반복하면 나중에 프로젝트가 커졌을 때 과거의 내가 왜 이런 코드를 고쳤는지 전혀 알아볼 수 없게 된다. 커밋 메시지는 가급적 "로그인 페이지 버튼 디자인 수정"처럼 구체적으로 작성하는 습관을 들여야 한다.

또한, 엉뚱한 폴더 위치에서 git init을 실행하여 C드라이브 전체나 윈도우 시스템 폴더가 깃의 관리 하에 들어가 버리는 대참사도 가끔 일어난다. 반드시 터미널 경로가 내가 작업하려는 해당 프로젝트 폴더를 정확히 가리키고 있는지 확인하고 명령어를 입력해야 한다.

핵심 요약:

• 깃을 처음 설치한 후에는 반드시 git config --global 명령어로 사용자 이름과 이메일을 등록해야 기록 오류를 막을 수 있다.

• 깃은 작업 디렉토리, 스테이징 영역, 저장소의 3단계 흐름으로 코드를 관리한다는 점을 기억해야 한다.

• git status로 현재 상태를 수시로 확인하고, git add와 git commit을 통해 명확한 메시지와 함께 버전을 기록하는 습관을 들여야 한다.

다음 편 예고: 다음 편에서는 깃허브(GitHub)에 코드를 푸시(Push)할 때 초보자들이 가장 자주 마주하는 인증 에러와 토큰 인증법을 다룬다.