GitHub 맞춤형 매뉴얼

GitHub란 무엇인가?

GitHub는 코드와 파일을 인터넷(클라우드)에 저장하고 관리하는 서비스입니다. 구글 드라이브처럼 파일을 저장할 수 있고, 추가로 언제 어떤 내용을 바꿨는지 기록이 남는 "타임머신" 기능까지 갖추고 있습니다.

💾

파일 저장 / 백업

≈

구글 드라이브에 파일 올리기

🕰️

버전 관리 (이전으로 복원)

≈

워드 문서 "이전 버전 복원"

📝

변경 이력 기록

≈

카카오톡 대화 내역 확인

🌐

홈페이지 무료 배포

≈

파일 올리면 바로 웹사이트 공개

🔄

두 기기 동기화

≈

아이클라우드 자동 동기화

🛡️

안전한 백업

≈

컴퓨터 고장나도 파일 복구 가능

핵심 용어 3가지 — 이것만 알면 80%!

💡

TIP

아래 3가지 용어만 확실히 이해하면 GitHub 일상 사용에 전혀 지장이 없습니다. Commit → Push가 기본 루틴입니다.

용어	의미	비유	빈도
Commit	변경 사항을 로컬(내 컴퓨터)에 기록하는 행위 메모(Summary)와 함께 저장됨	"저장" 버튼 클릭 + 메모 남기기	매일
Push	로컬의 Commit 내용을 GitHub 서버(클라우드)에 업로드	구글 드라이브에 파일 올리기	매일
Pull	GitHub 서버에서 최신 내용을 내 컴퓨터로 다운로드	구글 드라이브에서 파일 내려받기	필요 시

GitHub Desktop 화면 구성

GitHub Desktop은 복잡한 명령어 없이 버튼 클릭만으로 GitHub를 사용할 수 있는 앱입니다. 화면 구성을 미리 파악해두면 작업이 훨씬 수월합니다.

화면 요소	위치	역할	언제 사용?
Current Repository	좌측 상단	현재 작업 중인 프로젝트 선택	프로젝트 전환 시
Changes 탭	좌측 패널	수정된 파일 목록 자동 표시	항상
History 탭	좌측 패널	과거 Commit 이력 확인	버전 확인 시
Summary 입력란	좌측 하단	이번 저장의 메모 입력 (필수)	Commit 전
Commit to main	좌측 하단 버튼	로컬 저장 실행	작업 후
Push origin	상단 버튼	GitHub 서버에 업로드	Commit 후
Pull origin	상단 버튼	GitHub 서버에서 다운로드	다른 기기 작업 후
Fetch origin	상단 버튼	서버와 동기화 상태 확인	작업 시작 전
View on GitHub	우측 메뉴	브라우저에서 저장소 열기	히스토리 상세 확인 시
Show in Finder	우측 메뉴	파인더에서 폴더 열기	파일 직접 접근 시
Open in Cursor	우측 메뉴	Cursor 편집기에서 열기	바이브코딩 시작 시

CHAPTER 1

파일 저장 & 불러오기

GitHub를 드라이브처럼 활용하여 작업 파일을 저장하고 다른 기기에서 불러오는 방법

1-1. 기본 작업 흐름

파일을 수정한 후 GitHub에 저장하는 과정은 항상 동일합니다. Commit(로컬 저장) → Push(클라우드 업로드) 순서입니다.

✏️

STEP 1

파일 수정

🖥️

STEP 2

GH Desktop 열기

📋

STEP 3

Summary 입력

💾STEP 4
Commit

☁️STEP 5
Push

1-2. Commit — 변경사항 로컬 저장

Commit은 내 컴퓨터에 변경 기록을 남기는 작업입니다. 인터넷 없이도 가능하며, Push 전 단계입니다.

1

GitHub Desktop 앱 열기

Dock 또는 응용프로그램 폴더에서 GitHub Desktop 실행

