Qt Git 忽略 CMakeLists.txt.user 文件失效的解决方法

Qt Git 忽略 CMakeLists.txt.user 文件失效的解决方法

在使用 Qt 开发项目时，常常会使用 CMakeLists.txt.user 文件来存储一些用户自定义的配置信息。然而，有时我们会发现，即使在 .gitignore 文件中添加了 CMakeLists.txt.user 文件的忽略规则，该文件仍然会被 Git 跟踪。

原因：

这可能是因为该文件已经被提交到了 Git 的历史记录中。即使在 .gitignore 中添加了该文件的忽略规则，也无法忽略该文件。

解决方法：

1. 从 Git 的历史记录中删除该文件：

   可以使用以下命令删除该文件的历史记录，其中 <commit-hash> 是该文件最后一次提交的 commit 哈希值：

   git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch path/to/CMakeLists.txt.user' --prune-empty --tag-name-filter cat -- --all
   

2. 将该文件添加到 .gitignore 中：

   在项目根目录下的 .gitignore 文件中添加以下内容：

   path/to/CMakeLists.txt.user
   

3. 提交 .gitignore 文件的修改：

   使用以下命令提交 .gitignore 文件的修改。

   git add .gitignore
   git commit -m 'Add CMakeLists.txt.user to .gitignore'
   

注意：

执行第一步操作会修改本地仓库的历史记录，因此需要谨慎操作，并确保没有其他人在该仓库上进行操作。如果该仓库已经被其他人使用，建议使用其他方法来解决该问题。