깃허브 데스크탑 사용법 : 커밋부터 풀 리퀘스트까지

 

 

깃허브 데스크탑 설치 설정, 다운로드 설치 방법, 계정 연동 사용법, 리포지토리 클론, 스태시 활용, 커밋부터 풀 리퀘스트까지 살펴봅니다.

 

 

깃허브 데스크탑 설치 및 설정

 

다운로드 및 설치 방법

깃허브 데스크탑을 설치하는 과정은 생각보다 간단합니다.

다음 단계를 따라해 보세요.

 

1. 먼저 공식 웹사이트(https://desktop.github.com/)에 접속합니다.
2. 웹사이트 중앙에 있는 큰 "Download for Windows (or Mac)" 버튼을 클릭합니다. 운영체제에 맞는 버전이 자동으로 다운로드됩니다.
3. 다운로드가 완료되면 설치 파일을 실행합니다. Windows의 경우 'GitHubDesktopSetup-x64.exe' 파일을 더블클릭하세요.
4. 설치 과정은 매우 빠르게 진행됩니다. 약 5초 정도만 기다리면 설치가 완료되고 프로그램이 자동으로 실행됩니다.
5. 설치가 완료되면 바탕화면에 깃허브 데스크탑 아이콘이 생성됩니다. 이후에는 이 아이콘을 통해 프로그램을 실행할 수 있습니다.

깃허브 계정 연동하기

깃허브 데스크탑을 설치한 후에는 깃허브 계정과 연동하는 것이 좋습니다. 하지만 꼭 필수는 아닙니다.

다음 단계를 따라 계정을 연동해 보세요.

 

1. 깃허브 데스크탑을 처음 실행하면 로그인 화면이 나타납니다.
2. "Sign into GitHub.com"을 클릭하면 웹 브라우저에서 깃허브 로그인 페이지가 열립니다.
3. 깃허브 아이디와 비밀번호를 입력하고 로그인합니다.
4. 로그인 후 "Authorize desktop" 버튼을 클릭하여 깃허브 데스크탑 애플리케이션에 권한을 부여합니다.
5. 권한 부여가 완료되면 깃허브 데스크탑으로 돌아와 계정 연동이 완료됩니다.

만약 지금 당장 계정 연동을 원하지 않는다면, "Skip this step" 버튼을 클릭하여 이 과정을 건너뛸 수 있습니다. 이 경우 이름과 이메일 주소만 입력하면 됩니다.

 

 

 

 

 

리포지토리 관리

 

새 리포지토리 생성하기

새 프로젝트를 시작할 때는 새로운 리포지토리를 만들어야 합니다.

방법은 다음과 같습니다.

 

1. 깃허브 데스크탑을 실행하고 상단 메뉴에서 'File' > 'New repository'를 선택합니다.

2. 새 창이 뜨면 다음 정보를 입력합니다.

 

• Name : 리포지토리 이름 (예: my-first-project)
• Description : 프로젝트 설명 (선택사항)
• Local path : 리포지토리가 저장될 로컬 경로
• README 파일 생성 여부
• Git ignore : 무시할 파일 유형 선택
• License : 프로젝트 라이선스 선택

3. 모든 정보를 입력한 후 'Create repository' 버튼을 클릭합니다.

이렇게 하면 로컬에 새 리포지토리가 생성됩니다. 이제 이 폴더에 프로젝트 파일을 추가하면 됩니다.

 

기존 리포지토리 클론하기

다른 사람의 프로젝트나 이미 깃허브에 있는 프로젝트를 로컬로 가져오고 싶다면 클론을 사용합니다.

 

1. 깃허브 데스크탑 메인 화면에서 'Clone a repository from the Internet' 버튼을 클릭합니다.
2. 'GitHub.com' 탭에서 클론하고 싶은 리포지토리를 선택하거나, 'URL' 탭에서 리포지토리 주소를 직접 입력합니다.
3. 로컬에 저장할 경로를 선택합니다.
4. 'Clone' 버튼을 클릭합니다.

이제 선택한 리포지토리의 모든 파일과 커밋 기록이 로컬 컴퓨터에 복사됩니다.

 

로컬 프로젝트 리포지토리 추가

이미 로컬에서 작업 중인 프로젝트를 깃허브 리포지토리로 만들고 싶다면 다음 과정을 따르세요.

 

1. 깃허브 데스크탑 메인 화면에서 'Add an Existing Repository from your hard drive' 버튼을 클릭합니다.
2. 프로젝트 폴더를 선택합니다.
3. 만약 선택한 폴더가 Git 리포지토리가 아니라면, 'Create a repository' 버튼이 나타납니다. 이 버튼을 클릭하세요.
4. 리포지토리 이름, 설명 등을 입력하고 'Create repository' 버튼을 클릭합니다.

이제 여러분의 로컬 프로젝트가 Git 리포지토리로 변환되었습니다.

 

 

기본 Git 작업 수행

 

변경 사항 커밋하기

커밋은 프로젝트의 변경 사항을 저장하는 작업입니다.

파일을 수정하고 나서 이 변경 사항을 기록하고 싶을 때 커밋을 합니다.

 

1. 깃허브 데스크탑을 열면 왼쪽 패널에 변경된 파일 목록이 나타납니다.
2. 변경 사항을 확인하고, 커밋하고 싶은 파일들의 체크박스를 선택합니다.
3. 화면 왼쪽 하단에 있는 'Summary' 란에 커밋 메시지를 입력합니다. 변경 사항을 간단히 설명하는 내용이어야 합니다.
4. 필요하다면 'Description' 란에 더 자세한 설명을 추가할 수 있습니다.
5. 'Commit to main' 버튼을 클릭하여 커밋을 완료합니다.

이렇게 하면 선택한 변경 사항들이 하나의 커밋으로 저장됩니다.

 

브랜치 생성 및 전환

브랜치는 독립적으로 작업을 진행하기 위한 별도의 작업 공간입니다.

새로운 기능을 개발하거나 버그를 수정할 때 주로 사용합니다.

 

1. 깃허브 데스크탑 상단의 'Current branch' 드롭다운 메뉴를 클릭합니다.
2. 'New branch' 버튼을 클릭합니다.
3. 새 브랜치의 이름을 입력하고 'Create branch' 버튼을 클릭합니다.
4. 브랜치 간 전환은 'Current branch' 드롭다운 메뉴에서 원하는 브랜치를 선택하면 됩니다.

이제 새로운 브랜치에서 자유롭게 작업할 수 있습니다.

 

원격 저장소로 푸시하기

로컬에서 작업한 내용을 깃허브의 원격 저장소에 업로드하는 것을 푸시라고 합니다.

 

1. 커밋을 완료한 후, 깃허브 데스크탑 상단에 'Push origin' 버튼이 나타납니다.
2. 이 버튼을 클릭하면 로컬의 변경 사항이 원격 저장소로 푸시됩니다.
3. 만약 새로 만든 브랜치를 처음 푸시하는 경우, 'Publish branch' 버튼이 나타납니다. 이 버튼을 클릭하면 됩니다.

푸시를 완료하면 깃허브 웹사이트에서 변경 사항을 확인할 수 있습니다.

 

원격 저장소에서 풀하기

다른 사람이 원격 저장소에 변경 사항을 푸시했거나, 웹사이트에서 직접 수정한 경우 이를 로컬로 가져오는 작업을 풀이라고 합니다.

 

1. 깃허브 데스크탑 상단의 'Fetch origin' 버튼을 클릭하여 원격 저장소의 변경 사항을 확인합니다.
2. 변경 사항이 있다면 'Pull origin' 버튼이 나타납니다.
3. 이 버튼을 클릭하여 변경 사항을 로컬 저장소로 가져옵니다.

주기적으로 풀을 수행하면 항상 최신 버전의 프로젝트를 유지할 수 있습니다.

 

 

 

 

 

협업 기능 활용

 

풀 리퀘스트 생성 및 관리

풀 리퀘스트는 여러분이 작업한 내용을 메인 브랜치에 병합하기 전에 다른 팀원들과 함께 검토할 수 있게 해주는 기능입니다.

 

1. 먼저, 여러분의 작업 브랜치에서 변경사항을 커밋하고 푸시합니다.
2. 깃허브 데스크탑의 상단 메뉴에서 'Branch' > 'Create Pull Request'를 클릭합니다.
3. 그러면 웹 브라우저가 열리면서 풀 리퀘스트 생성 페이지로 이동합니다.
4. 제목과 설명을 작성하고, 리뷰어를 지정한 후 'Create pull request' 버튼을 클릭합니다.
5. 풀 리퀘스트가 생성되면, 깃허브 웹사이트에서 해당 풀 리퀘스트의 상태를 확인하고 관리할 수 있습니다.

이렇게 하면 다른 팀원들이 여러분의 코드를 검토하고 피드백을 줄 수 있게 됩니다.

 

코드 리뷰 수행하기

코드 리뷰는 팀의 코드 품질을 높이고 버그를 사전에 방지하는 데 매우 중요합니다.

 

1. 깃허브 웹사이트에서 해당 풀 리퀘스트 페이지로 이동합니다.
2. 'Files changed' 탭을 클릭하면 변경된 파일들을 볼 수 있습니다.
3. 코드 라인 옆의 '+' 버튼을 클릭하면 해당 라인에 대한 코멘트를 남길 수 있습니다.
4. 전체적인 리뷰를 마친 후, 페이지 상단의 'Review changes' 버튼을 클릭합니다.
5. 코멘트와 함께 'Approve'(승인), 'Request changes'(변경 요청), 또는 단순 'Comment'(코멘트)를 선택할 수 있습니다.

이런 방식으로 팀원들과 서로의 코드를 검토하고 개선할 수 있습니다.

 

충돌 해결하기

때로는 여러 사람이 같은 파일의 같은 부분을 수정하면 충돌이 발생할 수 있습니다. 이럴 때는 다음과 같이 해결합니다.

 

1. 깃허브 데스크탑에서 충돌이 발생한 브랜치로 전환합니다.
2. 'Repository' > 'Pull'을 선택해 최신 변경사항을 가져옵니다.
3. 충돌이 발생한 파일을 열면 '<<<<<<< HEAD', '=======', '>>>>>>>' 같은 표시와 함께 충돌 부분이 표시됩니다.
4. 이 부분을 수동으로 편집하여 최종적으로 어떤 코드를 유지할지 결정합니다.
5. 충돌을 해결한 후, 변경사항을 커밋하고 푸시합니다.
6. 다시 풀 리퀘스트 페이지로 가면 충돌이 해결되었다는 메시지와 함께 병합이 가능해집니다.

이렇게 하면 충돌을 해결하고 작업을 계속 진행할 수 있습니다.

 

 

고급 기능 사용법

 

스태시(Stash) 활용하기

스태시는 현재 작업 중인 변경사항을 임시로 저장해 두는 기능입니다.

작업을 완료하지 않은 상태에서 다른 브랜치로 전환해야 할 때 유용합니다.

 

1. 변경사항이 있는 상태에서 '변경된 파일' 헤더를 우클릭합니다.
2. '모든 변경 내용 스태시'를 선택합니다.
3. 이렇게 하면 변경사항이 임시 저장되고 작업 디렉터리가 깨끗해집니다.

스태시한 변경사항을 다시 불러오려면

 

1. 왼쪽 사이드바의 '변경 내용' 탭에서 '스태시된 변경 내용'을 클릭합니다.
2. '복원' 버튼을 클릭하면 스태시된 변경사항이 다시 적용됩니다.

이 기능을 잘 활용하면 여러 작업을 동시에 진행할 때 매우 편리합니다.

 

커밋 되돌리기 및 수정하기

때로는 이미 커밋한 내용을 수정하거나 되돌려야 할 때가 있습니다.

커밋을 되돌리려면

 

1. 히스토리 탭에서 되돌리고 싶은 커밋을 우클릭합니다.
2. '이 커밋 되돌리기'를 선택합니다.
3. 새로운 커밋이 생성되며, 이전 커밋의 변경사항이 취소됩니다.

마지막 커밋을 수정하려면

 

1. 변경사항을 만든 후 '커밋' 버튼 옆의 화살표를 클릭합니다.
2. '마지막 커밋 수정'을 선택합니다.
3. 커밋 메시지를 수정하고 변경사항을 추가한 후 '커밋 수정'을 클릭합니다.

이 기능들을 사용하면 실수로 잘못 커밋한 내용을 쉽게 고칠 수 있습니다.

 

체리픽(Cherry-pick) 사용하기

체리픽은 다른 브랜치의 특정 커밋만을 현재 브랜치에 적용하는 기능입니다.

 

1. 히스토리 탭에서 가져오고 싶은 커밋을 우클릭합니다.
2. 'Cherry-pick this commit'을 선택합니다.
3. 선택한 커밋의 변경사항이 현재 브랜치에 적용됩니다.

이 기능은 다른 브랜치에서 작업한 특정 기능만을 현재 브랜치에 적용하고 싶을 때 매우 유용합니다.

 

이러한 고급 기능들은 처음에는 복잡해 보일 수 있지만, 실제 프로젝트에서 매우 유용하게 사용됩니다.

특히 여러 브랜치에서 동시에 작업하거나, 복잡한 merge 상황에서 이 기능들을 활용하면 작업 효율을 크게 높일 수 있습니다.

 

 

 

 

 

데스크탑 커스터마이징

 

테마 설정

깃허브 데스크탑은 사용자의 눈의 피로를 줄이고 개인 취향을 반영할 수 있도록 다양한 테마를 제공합니다.

 

1. 화면 상단의 'File' 메뉴를 클릭한 후 'Options'를 선택합니다.
2. 왼쪽 사이드바에서 'Appearance'를 클릭합니다.
3. 'Theme' 섹션에서 원하는 테마를 선택할 수 있습니다.

기본적으로 'Light', 'Dark', 'System default' 세 가지 옵션이 제공됩니다. 'System default'를 선택하면 운영 체제의 테마 설정을 따라갑니다. 밝은 환경에서는 'Light' 테마가, 어두운 환경에서는 'Dark' 테마가 눈의 피로를 줄이는 데 도움이 됩니다.

 

기본 에디터 변경

깃허브 데스크탑에서 파일을 열 때 사용할 기본 에디터를 설정할 수 있습니다.

 

1. 'File' > 'Options'로 이동합니다.
2. 왼쪽 사이드바에서 'Integrations'를 선택합니다.
3. 'External editor' 드롭다운 메뉴에서 원하는 에디터를 선택합니다.

여기서 Visual Studio Code, Sublime Text, Atom 등 다양한 에디터 중 선택할 수 있습니다. 만약 사용하고 싶은 에디터가 목록에 없다면, '다른 에디터 선택'을 통해 직접 지정할 수도 있습니다.

이렇게 설정하면 깃허브 데스크탑에서 파일을 열 때 항상 지정한 에디터가 실행됩니다. 코드 수정 작업을 더욱 편리하게 만들어줍니다.

 

단축키 활용

깃허브 데스크탑은 다양한 단축키를 제공하여 작업 속도를 높일 수 있습니다.

주요 단축키는 다음과 같습니다.

 

• Ctrl + N (Mac: Cmd + N) : 새 저장소 생성
• Ctrl + Shift + O (Mac: Cmd + Shift + O) : 저장소 추가
• Ctrl + T (Mac: Cmd + T) : 새 브랜치 생성
• Ctrl + P (Mac: Cmd + P) : 변경사항 푸시
• Ctrl + Shift + P (Mac: Cmd + Shift + P) : 변경사항 풀
• Ctrl + Enter (Mac: Cmd + Enter) : 변경사항 커밋

이 외에도 많은 단축키가 있습니다. 전체 단축키 목록을 보려면

 

1. 'Help' 메뉴를 클릭합니다.
2. 'Keyboard shortcuts'를 선택합니다.

이 단축키들을 자주 사용하다 보면 자연스럽게 익숙해지고, 작업 속도가 크게 향상될 것입니다.

 

이렇게 깃허브 데스크탑을 커스터마이징하면 개인의 작업 스타일에 맞게 더욱 효율적으로 사용할 수 있습니다.

테마 설정으로 눈의 피로를 줄이고, 자주 사용하는 에디터를 기본으로 설정하여 편리하게 코드를 수정할 수 있으며, 단축키를 활용해 작업 속도를 높일 수 있습니다.

 

 

문제 해결 및 팁

 

자주 발생하는 오류와 해결 방법

 

파일 크기 제한 오류

100MB 이상의 파일을 커밋하려고 할 때 "Files too large" 경고창이 뜨는 경우가 있습니다.

깃허브의 파일 크기 제한 때문입니다. 해결 방법은 다음과 같습니다.

 

• .gitignore 파일을 수정하여 큰 파일들을 무시하도록 설정합니다.
• 꼭 필요한 대용량 파일이라면 Git LFS(Large File Storage)를 사용합니다.

인증 오류

"The username or passphrase you entered is not correct" 오류가 발생할 수 있습니다.

키체인에 저장된 자격 증명에 접근할 수 없을 때 나타납니다. 해결 방법은 다음과 같습니다.

 

• 키체인 접근 앱을 열고 로그인 키체인의 잠금을 해제합니다.
• 깃허브 계정을 다시 인증합니다.

업데이트 오류

"Could not create temporary directory: Permission denied" 오류가 발생할 수 있습니다.

특정 디렉토리에 대한 권한이 없을 때 나타납니다. 해결 방법은 다음과 같습니다.

 

• Finder에서 해당 디렉토리의 권한을 "읽기 및 쓰기"로 변경합니다.

설정 파일 잠금 오류

"could not lock config file permission denied" 오류가 발생할 수 있습니다.

주로 관리자 권한 문제로 인해 발생합니다. 해결 방법은 다음과 같습니다.

 

• 에러 메시지에 표시된 경로로 이동하여 폴더 접근을 허용합니다.
• 깃허브 데스크탑을 관리자 권한으로 실행합니다.

효율적인 사용을 위한 팁과 트릭

 

커밋 수정하기

마지막 커밋을 수정해야 할 때는 'git commit --amend' 명령어를 사용합니다. 이를 통해 커밋 메시지를 수정하거나 누락된 파일을 추가할 수 있습니다.

 

브랜치 관리

실수로 마스터 브랜치에 커밋했다면, 새 브랜치를 만들고 마스터를 이전 상태로 되돌린 후 새 브랜치로 전환하는 방법을 사용할 수 있습니다.

 

파일 복구

실수로 삭제한 파일을 복구하려면 'git checkout' 명령어를 사용하여 이전 커밋에서 파일을 가져올 수 있습니다.

 

강제 푸시 주의

'git push --force' 명령어는 매우 위험할 수 있으므로 주의해서 사용해야 합니다. 가능하면 강제 푸시를 비활성화하는 것이 좋습니다.

 

단축키 활용

깃허브 데스크탑의 단축키를 익혀두면 작업 속도를 크게 높일 수 있습니다. Ctrl+N(Mac: Cmd+N)은 새 저장소 생성, Ctrl+P(Mac: Cmd+P)는 변경사항 푸시 등입니다.

 

 

깃허브 데스크탑 사용법 FAQ

 

Q : 깃허브 데스크탑은 무엇인가요?

깃허브 데스크탑은 Git 명령어를 모르더라도 GUI로 쉽게 버전 관리를 할 수 있게 해주는 프로그램입니다.

커밋이나 푸시 같은 작업을 버튼 클릭만으로 할 수 있습니다.

 

Q : 깃허브 데스크탑을 어떻게 설치하나요?

깃허브 공식 웹사이트(desktop.github.com)에서 운영체제에 맞는 버전을 다운로드하여 설치할 수 있습니다.

설치 과정은 다운로드한 파일을 실행하고 안내에 따라 진행하면 됩니다.

 

Q : 깃허브 계정과 어떻게 연동하나요?

깃허브 데스크탑을 처음 실행하면 로그인 화면이 나옵니다.

여기서 깃허브 계정 정보를 입력하면 자동으로 연동됩니다.

 

Q : 새 저장소를 어떻게 만드나요?

깃허브 데스크탑 메인 화면에서 'Create a New Repository' 버튼을 클릭하면 됩니다.

저장소 이름, 설명, 저장 위치 등을 입력하고 생성하면 됩니다.

 

Q : 변경사항을 어떻게 커밋하나요?

파일을 수정한 후, 깃허브 데스크탑의 왼쪽 패널에서 변경된 파일들을 확인할 수 있습니다.

커밋하고 싶은 파일들을 선택하고, 하단에 커밋 메시지를 입력한 후 'Commit to main' 버튼을 클릭하면 됩니다.

 

Q : 원격 저장소로 어떻게 푸시하나요?

커밋을 완료한 후, 상단에 'Push origin' 버튼이 나타납니다.

이 버튼을 클릭하면 로컬의 변경사항이 깃허브의 원격 저장소로 푸시됩니다.

 

Q : 브랜치는 어떻게 만들고 전환하나요?

상단의 'Current Branch' 드롭다운 메뉴에서 'New Branch'를 선택하여 새 브랜치를 만들 수 있습니다.

브랜치 전환은 같은 메뉴에서 원하는 브랜치를 클릭하면 됩니다.

 

Q : 충돌이 발생했을 때 어떻게 해결하나요?

충돌이 발생하면 깃허브 데스크탑에서 알림을 줍니다.

충돌이 발생한 파일을 열어 충돌 부분을 직접 수정한 후, 다시 커밋하면 됩니다.

 

Q : 풀 리퀘스트는 어떻게 생성하나요?

변경사항을 커밋하고 푸시한 후, 'Create Pull Request' 버튼을 클릭합니다.

그러면 웹 브라우저가 열리며 풀 리퀘스트 생성 페이지로 이동합니다. 여기서 제목과 설명을 입력하고 생성하면 됩니다.

 

Q : 깃허브 데스크탑에서 코드 리뷰는 어떻게 하나요?

깃허브 데스크탑에서 직접적인 코드 리뷰 기능은 제공하지 않습니다.

하지만 풀 리퀘스트를 통해 웹 브라우저에서 코드 리뷰를 진행할 수 있습니다. 변경된 코드를 확인하고 코멘트를 남기는 방식으로 리뷰가 이루어집니다.

 

깃허브 사용법 알아보기

단축키 활용 : 초보자를 위한 가이드