GitHub Desktop으로 쉽게 시작하는 버전 관리
명령어 없이 GUI로 배우는 Git의 모든 것
💭 왜 이 글을 쓰게 되었나
프로젝트를 진행하면서 "Git을 꼭 써야 하나?"라는 생각을 한 적이 있습니다. 복잡한 명령어들, 브랜치 개념, 머지 충돌... 처음에는 정말 어렵게만 느껴졌거든요. 하지만 막상 사용해보니 버전 관리가 이렇게 편할 수가 없더군요.
특히 GitHub Desktop을 알게 된 후로는 Git이 훨씬 친숙해졌습니다. 명령어를 외울 필요도 없고, 시각적으로 변경사항을 확인할 수 있으니 초보자인 저한테 최적이었습니다. 오늘은 제가 경험한 GitHub Desktop 활용법을 처음부터 끝까지 공유해보려 합니다.
💡 이 글에서 다룰 내용
- • GitHub Desktop이 왜 초보자에게 좋은지
- • 설치부터 첫 커밋까지 완벽 가이드
- • 실제 프로젝트를 GitHub에 올리는 방법
- • 일상적인 작업 흐름 (워크플로우)
🤔 GitHub Desktop이 뭐길래?
명령어 vs GUI, 뭐가 다른가요?
Git을 사용하는 방법은 크게 두 가지입니다:
방법 1: 명령어 (CLI)
git init
git add .
git commit -m "Initial commit"
git push origin main장점: 빠르고 강력함 / 단점: 학습 곡선이 있음
방법 2: GUI (GitHub Desktop)
버튼 클릭으로 모든 작업 완료
- ✅ 시각적으로 변경사항 확인 가능
- ✅ 명령어 외울 필요 없음
- ✅ 실수할 위험 감소
- ✅ 초보자 친화적
저는 처음에 명령어로 시작했다가 실수로 작업한 코드를 날려먹은 적이 있습니다... 그 후로 GitHub Desktop을 쓰기 시작했는데, 정말 편하더군요. 나중에 익숙해지면 명령어로 전환해도 늦지 않습니다.
📥 GitHub Desktop 설치하기
1단계: 다운로드
공식 웹사이트에서 다운로드하면 됩니다:
⚠️ Git 먼저 설치해야 하나요?
GitHub Desktop에는 Git이 포함되어 있어서 별도로 설치할 필요 없습니다. 하나만 설치하면 끝입니다.
2단계: 설치 및 로그인
- 다운로드한
GitHubDesktopSetup.exe실행 - 설치 완료 후 GitHub Desktop 실행
- Sign in to GitHub.com 클릭
- 브라우저에서 GitHub 계정으로 로그인
- Authorize desktop 클릭하여 권한 허용
- 이름과 이메일 설정 (Git commit에 사용됨)
- Finish 클릭
설치 시간은 약 5분 정도 걸렸습니다. 설치가 끝나니 깔끔한 UI가 반겨주더군요.
🚀 첫 프로젝트 올리기
자, 이제 실제로 프로젝트를 GitHub에 올려보겠습니다. 저는 현재 작업 중인 심리 테스트 웹사이트를 예시로 사용했습니다.
Step 1: 로컬 프로젝트 추가
- GitHub Desktop에서 File → Add Local Repository 클릭
- Choose... 버튼 클릭
- 프로젝트 폴더 선택 (예:
D:\Project\SimpleTest) - Add Repository 클릭
Step 2: Repository 초기화
"This directory does not appear to be a Git repository" 메시지가 나타났습니다:
- create a repository (파란색 링크) 클릭
- Repository 이름 확인 (폴더명이 자동으로 들어감)
- Git Ignore: None 선택
- License: None 선택
- Create Repository 버튼 클릭
✅ 성공
이제 좌측에 변경된 파일 목록이 보였습니다. 모든 프로젝트 파일들이 초록색으로 표시되어 있었습니다. (새로 추가된 파일이라는 의미)
Step 3: 첫 Commit 만들기
Commit은 "저장 지점"을 만드는 것입니다. 게임의 세이브 포인트와 비슷하다고 생각하면 됩니다.
- 좌측 하단 Summary 입력란에 메시지 입력:
Initial commit: 프로젝트 초기 버전
- Description에 더 자세한 설명 추가 (선택사항)
- 파란색 Commit to main 버튼 클릭
💡 Commit 메시지 작성 팁
좋은 예:
- • "MBTI 테스트 페이지 추가"
- • "버그 수정: 결과 페이지 로딩 오류"
- • "디자인 개선: 모바일 반응형 적용"
나쁜 예:
- • "수정"
- • "ㅁㄴㅇㄹ"
- • "aaa"
Step 4: GitHub에 업로드 (Publish)
이제 로컬에 저장된 코드를 GitHub 서버로 올릴 차례였습니다.
- 화면 상단 중앙의 Publish repository 버튼 찾기
- 버튼 클릭 시 팝업 창이 나타남
- 설정:
- Name: 원하는 레포지토리 이름 입력
- Description: 프로젝트 설명 (선택)
- Organization: None (개인 계정 사용)
- ✅ Keep this code private: 비공개로 하려면 체크
- Publish Repository 버튼 클릭
🔒 Public vs Private?
Public (공개)
- ✅ 누구나 볼 수 있음
- ✅ 포트폴리오로 활용 가능
- ✅ 오픈소스 프로젝트에 적합
- ❌ 민감한 정보 노출 위험
Private (비공개)
- ✅ 나만 볼 수 있음
- ✅ 민감한 정보 보호
- ✅ 상업용 프로젝트에 적합
- ❌ 포트폴리오로 활용 불가
🔄 일상적인 작업 흐름
이제부터는 매일 반복하게 될 워크플로우입니다. 엄청 간단합니다.
1. 코드 수정하기
평소처럼 에디터(Cursor, VS Code 등)에서 코드를 수정하고 저장합니다.
2. GitHub Desktop에서 변경사항 확인
- GitHub Desktop을 열면 자동으로 변경된 파일이 표시됩니다
- 좌측에서 파일을 클릭하면 우측에 무엇이 바뀌었는지 확인 가능합니다
- + 초록색: 추가된 내용
- - 빨간색: 삭제된 내용
3. Commit 생성
- 변경사항 확인 후 좌측 하단 Summary에 메시지 입력
- Commit to main 클릭
4. GitHub에 Push
- 상단 중앙의 Push origin 버튼 클릭
- GitHub 서버로 업로드 완료
✨ 이게 전부입니다
코드 수정 → GitHub Desktop 열기 → Commit → Push
이 4단계만 반복하면 됩니다. 익숙해지면 1분도 안 걸립니다.
🔧 실전 팁과 트러블슈팅
자주 하는 실수와 해결법
❌ 문제: Commit 메시지를 잘못 입력했어요
해결:
- History 탭 클릭
- 잘못된 커밋 우클릭
- "Amend commit..." 선택
- 메시지 수정 후 저장
⚠️ 문제: 실수로 잘못된 코드를 Push했어요
해결:
- History 탭에서 되돌아가고 싶은 커밋 찾기
- 우클릭 → "Revert changes in commit" 선택
- 자동으로 되돌리는 새 커밋이 생성됨
- Push origin 클릭하여 업로드
💡 이전 커밋이 삭제되는 게 아니라, 그 변경을 취소하는 새 커밋이 추가되는 방식입니다
💡 팁: .gitignore 파일 활용하기
특정 파일이나 폴더를 Git이 무시하게 만들 수 있습니다. 프로젝트 루트에 .gitignore 파일을 만들고:
# 환경 변수 파일 (API 키 등)
.env
.env.local
# Node modules
node_modules/
# 빌드 결과물
dist/
build/
# OS 파일
.DS_Store
Thumbs.db⚠️ 특히 API 키나 비밀번호가 담긴 파일은 반드시 .gitignore에 추가해야 합니다
🎓 마치며
GitHub Desktop을 사용하니 Git의 복잡한 개념을 몰라도 버전 관리를 시작할 수 있었습니다. 저도 처음엔 명령어가 무서워서 Git을 피했는데, GitHub Desktop 덕분에 자신감을 얻었습니다.
익숙해지면 나중에 명령어로 넘어가도 늦지 않습니다. 중요한 건 "일단 시작하는 것"이니까요. 10분이면 충분합니다. 그리고 그 순간부터 **버전 관리를 하는 개발자**가 되는 겁니다.
🚀
다음 글 예고
명령어로 배우는 Git 기초 - 터미널이 두렵지 않아지는 순간