💡 작업 중에는 앱을 켜두지 않아도 됩니다. 작업 마무리 후에 열면 됩니다.

2

저장소 선택

좌측 상단 "Current Repository" 클릭 → 원하는 저장소 선택

📁 홈페이지 작업 중이면 pathfinder-homepage 선택 / 가계부 작업 중이면 wowbook 선택

3

Changes 탭에서 수정 파일 확인

수정된 파일 목록이 자동으로 표시됩니다. 체크박스로 포함/제외 선택 가능합니다.

🟢 초록 + : 새로 추가된 파일 🟡 노란 점 : 수정된 파일 🔴 빨간 - : 삭제된 파일

4

Summary 입력 (필수!)

좌측 하단 Summary 입력란에 작업 내용을 간단히 입력합니다. 나중에 히스토리에서 무엇을 했는지 알 수 있게 구체적으로 적는 것이 중요합니다.

✅ 좋은 예: "홈페이지 메인 배너 이미지 교체" / "제품 페이지 자동차 부품 카테고리 추가"
❌ 나쁜 예: "수정" / "업데이트" / "작업"

5

"Commit to main" 버튼 클릭

파란색 "Commit to main" 버튼 클릭 → 로컬 저장 완료

✅ 하단에 "Committed just now + [메시지]" 가 표시되면 성공입니다

⚠️

주의

Commit을 하지 않고 컴퓨터를 끄면 변경 사항 추적이 되지 않습니다. Push 전이라도 Commit은 꼭 해두세요. Commit은 오프라인에서도 가능합니다.

1-3. Push — GitHub 서버에 업로드

Commit한 내용을 GitHub 서버(클라우드)에 업로드하는 작업입니다. 인터넷 연결이 필요합니다.

1

Commit 완료 확인

하단에 최근 커밋 메시지가 표시되는지 확인합니다

상단 버튼에 숫자가 표시되면 업로드 대기 중인 Commit 수를 의미합니다 (예: "Push origin ↑2")

2

"Push origin" 버튼 클릭

상단의 "Push origin" 버튼 클릭 → GitHub 서버에 업로드 시작

인터넷 연결 속도에 따라 1~10초 소요됩니다

3

업로드 완료 확인

버튼이 "Push origin"에서 "Fetch origin"으로 바뀌면 업로드 완료!

✅ "Fetch origin · Last fetched just now" 메시지 확인

💡

TIP — Commit과 Push의 차이

Commit은 "내 컴퓨터에 저장", Push는 "인터넷 서버에 업로드"입니다. 오프라인에서는 Commit만 하고, 나중에 인터넷 연결 시 Push하면 됩니다. 여러 번 Commit 후 한 번에 Push해도 괜찮습니다.

1-4. Pull — 다른 기기에서 불러오기

다른 컴퓨터(맥미니 → 맥북에어 등)에서 GitHub에 올라간 최신 파일을 가져올 때 사용합니다.

1

GitHub Desktop 열기

다른 기기(맥북에어 등)에서 GitHub Desktop 실행

2

저장소 선택

좌측 상단에서 해당 저장소 선택

3

"Fetch origin" 클릭

상단 "Fetch origin" 버튼 클릭 → 서버에 새로운 내용이 있는지 확인

Fetch는 다운로드 없이 "확인만" 하는 단계입니다

4

"Pull origin" 클릭

"Pull origin" 버튼이 나타나면 클릭 → 최신 파일 다운로드 완료
이미 최신 상태면 버튼이 나타나지 않습니다

✅ Pull 완료 후 Cursor에서 파일을 열면 맥미니에서 작업한 최신 내용이 반영되어 있습니다

⚠️

중요 — 황금 규칙

다른 기기에서 작업 시작 전 항상 Pull을 먼저 해주세요! 그래야 최신 버전으로 작업할 수 있고 충돌을 방지할 수 있습니다.

CHAPTER 2

파일 편집 & 수정 관리

