Qt Creator 16.0.2社区版添加Git仓库后项目不显示的原因及恢复方法

可能的原因 #

• Qt Creator初始界面的项目列表依赖本地项目目录索引，创建Git仓库生成的.git文件夹，可能触发了Qt Creator对VCS仓库目录的自动忽略规则，导致项目未被纳入索引。
• 创建Git仓库过程中，可能意外修改了项目目录的权限，或者Qt Creator的项目索引缓存出现异常，导致项目无法被识别展示。

恢复方法 #

• 手动重新添加项目
  打开Qt Creator，点击菜单栏的File -> Open File or Project，定位到项目文件夹中的.pro（CMake项目则选CMakeLists.txt）文件并打开，项目会重新出现在初始界面的项目列表中。
• 刷新项目索引
  1. 打开Qt Creator，切换到左侧的Projects标签页。
  2. 在顶部的项目列表右侧，点击刷新图标（圆形箭头）触发索引更新，等待完成后检查初始列表是否恢复。
• 检查VCS相关设置
  进入Tools -> Options -> Version Control，确认Git配置正常，同时查看是否存在自动忽略VCS仓库目录的选项，若有可暂时关闭后重新索引。
• 清除Qt Creator缓存
  关闭Qt Creator，找到对应系统的缓存目录：
  • Windows：%APPDATA%\QtProject\QtCreator
  • macOS：~/Library/Application Support/QtProject/QtCreator
  • Linux：~/.config/QtProject/QtCreator
    删除缓存目录下ProjectExplorer或Index相关的文件夹，重启Qt Creator后它会重新扫描并索引本地项目。

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