Gitignore配置*.hcl忽略规则后如何放行.terraform.lock.hcl

问题根因 #

Git的.gitignore规则遵循从上到下优先级递增的匹配逻辑，你添加的!.terraform.lock.hcl规则失效，大概率是放在了*.hcl全局忽略规则的前面，被后续的*.hcl规则覆盖了；也有可能是文件此前已经被Git纳入忽略缓存，修改.gitignore后没有刷新缓存导致。

解决步骤 #

1. 调整.gitignore规则顺序
   将!.terraform.lock.hcl规则放在*.hcl规则的下方，确保否定规则优先级高于全局hcl文件忽略规则，修改后的对应配置段如下：

   # .hcl files from Terraform v0.14 and newer
   *.hcl
   !.terraform.lock.hcl
   

   如果你的项目中存在子目录内的.terraform.lock.hcl需要提交，可以将否定规则调整为!**/.terraform.lock.hcl适配全目录。

2. 清理Git缓存
   修改完.gitignore后需要清理Git的忽略缓存，让新规则生效，执行以下命令：

   git rm --cached --ignore-unmatch .terraform.lock.hcl
   

   参数--ignore-unmatch可以避免文件未被缓存时抛出错误。

3. 验证规则有效性
   执行以下命令检查.terraform.lock.hcl是否还被Git忽略：

   git check-ignore -v .terraform.lock.hcl
   

   如果命令无任何输出，说明规则已经生效，该文件不再被忽略。

4. 提交锁文件
   规则验证通过后，正常将文件加入暂存区提交即可：

   git add .terraform.lock.hcl
   git commit -m "feat: add Terraform dependency lock file"
   

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