写了 gitignore 还是不对：查出具体命中的规则与索引状态

生成文件写进了 .gitignore，git status 依然显示修改。另一个目录里的 README 写了取反规则，却还是找不到。先分别检查路径是否已进索引，以及 Git 能否遍历父目录。

1. 在临时仓库复现两种表现

保存为 ignore_lab.py，执行 python ignore_lab.py。

from pathlib import Path
import subprocess
from tempfile import TemporaryDirectory

with TemporaryDirectory() as tmp:
    root = Path(tmp)

    def git(*args, check=True):
        return subprocess.run(["git", *args], cwd=root, text=True,
                              capture_output=True, check=check)

    git("init", "-q")
    log = root / "tracked.log"
    log.write_text("old", encoding="utf-8")
    git("add", "tracked.log")
    log.write_text("new", encoding="utf-8")
    rules = root / ".gitignore"
    rules.write_text("*.log\nbuild/\n!build/README.md\n", encoding="utf-8")
    (root / "build").mkdir()
    (root / "build" / "README.md").touch()
    assert git("ls-files", "--", "tracked.log").stdout.strip() == "tracked.log"
    assert git("check-ignore", "--", "tracked.log", check=False).returncode == 1
    assert "*.log" in git("check-ignore", "-v", "--no-index", "--", "tracked.log").stdout
    print("tracked.log: already indexed; pattern matches only with --no-index")

    result = git("check-ignore", "-v", "--", "build/README.md").stdout
    assert "build/" in result and "!build/" not in result
    print("ignored parent: build/README.md excluded")
    rules.write_text("*.log\nbuild/*\n!build/README.md\n", encoding="utf-8")
    result = git("ls-files", "--others", "--exclude-standard").stdout.splitlines()
    assert "build/README.md" in result
    print("ignored children: build/README.md included")

本机实测输出如下。

tracked.log: already indexed; pattern matches only with --no-index
ignored parent: build/README.md excluded
ignored children: build/README.md included

2. 按索引状态选命令

Git 不会为了找例外规则而深入已排除的目录。只想留下某个直接子文件时，用 build/* 排除内容，再用取反规则包含它。若路径更深，各级父目录都必须可遍历。

决定停止跟踪某个文件时，可在确认后使用 git rm --cached -- 路径，并提交索引变化与忽略规则。历史中已有的文件内容仍可通过旧提交访问。

小结

先查索引，再查具体模式。对取反规则，从父目录逐级验证路径是否仍可遍历。

数据来源与检索时间

检索时间 2026-11-13。

核验说明

• 使用本机 Git 2.54.0.windows.1 在临时仓库复现。