macOS下Qt Creator编译报错：ld: library not found for -lQt5Widgets_debug

你遇到的这个链接错误，本质是Debug构建模式下，系统找不到Qt5Widgets库的Debug版本文件，结合你的环境（macOS 10.13.2、Xcode9.2、Qt5.10.0），我给你几个可行的解决步骤：

1. 检查Qt安装是否包含Debug组件 #

Qt安装器默认可能不会自动安装Debug版本的库，你可以通过Qt维护工具补装：

• 找到Qt安装目录下的MaintenanceTool.app（通常在~/Qt/MaintenanceTool.app），运行它
• 选择「Add or remove components」，展开Qt 5.10.0的条目，确保勾选macOS分类下的Debug Libraries选项，然后完成安装流程。

2. 验证Qt Creator的Kit配置 #

有时候Creator的构建套件（Kit）没有正确关联到带Debug库的Qt版本：

• 打开Qt Creator，点击顶部菜单的Qt Creator > Preferences（或者Edit > Preferences）
• 切换到Kits标签页，找到你当前使用的Kit（一般是Desktop Qt 5.10.0 clang 64bit）
• 点击Details，检查Qt Version指向的路径是否正确，并且该路径下的lib文件夹里存在libQt5Widgets_debug.dylib（路径示例：~/Qt/5.10.0/clang_64/lib/）
• 如果路径错误，点击Manage按钮添加正确的Qt版本，再重新关联到这个Kit。

3. 临时方案：强制使用Release库（不推荐长期用） #

如果暂时不想补装Debug库，可以修改项目的.pro文件，让Debug构建也使用Release版本的库：
在.pro文件末尾添加以下代码：

CONFIG -= debug
CONFIG += release

这种方法会丢失Debug模式的调试能力，只适合临时验证代码功能，建议还是优先补装Debug组件。

4. 清理后重新构建 #

不管用哪种方法，都记得先清理项目缓存再重新编译：

• 点击左侧的Projects选项卡，在Build部分点击Clean All
• 然后点击Build按钮（或按Cmd+B）重新构建项目。

另外提个小建议：你的代码里直接创建了QTextEdit并显示，但项目本身包含Widget类，其实可以把QTextEdit添加到Widget中显示，这样结构更符合Qt项目的常规写法，但这和当前的编译报错无关~

内容的提问来源于stack exchange，提问作者Yoshiki.M