파일을 안전하게 수정하고, 실수 시 이전 버전으로 되돌리는 방법

2-1. 수정 작업 기본 루틴

파일을 수정할 때는 항상 아래 순서를 따르면 가장 안전합니다. 특히 큰 변경 작업 전에는 미리 Commit을 해두는 습관이 핵심입니다.

시점	행동	이유	예시
작업 전	현재 상태 Commit	복구 기준점 생성	Summary: "네비게이션 수정 전 백업"
작업 중	자유롭게 파일 수정	Cursor 등 편집기에서 편집	Cursor로 index.html 수정
작업 후	Commit + Push	저장 및 서버 업로드	Summary: "메인 배너 이미지 교체 완료"

2-2. 변경 내용 확인하기

파일을 수정하면 GitHub Desktop이 자동으로 감지하여 Changes 탭에 표시합니다. 파일을 클릭하면 무엇이 바뀌었는지 상세히 확인할 수 있습니다.

Changes 탭 — 변경된 파일 표시

3 changed files

+

images/products/banner_new.jpg

●

index.html

−

images/products/banner_old.jpg

아이콘	색상	의미	예시
+	초록색	새로 추가된 파일	새 이미지, 새 페이지 파일 추가
●	노란색	기존 파일이 수정됨	index.html 내용 변경
−	빨간색	삭제된 파일	사용하지 않는 이미지 삭제

💡

TIP — 파일 클릭하면 상세 변경 내용 확인 가능

Changes 탭에서 파일을 클릭하면 우측에 어떤 코드가 추가(초록)되고 삭제(빨간)되었는지 한눈에 볼 수 있습니다. 실수를 발견하기 좋은 기능입니다.

2-3. 수정 내용 되돌리기 (Discard Changes)

아직 Commit하지 않은 수정 내용을 취소하고 이전 상태로 되돌리는 방법입니다.

1

GitHub Desktop → Changes 탭

수정된 파일 목록 확인

2

파일 우클릭

되돌리고 싶은 파일에서 마우스 우클릭 (트랙패드: 두 손가락 클릭)

3

"Discard Changes" 선택

팝업 메뉴에서 "Discard Changes" 클릭

4

확인 버튼 클릭

확인 팝업에서 "Discard Changes" 클릭 → 해당 파일이 수정 전 상태로 복원됩니다

✅ Changes 탭에서 해당 파일이 사라지면 성공

🚨

경고 — 되돌릴 수 없음!

Discard Changes는 취소할 수 없습니다. Commit 전 수정 내용이 완전히 삭제됩니다. 신중하게 사용하세요. 확실하지 않다면 먼저 Commit을 해두고 나중에 판단하는 것이 더 안전합니다.

2-4. 이전 Commit으로 되돌리기 (Revert)

Commit을 완료한 후라도 이전 버전으로 되돌릴 수 있습니다. 이 기능이 GitHub의 가장 강력한 안전망입니다. 이전 히스토리는 그대로 유지됩니다.

1

History 탭 클릭

좌측 상단 "History" 탭 클릭 → 전체 Commit 목록 표시

2

되돌아갈 Commit 찾기

목록에서 되돌아가고 싶은 시점의 Commit 클릭

📋 Commit 메시지를 보고 어느 시점인지 확인합니다 (Summary를 잘 써두는 이유!)

3

우클릭 → "Revert this Commit"

선택한 Commit 우클릭 → 팝업에서 "Revert this Commit" 선택

4

Commit + Push

Changes 탭에 복원된 내용이 자동으로 표시됩니다 → Commit 후 Push하면 서버에도 반영

✅ Summary에는 "Revert: [원래 Commit 메시지]"가 자동 입력됩니다

💡

TIP — Revert vs Discard 차이

Discard Changes: Commit 전 수정 취소 (기록 없이 즉시 삭제)
Revert: Commit 완료 후 되돌리기 (히스토리에 "되돌림" 기록 남음, 안전함)

2-5. 특정 파일만 이전 버전으로 복구

