Qt Creator添加槽函数报错：找不到ui_textfinder.h（macOS安装包版）

问题根源 #

官方安装包的Qt Creator可能因UI文件生成逻辑、项目索引或构建配置差异，导致goto-slot功能错误寻找ui_textfinder.h，而非教程指定的textfinder.h。

具体解决步骤 #

1. 检查项目配置文件 #

• 打开项目的.pro文件，确认存在FORMS += textfinder.ui（CMake项目需确保qt_add_executable包含.ui文件，或用qt_wrap_ui处理）。这是qmake/uic生成ui_textfinder.h的核心前提。

2. 强制重新构建项目 #

• 点击Qt Creator顶部菜单栏的构建 -> 重新构建项目（或快捷键Cmd+Shift+B）。这会触发uic工具重新生成ui_textfinder.h，文件会出现在项目的构建目录中（如build-TextFinder-Desktop_Qt_6_7_2_clang_64bit-Debug/下）。
• 构建完成后回到Designer，再次尝试goto-slot，此时Creator应该能正确关联到textfinder.h。

3. 修复项目索引 #

• 若重新构建后仍报错，点击工具 -> C++ -> 重新解析项目，或关闭项目后重新打开，让Creator重新扫描所有文件及构建目录。
• 同时检查项目面板的「构建目录」路径是否正确，确保Creator能正常访问该目录下的生成文件。

4. 删除手动创建的符号链接 #

• 之前手动建立的ui_textfinder.h符号链接会干扰自动生成逻辑，务必删除，让uic自动生成正确的文件。

5. 重建项目（终极方案） #

如果以上方法均无效，直接重建项目：

• 备份当前项目的textfinder.ui、textfinder.h、textfinder.cpp、main.cpp文件。
• 打开Qt Creator，新建「Qt Widgets Application」项目，命名为TextFinder，选择Qt 6.7.2版本。
• 用备份文件替换新项目中的对应文件（保留新项目的.pro/CMakeLists.txt，避免配置冲突）。
• 重新构建项目后再尝试goto-slot功能。

6. 排查官方安装包的环境问题 #

• 避免将项目放在macOS权限受限目录（如/Applications、~/Library），移至~/Documents等普通目录。
• 若开启了影子构建，可临时关闭（项目面板 -> 构建步骤 -> 取消勾选「影子构建」），测试是否解决问题。

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