github/gitignore · Global/Windows.gitignore
Windows .gitignore 템플릿 해설
Windows.gitignore가 Thumbs.db, desktop.ini, $RECYCLE.BIN, 설치 패키지, 바로가기 파일을 무시하는 이유와 대소문자·전역 설정 주의점을 설명합니다.
Windows.gitignore는 Windows 탐색기와 셸이 폴더에 만드는 파일, 그리고 설치 패키지 형식을 막는다. 13줄 정도로 짧고, macOS 템플릿처럼 개인 전역 gitignore에 두기 좋은 템플릿이다.
Windows 파일 시스템은 대소문자를 구분하지 않지만 git은 기본적으로 패턴을 대소문자 구분으로 비교한다. 그래서 [Dd]esktop.ini처럼 두 가지 표기를 모두 적은 규칙이 있다.
규칙별 해설
| 패턴 | 무엇을, 왜 무시하나 |
|---|---|
Thumbs.dbThumbs.db:encryptableehthumbs.dbehthumbs_vista.db | 썸네일 캐시탐색기가 이미지 폴더에 만들던 썸네일 캐시다. Vista 이후로는 중앙 캐시를 쓰지만 네트워크 드라이브나 옛 설정에서는 여전히 생긴다. |
[Dd]esktop.ini | 폴더 설정폴더 아이콘과 표시 이름 같은 사용자 지정 정보를 담는 숨김 시스템 파일이다. |
$RECYCLE.BIN/ | 휴지통이동식 드라이브나 볼륨 루트에 생기는 휴지통 폴더다. 저장소를 드라이브 루트에 만들었을 때 걸린다. |
*.cab*.msi*.msix*.msm*.msp | 설치 패키지Windows Installer 패키지, 병합 모듈, 패치, 캐비닛 압축 파일이다. 빌드 결과나 배포 파일로 다룬다. |
*.lnk*.stackdump | 바로가기·덤프개인 바로가기 파일과 Cygwin·MSYS 프로그램이 비정상 종료할 때 남기는 덤프다. |
실무에서 주의할 점
core.ignorecase는 Windows·macOS에서 저장소를 만들면 보통true로 설정된다. 이때는 대소문자와 상관없이 일치하지만, Linux CI에서는 구분되므로 브래킷 표기가 안전하다. 패턴 테스터에서 core.ignorecase 옵션을 켜고 끄며 비교할 수 있다.- 설치 파일을 저장소에 꼭 넣어야 한다면(예: 드라이버 배포 저장소)
*.msi줄을 지우거나!installers/*.msi로 예외를 둔다. - Visual Studio 관련 파일은 VisualStudio 템플릿이 다룬다.
원본 템플릿
Windows.gitignore
# Windows thumbnail cache filesThumbs.dbThumbs.db:encryptableehthumbs.dbehthumbs_vista.db# Dump file*.stackdump# Folder config file[Dd]esktop.ini# Recycle Bin used on file shares$RECYCLE.BIN/# Windows Installer files*.cab*.msi*.msix*.msm*.msp# Windows shortcuts*.lnk
템플릿 출처: github/gitignore/Global/Windows.gitignore @356fd7b (2026-09-11) · CC0-1.0