전체를 되돌리지 않고 특정 파일 하나만 이전 버전으로 복구하고 싶을 때 사용합니다.

1

History 탭 → 원하는 Commit 클릭

복구하고 싶은 파일의 이전 버전이 있는 Commit을 찾아 클릭

2

우측 파일 목록에서 파일 우클릭

복구할 파일을 우클릭 → "Restore file at this commit" 선택

예시: products.html 파일만 3일 전 버전으로 복구

3

Commit + Push

복원된 파일이 Changes 탭에 표시됩니다 → Commit 후 Push

CHAPTER 3

히스토리 관리 & 버전 확인

언제 어떤 파일을 수정했는지 기록을 확인하고 관리하는 방법

3-1. History 탭 활용하기

GitHub Desktop의 History 탭은 지금까지 진행한 모든 Commit 기록을 시간 순으로 보여줍니다.

History 탭 — 전체 Commit 기록

W

제품 페이지 - 건기식 카테고리 이미지 추가

wowback · 2시간 전 · 5개 파일 변경

a3f8c21

W

홈페이지 메인 배너 이미지 교체

wowback · 어제 · 3개 파일 변경

b7d2e14

W

Contact 페이지 EmailJS 연결 설정

wowback · 3일 전 · 2개 파일 변경

c9f1a88

W

수정 전 백업 - 네비게이션 변경 예정

wowback · 5일 전 · 0개 파일 변경

e2b4d77

화면 요소	확인 가능한 정보
좌측 Commit 목록	Commit 메시지, 작성자(wowback), 작성 시간, 변경 파일 수
우측 상단 파일 목록	해당 Commit에서 변경된 파일들 목록
우측 하단 내용	각 파일의 구체적인 변경 내용 (초록=추가, 빨간=삭제)

3-2. GitHub 웹에서 상세 히스토리 확인

GitHub 웹사이트에서는 더 상세하고 시각적인 히스토리를 확인할 수 있습니다.

1

GitHub Desktop → "View on GitHub" 클릭

브라우저가 열리면서 저장소 페이지로 이동

2

상단 Commit 수 클릭

저장소 페이지에서 "XX commits" 텍스트 클릭 → 전체 Commit 히스토리 목록

예: "15 commits" 클릭

3

원하는 Commit 클릭

해당 시점의 상세 변경 내용 확인
초록색: 추가된 내용 / 빨간색: 삭제된 내용

4

특정 파일의 변경 이력만 보기

저장소에서 파일 클릭 → 우측 상단 "History" 버튼 → 해당 파일만의 변경 기록 전체 확인

예: index.html을 클릭 → History → index.html만 수정한 모든 Commit 확인

3-3. 효과적인 Commit 메시지 작성법

나중에 히스토리를 봤을 때 어떤 작업인지 바로 알 수 있도록 Commit 메시지를 구체적으로 작성하는 것이 중요합니다.

권장 형식: [페이지/기능] - [구체적인 작업 내용]

❌ 나쁨 수정

✅ 좋음 홈페이지 메인 배너 이미지 교체

❌ 나쁨 업데이트

✅ 좋음 제품 페이지 - 자동차 부품 카테고리 추가

❌ 나쁨 작업

✅ 좋음 Contact 페이지 - EmailJS 연결 설정 완료

❌ 나쁨 변경

✅ 좋음 푸터 - 회사 주소 및 전화번호 업데이트

❌ 나쁨 fix

✅ 좋음 모바일 반응형 - 네비게이션 메뉴 깨짐 수정

3-4. Commit 빈도 가이드

상황	Commit 권장 시점	Summary 예시
기능 하나 완성	완성 직후	"제품 상세 페이지 레이아웃 완성"
하루 작업 마무리	작업 종료 시	"2026-04-09 홈페이지 작업 저장"
큰 수정 전	수정 시작 전	"수정 전 백업 - 네비게이션 개편 예정"
문제 해결 후	해결 직후	"모바일 메뉴 버그 수정 완료"
외출 전	자리 비우기 전	"외출 전 임시 저장 - 제품 페이지 작업 중"

