심리 테스트 허브

개발 블로그

← 목록 홈으로
🚀 실전 경험담

첫 프로젝트를 GitHub에 올리고 수정하기

드디어 내 코드를 세상에 공개하는 순간

📅 2026.02.15 ⏱️ 8분 읽기 👨‍💻 개발자

💭 드디어 올릴 때가 왔다

프로젝트를 열심히 만들고 나니 이제 GitHub에 올릴 차례였습니다. 사실 처음엔 걱정이 많았습니다. "내가 잘못 누르면 어떡하지?", "코드가 날아가진 않겠지?" 같은 생각들이 머릿속을 맴돌았거든요.

하지만 막상 해보니 GitHub Desktop 덕분에 생각보다 훨씬 쉬웠습니다. 오늘은 제가 처음으로 프로젝트를 GitHub에 올렸던 경험을 그대로 공유해보겠습니다.

📝 이 글에 담긴 내용

  • • GitHub Desktop에서 프로젝트 추가하기
  • • 비공개 Repository로 첫 업로드
  • • 코드 수정 후 업데이트하는 방법
  • • 실제로 겪은 시행착오와 해결 방법

🎬 1단계: GitHub Desktop 열기

GitHub Desktop을 실행하니 처음 화면에 이런 메시지가 나타났습니다:

📍 "Let's get started!" 화면

여기서 4가지 옵션이 보였는데:

  • 🎓 Create a tutorial repository...
  • 🌐 Clone a repository from the Internet...
  • ➕ Create a New Repository on your local drive...
  • 📁 Add an Existing Repository from your local drive... ← 이걸 선택했습니다

이미 만들어둔 프로젝트가 있으니까 **4번째 옵션**을 선택했습니다.

📂 2단계: 프로젝트 폴더 선택

폴더 찾아가기

Add an Existing Repository를 선택하니 폴더를 선택하는 창이 나타났습니다.

  • Choose... 버튼을 클릭했습니다
  • 내 프로젝트가 있는 폴더로 이동했습니다 
    D:\Project\SimpleTest
  • 폴더를 선택하고 선택 버튼을 눌렀습니다

"Git repository가 아니라고?" 😅

그런데 이런 메시지가 나타났습니다:

"This directory does not appear to be a Git repository."
(이 디렉토리는 Git repository가 아닌 것 같아요)

Would you like to create a repository here instead?

당황했지만 읽어보니 "여기에 repository를 만들까요?"라고 물어보는 거더군요. 당연히 **"create a repository"** (파란색 링크)를 클릭했습니다.

🎨 3단계: Repository 설정

Repository 생성 화면이 나타났습니다. 설정할 게 몇 가지 있었는데:

설정 항목들

  • Name: SimpleTest
    → 폴더 이름이 자동으로 들어가 있어서 그대로 뒀습니다
  • Local Path: D:\Project\SimpleTest
    → 이것도 자동으로 설정되어 있었습니다
  • Git Ignore: None
    → 일단 None으로 선택했습니다
  • License: None
    → 이것도 None으로 했습니다

설정을 확인하고 **"Create Repository"** 버튼을 클릭했습니다.

✅ Repository 생성 완료

화면이 바뀌면서 "No local changes"라는 메시지가 나타났습니다. 처음엔 뭔가 잘못된 줄 알았는데, 알고 보니 **이미 첫 번째 커밋이 자동으로 완료된 상태**였습니다. GitHub Desktop이 알아서 해준 거더군요.

🚀 4단계: GitHub에 업로드 (Publish)

이제 드디어 GitHub에 올릴 차례입니다. 화면을 찾아보니 오른쪽 상단에 **"Publish repository"** 버튼이 있었습니다.

Publish 설정하기

버튼을 클릭하자 팝업이 나타났습니다:

Publish repository 설정

📝 Name

Repository 이름입니다. 원하는 대로 변경할 수 있었는데 그냥 뒀습니다.

SimpleTest

📄 Description (선택사항)

프로젝트 설명입니다. 비워둬도 되길래 일단 간단히 적었습니다.

심리 테스트 웹사이트

🔒 Keep this code private

여기가 중요했습니다:

  • ✅ 체크: 나만 볼 수 있음 (비공개)
  • ☐ 체크 안함: 모두가 볼 수 있음 (공개)

저는 비공개로 하고 싶어서 체크했습니다

🏢 GitHub.com vs GitHub Enterprise

GitHub.com 탭이 선택되어 있는지 확인했습니다.
(일반 개인 계정은 GitHub.com 사용)

드디어 업로드

모든 설정을 확인하고 하단의 파란색 **"Publish repository"** 버튼을 클릭했습니다. 그러자 버튼에 로딩 애니메이션이 나타나더니... 몇 초 후 완료되었습니다.

🎉

업로드 성공

내 코드가 GitHub에 올라갔습니다
이제 어디서든 접근할 수 있게 되었습니다

