.gitignore 기본
개발 문서 폴더(docs/, **/docs/)·비밀값·빌드 산출물을 처음부터 저장소에서 제외한다.
필수 항목
프로젝트를 만들 때 .gitignore 에 반드시 다음을 넣습니다.
# 개발 문서 (요청 메모·PRD·todo 등) — 루트와 하위 폴더 모두
docs/
**/docs/
| 항목 | 왜 |
|---|---|
docs/ | 루트의 개발 문서 폴더(요청 메모, 기획, 할 일 등)는 개인·팀 작업 문서라 코드 저장소에 섞지 않는다 |
**/docs/ | backend/docs/, frontend/docs/ 처럼 하위 폴더 안의 문서 폴더도 재귀적으로 제외 |
저장소가 문서 자체를 관리하는 용도(예: 프로토콜 계약 저장소, 이 문서 사이트)라면 이 규칙의 예외입니다. 그 경우 README 에 예외임을 적습니다.
권장 항목 (Node.js / Next.js / NestJS)
# 의존성
node_modules/
# 빌드 산출물
dist/
build/
.next/
out/
coverage/
# 환경변수·비밀값
.env
.env.*
!.env.example
# 로그
logs/
*.log
# OS·편집기
.DS_Store
Thumbs.db
.vscode/
.idea/
.env.example처럼 비밀값 칸을 비운 견본은 예외로 포함시켜, 어떤 값이 필요한지 알 수 있게 합니다.- 키 파일(
*.pem,*.key, 서명 키스토어 등)은 프로젝트에 맞게 추가합니다.
Windows 에서 nul 파일 오류
Windows 에서 git add / git commit 중 nul 관련 오류가 나면, 작업 폴더에 실수로 생긴 nul·NUL 파일이 원인인 경우가 많습니다. 해당 파일을 지운 뒤 다시 진행합니다.
rm nul
왜 — Windows 에서
> nul리다이렉트를 POSIX 셸에서 쓰면nul이라는 이름의 실제 파일이 생기고, 이 이름은 Windows 예약어라 git 이 처리하지 못합니다.