💡

TIP

잦은 Commit은 절대 나쁘지 않습니다! 오히려 자주 Commit할수록 더 촘촘한 안전망이 생깁니다. 부담 없이 작업할 때마다 Commit하는 습관을 만드세요.

CHAPTER 4

홈페이지 배포 (GitHub Pages)

pathfinder-homepage 저장소를 실제 웹사이트로 무료 배포하는 방법

4-1. GitHub Pages란?

GitHub Pages는 GitHub 저장소에 있는 HTML 파일을 그대로 웹사이트로 공개해주는 무료 서비스입니다. 별도의 서버 비용 없이 pathfinderinc.co 도메인으로 홈페이지를 운영할 수 있습니다.

🆓

완전 무료

Public 저장소 기준 서버 비용 0원. 트래픽 제한 없음.

🔄

Push 즉시 자동 반영

Push 후 1~3분이면 www.pathfinderinc.co 에서 변경사항 확인 가능

🌐

커스텀 도메인 연결

www.pathfinderinc.co 연결 가능. HTTPS 자동 설정.

📁

모든 파일 지원

HTML, CSS, JavaScript, 이미지, 동영상 등 모두 지원

ℹ️

배포 전 준비사항

현재 pathfinder-homepage 저장소는 Private(비공개) 상태입니다.
GitHub Pages 무료 배포를 위해 Public(공개)으로 변경이 필요합니다. (홈페이지 완성 후 진행)

4-2. 배포 준비 체크리스트

✓

index.html 파일이 pathfinder-homepage 폴더 바로 안에 있는지 확인

✓

비밀번호, API 키 등 민감한 정보가 코드에 노출되지 않았는지 확인

✓

모든 최신 작업이 Push 완료되었는지 확인

✓

홈페이지 완성도 확인 (미완성 상태로 배포 여부 결정)

4-3. 저장소 Public으로 변경

1

github.com → pathfinder-homepage 저장소

GitHub Desktop에서 "View on GitHub" 클릭

2

상단 "Settings" 탭 클릭

저장소 설정 페이지로 이동 (톱니바퀴 아이콘)

3

하단 "Danger Zone" 섹션

Settings 페이지 맨 아래로 스크롤 → 빨간색 "Danger Zone" 영역

4

"Change visibility" → "Change to public"

공개로 변경 선택

5

저장소 이름 입력 후 확인

입력란에 wowback/pathfinder-homepage 입력 → 확인 버튼 클릭

⚠️ Public 변경 후에는 코드가 인터넷에 공개됩니다

4-4. GitHub Pages 활성화

1

저장소 Settings → 좌측 "Pages" 클릭

좌측 메뉴에서 "Pages" 항목 클릭

2

Source: "Deploy from a branch" 선택

Build and deployment 섹션에서 Source 드롭다운 선택

3

Branch: "main" + "/" (root) 선택 → Save

main 브랜치, 루트 폴더(/)에서 배포

4

1~3분 후 배포 URL 확인

페이지 새로고침 → 상단에 배포된 URL 표시

🌐 https://wowback.github.io/pathfinder-homepage

4-5. 커스텀 도메인 연결 (www.pathfinderinc.co)

기본 URL 대신 실제 도메인을 연결하는 방법입니다. 두 단계로 진행됩니다.

1단계: GitHub Pages에 도메인 등록

1

Settings → Pages → Custom domain

"Custom domain" 입력란에 www.pathfinderinc.co 입력 후 Save

2

DNS 인증 대기

자동으로 도메인 소유권 확인이 진행됩니다

2단계: 도메인 DNS 설정 (도메인 구매처에서)

