학습 목표
- Git과 GitHub로 변경 기록 남기기의 역할과 적용 조건을 설명할 수 있다.
- git status로 기존 저장소와 변경사항을 먼저 확인하세요.
- GitHub의 빈 비공개 저장소를 연결하고 비밀이 없는지 확인한 뒤 업로드하세요.
사전 지식
앞선 커져도 이해하기 쉬운 프로젝트 구조를 먼저 읽으면 용어를 이해하기 쉽습니다. 이미 아는 내용이면 이 장부터 시작해도 됩니다.
개념 이해
Git은 작업의 저장 지점을 만들고 무엇이 달라졌는지 비교하는 도구입니다. AI 수정 전에 돌아갈 지점이 있으면 실패를 두려워하지 않고 작은 변경을 검토할 수 있습니다.
저장소·Commit·변경 이력
저장소는 파일과 기록의 묶음이고 커밋은 설명이 붙은 변경 묶음입니다. 저장만 한 파일은 커밋된 복구 지점과 다릅니다.
Branch·Pull Request·Merge
브랜치는 별도 작업 줄기, PR은 변경을 검토하는 요청, 머지는 검토한 기록을 합치는 일입니다. 작은 변경은 차이를 읽기 쉽습니다.
GitHub 연결
로컬 저장소와 원격 주소를 연결한 뒤 공개/비공개 범위를 확인합니다. 원격에 올리기 전 포함될 파일을 검토하세요.
복구와 충돌 해결
공유된 커밋은 되돌림 커밋으로 취소하는 방법을 우선 검토합니다. 충돌은 양쪽 의도를 이해해 합치고 기능을 다시 확인합니다. 무조건 한쪽 파일을 덮어쓰지 않습니다.
.gitignore와 비밀정보
환경 파일·키 파일·의존성·빌드 결과를 제외합니다. 이미 기록에 들어간 비밀은 ignore로 사라지지 않으므로 폐기·재발급과 기록 정리가 필요합니다.
실제 사용 사례
AI가 등록 폼을 고치기 전 커밋을 남기고 별도 브랜치에서 수정합니다. diff를 읽어 요청하지 않은 인증 설정이나 환경 파일 변경이 섞이지 않았는지 확인한 뒤 PR을 만드세요.
단계별 실습
실습은 운영 서비스가 아닌 별도 연습 프로젝트에서 진행하세요. 기존 파일이 있다면 변경 전 기록을 남깁니다.
- git status로 기존 저장소와 변경사항을 먼저 확인하세요.
- 새 연습 폴더에만 git init을 실행하고 .gitignore를 작성하세요.
- 필요한 파일만 add한 뒤 의미 있는 커밋을 남기세요.
- 브랜치를 만들고 변경 후 diff·log를 검토하세요.
- GitHub의 빈 비공개 저장소를 연결하고 비밀이 없는지 확인한 뒤 업로드하세요.
코드와 프롬프트
아래 코드는 Git이 설치된 로컬 저장소에서 읽기 전용으로 확인하는 환경의 예시입니다. 실제 프로젝트의 버전과 기존 구성을 확인한 뒤 필요한 부분만 적용하세요.
git status
git diff
git diff --cached
git log --oneline -5아래 요청에서 대괄호 부분을 내 프로젝트에 맞게 바꾼 뒤 AI 도구에 전달하세요.
현재 git status와 변경 diff를 읽고 [기능] 수정 전 보존할 지점을 제안해줘. 비밀정보와 생성 파일을 제외하고, 작은 브랜치·커밋·PR 단위와 충돌 발생 시 검토 절차를 설명해줘. 원격 업로드 전 포함 파일을 보여줘.자주 발생하는 문제와 해결
| 문제와 원인 | 해결 방법과 확인 기준 |
|---|---|
| git add .로 비밀까지 올림 | git diff --cached를 읽고 필요한 경로만 추가합니다. |
| 복구 중 팀 기록이 사라짐 | 공유 브랜치의 강제 덮어쓰기는 피하고 revert와 백업 지점을 검토합니다. |
핵심 요약
- AI 수정 전 기록을 남기고 이후 차이를 읽습니다.
- 공유와 복구 전에 비밀·동료 변경을 확인합니다.
완료 확인
참고자료
확인 기준일: 2026-10-20. 요금·사용 한도·제품 기능·설정 경로는 변경될 수 있으므로 작업 직전 공식 문서와 설치 버전을 확인하세요.