깃허브는 코드 관리와 협업을 위한 필수 기술로 개발자들 사이에서 널리 활용됩니다.
깃허브는 깃을 기반으로 한 웹 플랫폼으로 코드 저장, 버전 관리, 팀 협업을 지원합니다.
초보자는 깃허브 사용법을 익혀 프로젝트를 체계적으로 관리하고 공유할 수 있습니다. 전 세계 수백만 개발자가 사용하는 깃허브는 오픈소스 프로젝트와 개인 작업 모두에 적합합니다.
이 글에서는 계정 생성부터 코드 업로드, 브랜치 활용까지 초보자가 쉽게 따라 할 수 있는 단계를 소개하고자 합니다.
Contents
깃과 깃허브의 차이
(사진 출처: Github Brand Toolkit)
깃은 소스코드의 변경 이력을 추적하는 분산 버전 관리 시스템입니다. 로컬에서 파일 버전을 관리하며 수정 이력을 기록하는 기능이 있습니다.
반면 깃허브는 깃으로 관리된 코드를 온라인에 저장하고 팀원이나 커뮤니티와 공유하는 플랫폼입니다.
깃허브 사용법을 익히면 코드 백업, 협업, 오픈소스 기여가 가능해집니다. 깃은 로컬 작업의 핵심 도구이고 깃허브는 이를 클라우드로 확장합니다.
깃허브 시작하기
(사진 출처: Sign in to GitHub)
Github 사용법의 첫걸음은 계정 생성입니다. 깃허브 공식 웹사이트에 접속해 오른쪽 상단의 Sign up 버튼을 클릭하면 계정을 생성할 수 있습니다. 이메일, 비밀번호, 사용자 이름을 입력하고 인증 코드를 통해 계정을 활성화해야 합니다. 무료 계정으로 레포지토리 생성, 코드 공유 등 기본 기능을 사용할 수 있으며 유료 플랜은 프라이빗 저장소 확장과 고급 기능이 제공됩니다.
레포지토리 생성
레포지토리는 코드를 저장하는 프로젝트 단위 공간으로 구글 드라이브의 폴더와 유사한 개념입니다. 깃허브 대시보드에서 New 버튼을 클릭해 레포지토리 이름을 입력하면 됩니다. Public은 누구나 볼 수 있고 Private는 초대된 사용자만 접근이 가능합니다. 초보자는 Public으로 시작해 코드를 공개적으로 공유할 수 있습니다. README 파일 추가는 프로젝트 설명을 위해 선택적으로 포함됩니다.
깃 설치 및 설정
(사진 출처: Download GitHub Desktop)
깃허브를 실습하기 위해서는 로컬에 깃 설치가 필요합니다. 공식 웹사이트에서 윈도우, 맥, 리눅스에 맞는 깃을 다운로드하여 설치합니다.
설치 후 터미널에서 git –version 명령어를 실행해 버전이 출력되면 정상 설치된 것입니다.
깃은 다양한 운영체제를 지원하며 초보자도 쉽게 설치할 수 있습니다. 설치 과정에서 기본 설정을 유지해도 충분합니다.
계정 정보 등록
로컬 깃에 깃허브 계정 정보를 등록하기 위해서는 터미널에서 git config –global user.name “사용자 이름”과 git config –global user.email “이메일”을 입력합니다.
이는 커밋 작성자를 식별하는 데 사용됩니다. git config -l 명령어로 설정 정보를 확인할 수 있습니다.
정확한 정보 입력은 협업 시 혼선을 줄이는 데 중요합니다.
로컬 저장소 관리
(사진 출처: Git Guides)
프로젝트 폴더에서 git init 명령어를 실행해 깃 저장소를 초기화합니다.
이 명령은 .git 디렉토리를 생성하며 버전 관리가 시작됩니다.
예를 들어 mkdir myproject && cd myproject 후 git init을 입력하면 로컬 저장소가 설정됩니다.
ls -a 명령어로 .git 디렉토리가 생성된 것을 확인할 수 있습니다.
파일 추가와 커밋
파일을 생성한 뒤 git add 파일명으로 스테이징 영역에 추가합니다.
예를 들어 echo “# My Project” >> README.md로 파일을 만든 후 git add README.md를 실행하는 식입니다.
git commit -m “Initial commit”으로 변경 사항을 저장하며 커밋 메시지는 변경 내용을 간략히 설명하는 것이 좋습니다.
git status에서는 변경 상태를 확인하고 git log로 커밋 이력을 볼 수 있습니다.
원격 저장소 연결과 업로드
깃허브에서 New Repository 버튼을 클릭해 원격 저장소를 만듭니다.
이름을 지정하고 Public 또는 Private를 선택합니다. 생성된 저장소의 HTTPS URL을 복사해 로컬 저장소와 연결하면 됩니다.
git remote add origin 저장소_URL 명령어로 연결하고 git remote -v로 확인할 수 있습니다.
이 과정은 로컬과 깃허브를 연결하는 핵심 단계입니다.
코드 업로드와 토큰
변경 사항을 원격 저장소로 업로드하려면 git push origin main을 사용합니다. 최초 푸시 시 깃허브 개인 액세스 토큰이 요구됩니다.
깃허브 설정에서 Developer Settings > Personal Access Tokens로 이동해 토큰을 생성할 수 있습니다.
repo 권한을 선택하고 생성된 토큰을 안전하게 저장한 뒤 푸시할 때 입력하시기 바랍니다. 업로드 후 깃허브에서 파일을 확인할 수 있습니다.
브랜치 활용
(사진 출처: Git Branching Diagram Template)
브랜치는 프로젝트의 독립적인 작업 공간으로 새로운 기능 개발, 버그 수정, 실험적 작업에 사용됩니다.
메인 브랜치(main)에 영향을 주지 않고 안전하게 작업 가능합니다. git branch 브랜치명으로 새 브랜치를 만들고 git checkout 브랜치명으로 전환합니다.
예를 들어 git branch feature-login은 로그인 기능 개발을 위한 브랜치입니다.
브랜치 활용 사례
새 기능 추가 시 feature 브랜치를 만들어 작업하는 것이 일반적입니다.
예를 들어 웹사이트에 검색 기능을 추가하려면 git branch search-feature를 생성하고 수정 후 git push origin search-feature로 업로드하면 됩니다.
작업 완료 후 깃허브에서 풀 리퀘스트를 통해 메인 브랜치에 병합할 수 있습니다. 버그 수정이나 새로운 디자인 시도에도 브랜치를 활용하면 효율적입니다.
협업과 오픈소스 기여
Github에서 협업은 풀 리퀘스트와 이슈를 통해 이루어집니다. 풀 리퀘스트는 브랜치의 변경 사항을 메인 브랜치에 병합 요청하는 기능으로 코드 리뷰를 지원합니다.
이슈는 프로젝트의 문제나 개선 사항을 논의하는 공간입니다. 팀원과 소통하며 코드 품질을 높일 수 있습니다.
오픈소스 참여
깃허브는 오픈소스 프로젝트에 기여할 수 있는 플랫폼입니다. 관심 있는 레포지토리를 포크해 로컬로 클론한 뒤 수정 사항을 커밋합니다.
git push로 포크된 저장소에 업로드한 후 원본 저장소에 풀 리퀘스트를 보냅니다. 깃허브 사용법을 익히면 전 세계 개발자와 협업하며 오픈소스 커뮤니티에 기여할 수 있습니다.
마무리
(사진 출처: Github Brand Toolkit)
Github는 초보자도 쉽게 익힐 수 있는 강력한 도구입니다.
계정 생성, 깃 설치, 레포지토리 관리, 브랜치 활용, 협업까지 체계적으로 실습하면 프로젝트 관리와 협업이 효율적입니다. 깃허브 영상 다운로드는 지원되지 않지만 코드와 문서를 효과적으로 관리할 수 있습니다.
이 가이드를 바탕으로 깃허브 사용법을 연습해 개발 역량을 키우시길 바랍니다.