github/gitignore · Global/Windows.gitignore
Windows .gitignore 模板详解
说明 Windows.gitignore 忽略 Thumbs.db、desktop.ini、$RECYCLE.BIN、安装包和快捷方式文件的原因,以及大小写与全局设置的注意事项。
Windows.gitignore 拦截 Windows 资源管理器和 shell 在目录中生成的文件以及安装包格式。它只有约 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 包、合并模块、补丁以及 cabinet 压缩文件。应作为构建结果或发布文件处理。 |
*.lnk*.stackdump | 快捷方式与转储个人快捷方式文件,以及 Cygwin、MSYS 程序异常退出时留下的转储。 |
实践中的注意事项
- 在 Windows、macOS 上创建仓库时,
core.ignorecase通常被设为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