✏️ 5단계: 코드 수정하고 다시 올리기

업로드는 했는데, 이제 궁금한 게 생겼습니다. "코드를 수정하면 어떻게 다시 올리지?" 실제로 해봤습니다.

Step 1: 파일 수정

Cursor 에디터에서 `index.html` 파일을 열고 제목에 느낌표를 하나 추가했습니다:

Before:

<h1>심리 테스트 허브</h1>

After:

<h1>심리 테스트 허브!</h1>

저장하고 GitHub Desktop으로 돌아갔습니다.

Step 2: 변경사항 확인

GitHub Desktop을 보니 좌측에 변경된 파일이 자동으로 표시되어 있었습니다.

📊 화면 구성

  • 좌측: 변경된 파일 목록
    • ✅ index.html
  • 우측: 무엇이 바뀌었는지 보여줌
    • - 심리 테스트 허브 (삭제)
    • + 심리 테스트 허브! (추가)

정말 신기했습니다. 느낌표 하나 추가한 것까지 정확하게 감지하더군요.

Step 3: Commit 생성

좌측 하단을 보니 **Summary** 입력란이 있었습니다. 여기에 무엇을 수정했는지 간단히 적으면 되더군요: 

제목에 느낌표 추가

메시지를 입력하고 **"Commit to main"** 버튼을 클릭했습니다.

💡 Commit 메시지 작성 팁

나중에 히스토리를 볼 때 중요하니 명확하게 작성하는 게 좋습니다.

좋은 예:

  • • "헤더 디자인 수정"
  • • "버그 수정: 로그인 에러"
  • • "MBTI 테스트 페이지 추가"

나쁜 예:

  • • "수정"
  • • "ㅁㄴㅇㄹ"
  • • "테스트"

Step 4: Push (GitHub에 업로드)

Commit을 하고 나니 화면 상단에 **"Push origin"** 버튼이 나타났습니다. 옆에 작은 숫자 1이 표시되어 있더군요. (1개의 커밋을 업로드할 준비가 되었다는 의미)

버튼을 클릭하자 다시 로딩이 돌더니 완료되었습니다.

✅ 업데이트 완료

수정한 내용이 GitHub에 반영되었습니다. 이제 GitHub 웹사이트에 가서 확인할 수 있습니다.

🤔 궁금했던 것들 Q&A

Q1. 이전 버전은 어떻게 되나요?

A: 사라지지 않습니다. 모든 버전이 히스토리에 저장됩니다.

GitHub Desktop의 History 탭을 클릭하면 모든 커밋을 볼 수 있습니다. 언제든지 이전 버전으로 돌아갈 수 있더군요.

Q2. 여러 파일을 한 번에 수정하면?

A: 한 번에 모두 커밋할 수 있습니다.

좌측에 변경된 모든 파일이 표시되고, 체크박스로 선택할 수 있었습니다. 원하는 파일만 선택해서 커밋할 수도 있더군요.

Q3. 실수로 잘못 올렸어요

A: 되돌릴 수 있습니다.

History 탭에서 잘못된 커밋을 우클릭 → Revert changes in commit을 선택하면 됩니다. 자동으로 되돌리는 새 커밋이 생성되더군요.

Q4. Push를 깜빡했어요

A: 상관없습니다. 나중에 Push하면 됩니다.

Commit은 로컬에 저장되고, Push는 GitHub에 업로드하는 것입니다. 여러 개 커밋을 모아서 한 번에 Push할 수도 있습니다.

📚 앞으로의 워크플로우

이제부터는 이 과정을 반복하면 됩니다:

🔄 일상적인 개발 사이클

1

코드 수정

에디터에서 파일 수정하고 저장

2

GitHub Desktop 확인

변경사항 자동 감지됨

3

Commit

Summary 입력 → "Commit to main" 클릭

4

Push

"Push origin" 클릭

익숙해지면 이 과정이 1분도 안 걸립니다. 저도 이제는 코드 수정하고 자동으로 손이 GitHub Desktop으로 갑니다.

💪 마치며

처음엔 두려웠던 GitHub 업로드가 막상 해보니 정말 간단했습니다. GitHub Desktop 덕분에 복잡한 명령어를 하나도 몰라도 버전 관리를 할 수 있었습니다.

가장 좋았던 점은 **"실수해도 되돌릴 수 있다"**는 안정감이었습니다. 이전 버전이 모두 저장되어 있으니, 과감하게 코드를 수정하고 실험할 수 있게 되었습니다.

10분이면 충분합니다. 그리고 그 순간부터 **버전 관리를 하는 개발자**가 되는 겁니다.

🎯

오늘의 성과

✅ GitHub에 첫 프로젝트 업로드 완료
✅ 코드 수정 → Commit → Push 워크플로우 이해
✅ 버전 관리 시스템 사용 시작

블로그 목록으로 홈으로 가기