适用范围与准备
适用于本地文件确实存在,但 git status 没显示它,提交后远端仍没有该文件。先确认工作区与目标分支;本篇只排查本应纳入版本控制的普通示例文件,真实订阅、凭据和个人配置不应为了“同步成功”而强行提交。
先区分原因
Git 的忽略规则可来自当前或上级 .gitignore、仓库私有 exclude 文件及全局 excludesFile。某个文件被忽略不代表被删除;已跟踪文件也不会因新增忽略规则就自动停止跟踪。先确定状态,再找规则来源。
按顺序操作
- 在仓库中运行 git rev-parse --show-toplevel,确认不是另一个嵌套仓库。将命令中的 config.example.yaml 替换为缺失文件的真实相对路径,并保留 -- 分隔符。
- 先查看 git ls-files 的结果,再运行 git check-ignore -v。后者会报告匹配规则、文件及行号;输出以 ! 开头的否定规则时要按其语义理解,不能把任何有输出的结果都当成“仍被忽略”。
- 未匹配时 check-ignore 可返回非零退出状态;这与命令参数错误不同,应一起看 stderr。已跟踪文件通常不会被普通检查报告;需要研究规则本身时可额外用 --no-index,但它不会改变文件的实际跟踪状态。
- 确认文件没有秘密且确需共享后,只调整必要的那条规则或加入适当例外。若父目录整体被忽略,仅给子文件加 ! 规则可能无效,需要同时审查父目录规则;不要清空全局忽略文件。
- 先看 git add --dry-run -- 路径的结果,再按正常审查流程暂存单个文件并检查 git diff --cached。不要使用 git add -f . 批量强制添加,发现凭据时应保留忽略规则并改用脱敏示例。
git rev-parse --show-toplevel
git ls-files -- config.example.yaml
git check-ignore -v -- config.example.yaml
git status --short --untracked-files=all -- config.example.yaml
git add --dry-run -- config.example.yaml怎样确认有效
确认预期的示例文件进入本次暂存差异,内容经过审查;提交后再核对对应提交确实包含它。远端是否出现该文件还取决于后续推送的仓库和分支,不能把本地 add 成功当成远端交付完成。
无效时恢复与下一步
若调整规则影响了其他文件,恢复原规则并重新检查暂存区。需要撤销误暂存时按仓库正常流程取消暂存,不删除工作文件。真实秘密已经进入提交历史时,简单增加 .gitignore 不能消除泄露,应按凭据轮换和仓库处置流程处理。