레코드 타입	호스트(Host)	값(Value)	설명
CNAME	www	wowback.github.io	www 도메인 연결
A	@	185.199.108.153	GitHub IP 1
A	@	185.199.109.153	GitHub IP 2
A	@	185.199.110.153	GitHub IP 3
A	@	185.199.111.153	GitHub IP 4

💡

TIP

DNS 설정 반영은 최대 24~48시간이 걸릴 수 있습니다. 설정 직후 접속이 안 되어도 정상입니다. 하루 후 다시 확인해 보세요.

4-6. 배포 후 홈페이지 업데이트 방법

GitHub Pages 배포 후 홈페이지를 수정하는 과정은 매우 간단합니다.

CHAPTER 5

두 기기 동기화

맥미니와 맥북에어에서 같은 프로젝트를 충돌 없이 작업하는 방법

5-1. 동기화 개념 이해

iCloud는 파일을 자동으로 동기화하지만, GitHub는 수동으로 Push/Pull을 해야 합니다.

🖥️

맥미니

작업 후 Push

↑ Push

업로드

☁️

GitHub 서버

최신 파일 보관

↓ Pull

다운로드

💻

맥북에어

Pull 후 작업

황금 규칙	설명	왜 중요한가?
작업 시작 전 Pull	어느 기기에서든 시작 전 항상 Pull 먼저	다른 기기의 최신 작업 반영
작업 완료 후 Push	작업이 끝나면 반드시 Commit + Push	다른 기기에서 최신 파일 사용 가능
동시 작업 금지	두 기기에서 같은 파일을 동시에 수정 금지	충돌(Conflict) 예방

5-2. 맥미니 → 맥북에어로 이어 작업하기

🖥️ 맥미니 — 작업 완료 후

GitHub Desktop 열기

Changes 탭에서 수정 파일 확인

Summary 입력 + "Commit to main" 클릭

"Push origin" 클릭 → 서버 업로드 완료 확인

💻 맥북에어 — 이어서 작업 시

GitHub Desktop 열기

저장소 선택

"Fetch origin" 클릭 → 서버 확인

"Pull origin" 클릭 → 최신 파일 다운로드

Cursor에서 작업 시작

5-3. 새 기기에서 처음 설정하기 (Clone)

새 컴퓨터 또는 초기화된 기기에서 GitHub 저장소를 처음 연결할 때 사용합니다.

1

GitHub Desktop 설치 및 로그인

desktop.github.com → 설치 → wowback 계정으로 로그인

2

시작 화면에서 저장소 선택

좌측 목록에 wowback/pathfinder-homepage, wowback/wowbook이 표시됨

3

Local Path 설정

"Choose..." 클릭 → 저장할 폴더 선택

권장 경로: Desktop/Sam.Baek/VibeCoding

4

"Clone" 버튼 클릭

GitHub 서버에서 모든 파일 다운로드 → 작업 가능 상태

✅ 이후에는 Push/Pull로만 관리하면 됩니다

5-4. 충돌(Conflict) 발생 시 대처법

두 기기에서 같은 파일을 동시에 수정하면 충돌이 발생할 수 있습니다. 당황하지 말고 아래 순서로 처리하세요.

충돌 발생 시 파일 내부 모습 (index.html 예시)

<<<<<<< HEAD (내 기기의 내용)

========================================

<h1>회사명 — Global Trade Partner</h1>

>>>>>>> origin/main (GitHub 서버의 내용)

1

충돌 파일 확인

GitHub Desktop에서 충돌 파일이 빨간색으로 표시됩니다

2

Cursor에서 충돌 파일 열기

충돌 파일을 편집기에서 열면 위와 같은 마커가 보입니다

3

유지할 내용 선택 후 마커 삭제

<<<<<<<, =======, >>>>>>> 기호를 모두 삭제하고, 두 버전 중 하나만 남깁니다

예: 한국어 버전 유지 → "회사명 — 한국 우수 제품 수출" 남기고 나머지 삭제

4

저장 → Commit → Push

파일 저장 후 GitHub Desktop에서 Commit + Push 완료

