Git 忽略 .DS_Store 文件完整指南

来源：Gemini 3.1 Pro 对话，2026-07-01 链接：https://gemini.google.com/share/7916351c322c

问题场景

macOS 的 .DS_Store（Desktop Services Store）文件已被意外 commit 并 push 到远程仓库，需要删除并防止再次发生。

一、四步修复框架

Step 1 — 从 Git 中移除已跟踪的 .DS_Store（不删除本地文件）

find . -name ".DS_Store" -exec git rm --cached {} +
git commit -m "chore: remove .DS_Store files"
git push origin <branch>

git rm --cached：从 Git 索引（staging area）中删除，但保留物理文件。

Step 2 — 项目级防御

在项目 .gitignore 中添加 .DS_Store，提交并推送。

Step 3 — 全局防御（一次性修复所有项目）

echo ".DS_Store" >> ~/.gitignore_global
git config --global core.excludesfile ~/.gitignore_global

此后该 Mac 上所有 Git 项目自动忽略 .DS_Store。

Step 4 — 理解 Git 内部原理

• .gitignore 只影响未跟踪文件。一旦文件被 commit（跟踪状态），.gitignore 对其无效
• git rm --cached 强制剥夺文件的"跟踪"状态，使其回到"未跟踪"，此时 .gitignore 才生效

二、常见错误与解决

错误：fatal: pathspec './app/build/.DS_Store' did not match any files

原因：find 找到了物理文件，但 build/ 目录已在 .gitignore 中，Git 从未跟踪该文件——文件存在于磁盘但在 Git 索引中不存在。Git 被要求删除一个它不知道的文件，抛出 fatal 并终止整个批处理。

修复：添加 --ignore-unmatch 标志实现优雅降级：

find . -name ".DS_Store" -exec git rm --cached --ignore-unmatch {} +

错误：push 后远程文件仍然存在

原因：遗漏了 git commit 步骤。

三、Git 四空间模型（核心心智模型）

操作流向

git rm --cached  →  从 Index 移除
git commit       →  将移除固化为 Local Repo 的新快照
git push         →  将 Local Repo 快照同步到 Remote

没有 commit 就没有东西可 push——即使 Index 已被修改。

四、关键原则

1. .gitignore 命名误导——应理解为 .git-ignore-untracked-files，对已跟踪文件无效
2. --ignore-unmatch 是健壮性关键——当系统级工具（find）与 Git 工具（git rm）的"文件系统视图"不一致时，必须优雅降级
3. 全局 .gitignore 是最佳实践——一次性配置 ~/.gitignore_global 解决所有项目的 macOS 系统文件污染
4. .DS_Store 存储 Finder 视图偏好（图标位置、排序方式、文件夹背景色等），对代码逻辑无影响，但在跨平台协作和 CI/CD 中造成污染