如何在.gitignore中忽略精确文件名（不含子串）并配置特定文件规则

关于.gitignore精确匹配与敏感文件忽略的解决方案 #

一、精确匹配文件名（不匹配子字符串/子目录同名文件） #

先澄清一个Git匹配规则的小细节：不带通配符的文件名默认就是精确匹配文件名本身，不会匹配包含该字符串的其他文件（比如写passwords.txt不会匹配old_passwords.txt）。但它会匹配所有目录下的同名文件，如果你只想锁定某个特定位置的文件，就要加上路径前缀：

• 要精确匹配根目录下的config.ini（不会忽略子目录里的同名文件）：

  /config.ini
  

  开头的/限定了仅匹配根目录的目标文件。

• 要精确匹配secrets目录下的passwords.txt（也就是你第二个问题里的场景）：

  secrets/passwords.txt
  

  这个规则只会命中secrets文件夹下的该文件，既不会影响其他目录的同名文件，也不会匹配带后缀的模板文件。

• 如果文件名包含特殊字符（比如[或]），可以用反斜杠转义：

  /config\[prod\].ini
  

二、忽略敏感文件但保留模板文件 #

针对你的需求：忽略secrets/passwords.txt，但保留并上传secrets/passwords.txt.template，操作非常简单：

1. 添加.gitignore规则：
   直接在.gitignore文件里写一行：

   secrets/passwords.txt
   

   这个规则只会忽略指定路径下的敏感文件，完全不会干扰同名但后缀不同的模板文件，模板文件可以正常被Git追踪、提交和上传。

2. 已提交敏感文件的补救操作：
   如果你之前不小心把secrets/passwords.txt提交到了仓库，需要先移除它的Git追踪（不会删除本地文件）：

   git rm --cached secrets/passwords.txt
   

   然后提交这个变更：

   git commit -m "Stop tracking sensitive passwords.txt file"
   

额外提醒：全局通配符冲突处理

如果你的.gitignore里有*.txt这种全局忽略所有txt文件的规则，需要添加反向规则来排除模板文件：

*.txt
!*.txt.template  # 排除所有模板文件
# 或者更精确地只锁定你的目标模板：
!secrets/passwords.txt.template

不过一般场景下不需要这一步，除非你有全局忽略txt文件的特殊需求。

内容的提问来源于stack exchange，提问作者GMe