💡

충돌 예방법

충돌을 예방하는 가장 좋은 방법은 한 번에 한 기기에서만 작업하고, 작업 전후로 반드시 Pull/Push를 하는 것입니다. 두 기기를 동시에 열어두고 같은 파일을 수정하지 마세요.

APPENDIX

부록

핵심 용어 사전 · FAQ · 빠른 참조 카드

핵심 용어 사전

Repository
(저장소)

프로젝트 파일 전체를 담는 폴더. pathfinder-homepage와 wowbook이 각각 하나의 저장소입니다. GitHub에 업로드되는 단위입니다.

Commit

변경사항을 로컬 컴퓨터에 저장 기록하는 행위. 메모(Summary)와 함께 저장됩니다. 타임스탬프와 함께 영구 기록됩니다.

Push

로컬의 Commit 내용을 GitHub 서버(클라우드)에 업로드하는 것. 인터넷 연결이 필요합니다.

Pull

GitHub 서버에서 최신 내용을 로컬 컴퓨터로 다운로드하는 것. 다른 기기에서 작업한 내용을 가져올 때 사용합니다.

Fetch

서버에 새로운 변경사항이 있는지 확인만 하는 것 (다운로드는 안 함). Pull 전 상태 확인 단계.

Clone

GitHub 서버의 저장소를 로컬 컴퓨터로 처음 복사해 가져오는 것. 새 기기에서 처음 설정할 때 사용.

Branch
(브랜치)

독립적인 작업 공간. 실험적 기능을 안전하게 개발할 때 사용합니다. main은 기본 브랜치로 완성본이 저장됩니다.

Revert

특정 Commit을 취소하는 새 Commit을 생성하는 것. 기존 히스토리가 유지되어 안전하게 되돌릴 수 있습니다.

Discard
Changes

아직 Commit하지 않은 수정 내용을 취소하는 것. 되돌릴 수 없으므로 신중하게 사용해야 합니다.

.gitignore

GitHub에 올리지 않을 파일/폴더를 지정하는 설정 파일. node_modules 같은 불필요한 파일을 제외할 때 사용.

GitHub Pages

GitHub 저장소를 웹사이트로 무료 배포해주는 서비스. Push하면 자동으로 사이트가 업데이트됩니다.

Conflict
(충돌)

두 기기에서 같은 파일을 동시에 수정했을 때 발생하는 상황. 수동으로 해결해야 합니다.

자주 묻는 질문 (FAQ)

GitHub Desktop을 항상 켜두어야 하나요?

아니요. 작업 마무리 후 Commit + Push할 때만 열면 됩니다. 실시간으로 감시하는 앱이 아니라, 열 때마다 변경사항을 스캔하는 방식이라 항상 켜둘 필요가 없습니다.

Commit과 Push를 동시에 해야 하나요?

아닙니다. Commit만 해두고 나중에 몰아서 Push해도 됩니다. 오프라인 상태에서는 Commit만 하고, 인터넷 연결 후 Push하면 됩니다. 단, 다른 기기에서 최신 파일이 필요하다면 Push까지 완료해야 합니다.

파인더에서 파일을 삭제하면 GitHub에서도 삭제되나요?

자동으로 삭제되지 않습니다. 파인더에서 삭제 후 GitHub Desktop에서 Changes 탭을 보면 삭제된 파일이 빨간 마이너스(−)로 표시됩니다. 이 상태에서 Commit + Push해야 GitHub에도 반영됩니다. Push 전까지는 GitHub에 원본이 살아있어 복구 가능합니다.

node_modules 폴더는 왜 GitHub에 안 올리나요?

node_modules 폴더 안에는 수천~수만 개의 파일이 들어있어 업로드가 매우 느려지고 용량을 낭비합니다. package.json 파일만 있으면 "npm install" 명령어로 언제든 다시 설치할 수 있어서 GitHub에 올릴 필요가 없습니다. .gitignore에 Node를 설정하면 자동 제외됩니다.

