git check-ignore -v可确认文件是否被忽略及生效规则：有输出表示被忽略并显示规则来源与行号，无输出则可能因文件已被跟踪，需加--no-index验证纯忽略逻辑。
直接用 git check-ignore -v 查路径，就能确认部署时哪些文件真被排除、哪条规则在起作用。
确认目标文件是否被忽略
进入项目根目录后，对部署中关键的排除项（比如日志目录、临时配置、构建产物）逐个检查：
-
检查单个文件：运行
git check-ignore -v logs/app.log，有输出说明被忽略，且会显示匹配的规则和所在 .gitignore 行号 -
检查整个目录：加尾部斜杠更准确，例如
git check-ignore -v dist/；若输出为空，说明该目录未被任何规则覆盖 -
批量验证多个路径：可一次传入多个路径，如
git check-ignore -v config/local.env dist/ logs/
区分“未忽略”是规则问题还是跟踪状态干扰
如果预期被忽略却没输出，常见原因是文件已被 Git 跟踪。此时需加 --no-index 跳过索引检查，只看纯忽略逻辑：
GitCode API Usage
下载
简单易用的 GitCode API SKILL，提供 CLI 和轻量级 Python SDK 两种调用方式，用于与 GitCode 的 REST API 进行交互。支持加密访问令牌、异步调用以及完善的类型提示。 - 文档：https://gitcode-api.readthedocs.io/ - PyPI 页面：https://pypi.org/project/gitcode-api - GitHub 仓库：https://github.com/Trenza1ore/GitCode-API
- 运行
git check-ignore -v --no-index config/local.env，若此时有输出，说明规则本身没问题，只是该文件之前被git add过 - 若仍无输出，问题就在规则语法、路径写法或 .gitignore 文件位置（比如误放在子目录而未生效）
覆盖多级来源的排除配置
自动化部署常涉及全局忽略（如 core.excludesFile）或仓库级 .git/info/exclude。详细模式（-v）会明确标出规则来源：
- 输出形如
/home/user/.gitignore:5:*.tmp→ 来自全局配置 - 输出形如
.git/info/exclude:2:build/→ 来自本地仓库专属忽略 - 输出形如
.gitignore:12:node_modules/→ 来自项目根目录的 .gitignore - 对照部署脚本中实际加载的忽略源，确保关键路径命中的是你预期的那个文件
集成到部署前校验流程
把检查逻辑写成简单脚本，作为 CI/CD 或部署前的守门步骤：
- 准备一个待验证路径列表（如
exclude_paths.txt），每行一个路径 - 执行
git check-ignore -v --no-index --stdin - 若输出行数与输入行数一致，说明全部命中忽略规则；若有空行，对应路径未被排除，可立即中断部署并告警
- 搭配
git status --ignored可辅助观察当前工作区中实际被忽略的文件集合
