Git 프로젝트, 초보자용 공식 안내서를 새로 써 첫 커밋부터 업로드까지 설명

Git 프로젝트는 기존 공식 초보자 안내서를 Julia Evans와 Marie Claire LeBlanc Flanagan이 공동 작성한 새 안내서로 교체했습니다. Evans는 2026년 11월 12일 새 문서가 프로젝트에 합쳐졌다고 알렸습니다. 미리보기는 공개됐으며, Evans는 공식 웹문서와 git help tutorial에 다음 Git 릴리스 뒤 반영될 예정이라고 밝혔습니다.

Git은 파일의 변경 이력을 저장하고 이전 상태로 돌아갈 수 있게 하는 도구입니다. 안내서는 명령줄에서 새 프로젝트를 만들고 수정한 파일을 저장한 뒤 인터넷의 Git 호스트에 올리는 순서로 설명합니다. 기존 프로젝트가 없어도 같은 예제를 따라 할 수 있도록 빈 폴더에서 시작합니다. 컴퓨터에서 처음 Git을 쓸 때 이름과 이메일 주소, 기본 브랜치 이름 main을 설정하는 과정도 안내합니다.

Windows에서는 Git 설치에 포함된 Git Bash를 사용할 수 있습니다. 안내서는 명령줄을 중심으로 설명하지만, 명령줄과 그래픽 인터페이스를 오가며 작업해도 된다고 적었습니다. 예상 시간은 Git 사용 경험이 조금 있으면 1시간 이내, 처음이면 1~2시간이며 Git 2.23.0 이후 버전에서 동작하도록 설계됐습니다.

첫 단계에서 git init을 실행하면 프로젝트 폴더 안에 숨김 폴더 .git이 생깁니다. Git은 이 폴더에 커밋을 보관합니다. 커밋은 파일의 한 시점 상태를 저장한 기록입니다. 예를 들어 소스 코드는 저장하되 컴파일한 실행 파일은 제외하고 싶다면 커밋에 넣을 파일을 골라야 합니다.

파일을 커밋에 넣으려면 git add로 대상을 고른 다음 git commit으로 기록합니다. 안내서는 git status를 이용해 파일이 새 파일인지, 수정됐는지, 다음 커밋에 들어가도록 선택됐는지 확인하게 합니다. 새 파일도 커밋하려면 먼저 git add를 실행해야 합니다. 예제에서는 README 파일을 고친 뒤 git status로 상태를 보고, git diff로 git add하기 전 바뀐 줄을 확인합니다.

수정 내용을 커밋하지 않기로 했다면 안내서의 예처럼 git add 전 상태에서 git restore로 파일을 마지막 커밋 상태로 되돌릴 수 있습니다. 이 명령은 해당 수정 내용을 버리며, 안내서는 실행 후 복구할 수 없다고 경고합니다. 이 단계까지는 계정이나 인터넷 연결 없이 컴퓨터 안에 프로젝트의 여러 버전을 저장하고 변경을 되돌릴 수 있습니다.

인터넷에 코드를 올리려면 Git 호스트 계정을 만들고 인증 방법을 준비한 뒤 호스트에 빈 저장소를 만듭니다. 새 저장소에 README나 라이선스 파일을 자동으로 추가하면 원격 저장소에 먼저 커밋이 생겨 첫 업로드가 거부될 수 있어, 안내서는 그런 파일을 처음부터 만들지 않도록 설명합니다. 사용자는 원격 저장소 주소를 origin이라는 이름으로 등록한 뒤 git push로 현재 main 브랜치를 보냅니다. 첫 업로드 때 --set-upstream을 지정하면 이후에는 git push origin main으로 보낼 수 있습니다.

인증 과정은 운영체제에 따라 다릅니다. Mac과 Linux 안내는 SSH 키를 준비해 Git 호스트에 등록하는 방법을 설명합니다. Windows에서는 Git for Windows에 포함된 Git Credential Manager가 로그인을 처리하므로 SSH 설정 단계를 건너뜁니다. SSH 설정은 빠르게 연결하는 방법을 중심으로 다루며, 조직의 보안팀이 있다면 인증 설정에 관한 조직 지침을 따를 수 있다고 안내합니다.

공개 저장소에 코드를 올리면 이름과 이메일 주소, 커밋한 파일과 이전 버전도 인터넷에 공개됩니다. 안내서 끝에는 현재 브랜치가 main이 아닌 경우, SSH로 새 호스트에 처음 연결하는 경우, 원격 저장소에 이미 커밋이 있는 경우의 문제 해결 방법을 실었습니다. Git 저장소의 커밋 설명에 따르면 최소 20명이 안내서를 끝까지 마쳤고, 테스트 과정에서 나온 문제를 문서에 반영했습니다. 브랜치와 협업은 이 안내서의 범위에서 제외했습니다.