Private와 Public 저장소의 차이는?

Private은 본인만 볼 수 있는 비공개 저장소, Public은 누구나 볼 수 있는 공개 저장소입니다. GitHub Pages 무료 배포는 Public 저장소에서만 가능합니다. 현재 pathfinder-homepage는 Private이므로 배포 시 Public으로 변경이 필요합니다.

실수로 잘못된 파일을 Push했어요. 어떻게 하나요?

History 탭에서 해당 Commit을 우클릭 → "Revert this Commit" 선택 후 다시 Push하면 됩니다. GitHub에는 모든 히스토리가 남으므로 언제든 이전 상태로 복구할 수 있습니다. Push를 했더라도 당황하지 마세요.

iCloud와 GitHub를 동시에 사용해도 되나요?

가능하지만 충돌 가능성이 있습니다. iCloud가 파일을 자동 동기화하는 도중 GitHub Desktop이 파일을 변경하면 예상치 못한 상황이 발생할 수 있습니다. GitHub를 주요 동기화 수단으로 사용하고, iCloud는 단순 백업 용도로만 활용하는 것을 권장합니다.

Commit 메시지를 영어로 써야 하나요?

아닙니다. 한국어로 작성해도 됩니다. 나중에 히스토리를 볼 때 본인이 이해할 수 있으면 됩니다. 오히려 구체적인 한국어 메시지가 더 도움이 됩니다. 예: "제품 페이지 - 건기식 카테고리 이미지 추가"

빠른 참조 카드 (Quick Reference)

💾

변경 저장 (Commit)

Summary 입력 후 "Commit to main" 버튼

☁️

서버 업로드 (Push)

"Push origin" 버튼 클릭

⬇️

서버 다운로드 (Pull)

Fetch 후 "Pull origin" 버튼 클릭

🔍

상태 확인 (Fetch)

"Fetch origin" 버튼 클릭

📋

히스토리 확인

좌측 "History" 탭 클릭

↩️

되돌리기 (Revert)

History → Commit 우클릭 → Revert

📁

파인더에서 열기

"Show in Finder" 버튼

🌐

GitHub 웹에서 열기

"View on GitHub" 버튼

✏️

Cursor에서 열기

"Open in Cursor" 버튼

🔄

저장소 전환

좌측 상단 "Current Repository" 클릭

GitHub 맞춤형 매뉴얼 | Samuel Baek | 2026년 4월

GitHub

목차

GitHub란 무엇인가?

핵심 용어 3가지 — 이것만 알면 80%!

GitHub Desktop 화면 구성

1-1. 기본 작업 흐름

1-2. Commit — 변경사항 로컬 저장

1-3. Push — GitHub 서버에 업로드

1-4. Pull — 다른 기기에서 불러오기

2-1. 수정 작업 기본 루틴

2-2. 변경 내용 확인하기

2-3. 수정 내용 되돌리기 (Discard Changes)

2-4. 이전 Commit으로 되돌리기 (Revert)

2-5. 특정 파일만 이전 버전으로 복구

3-1. History 탭 활용하기

3-2. GitHub 웹에서 상세 히스토리 확인

3-3. 효과적인 Commit 메시지 작성법

3-4. Commit 빈도 가이드

4-1. GitHub Pages란?

4-2. 배포 준비 체크리스트

4-3. 저장소 Public으로 변경

4-4. GitHub Pages 활성화

4-5. 커스텀 도메인 연결 (www.pathfinderinc.co)

4-6. 배포 후 홈페이지 업데이트 방법

5-1. 동기화 개념 이해

5-2. 맥미니 → 맥북에어로 이어 작업하기

5-3. 새 기기에서 처음 설정하기 (Clone)

5-4. 충돌(Conflict) 발생 시 대처법

핵심 용어 사전

자주 묻는 질문 (FAQ)

빠른 참조 카드 (Quick Reference)