← 공개 라이브러리
로컬 개발 사전 점검
by MASTER
새로운 개발 작업을 시작하기 전에 로컬 브랜치 상태, 의존성 설치 여부, 테스트 통과 여부를 빠르게 확인하는 절차입니다. 작업 시작 직전에 실행하세요.
내용 미리보기
로컬 개발 사전 점검
새로운 개발 작업을 시작하기 전에 로컬 브랜치 상태, 의존성 설치 여부, 테스트 통과 여부를 빠르게 확인하는 절차입니다. 작업 시작 직전에 실행하세요.
⏱ 30분 ★ 보통
현재
현재 로컬 저장소에 작업 브랜치가 원격과 동기화되어 있지 않고 의존성 설치 상태와 테스트 통과 여부가 확인되지 않은 상태입니다.
난관
git rebase나 merge 중 충돌이 발생해 수동으로 파일을 수정해야 할 수 있습니다. package-lock 또는 pip 버전 차이로 의존성 설치가 실패하거나 로컬 환경 변수 누락으로 테스트가 실패할 수 있습니다.
기대
로컬 브랜치가 원격 기준으로 정리되어 있고 필요한 의존성이 설치되어 있으며 모든 단위테스트가 통과된 상태가 됩니다.
도구
- • 터미널 — 1
- • git — 1
- • 패키지 매니저 — 1
- • 테스트 러너 — 1
단계
- 01 브랜치 상태 확인git fetch origin을 실행한 뒤 git branch -vv와 git status로 현재 브랜치, 추적 관계, 로컬 변경사항을 확인합니다.⏱ 5분
- 02 원격 동기화 및 충돌 해결작업 브랜치에서 git rebase origin/main(또는 기본 브랜치) 또는 git merge를 실행해 원격 변경을 반영하고, 충돌 파일을 편집해 git add와 git rebase --continue 또는 커밋으로 마무리합니다.⏱ 10분
- 03 의존성 설치·검증패키지 매니저(npm ci 또는 pip install -r requirements.txt 등)로 의존성을 설치하거나 재설치하고 package-lock.json/Pipfile.lock 변경을 확인합니다.⏱ 10분
- 04 테스트 실행 및 실패 원인 진단테스트 러너로 유닛·통합 테스트를 실행하고 실패한 테스트는 로그와 환경변수로 재현해 환경변수를 설정하거나 테스트 명령을 재실행해 원인을 확인합니다.⏱ 5분