使用Qt Creator时遇到错误“Project ERROR: Xcode not set up properly”的解决方案

最近我在macOS上首次安装了Qt 5.5，并使用Qt Creator开发。然而每次启动或打开项目时，都会遇到以下错误提示：

Project ERROR: Xcode not set up properly. You may need to confirm the license agreement by running /usr/bin/xcodebuild.

然后当我在终端执行 /usr/bin/xcodebuild 时，会得到如下错误信息：

xcode-select: error: tool 'xcodebuild' requires Xcode, but active developer directory '/Library/Developer/CommandLineTools' is a command line tools instance

经过调研和尝试，找到了几种解决方案，这里整理一下供大家参考。

解决方案

1. 配置xcode-select

当你安装了完整的Xcode之后（而不仅仅是命令行工具），你需要指向正确的开发者目录并接受许可协议：

sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -license

接受许可协议后再次尝试打开Qt Creator项目，看是否解决了问题。

2. 修改Qt配置文件（适用于Xcode 8及以上版本）

如果你正在使用Xcode 8及以上版本，需要修改Qt的配置文件，让它查找xcodebuild而不是xcrun：

打开文件 Qt_install_folder/5.7/clang_64/mkspecs/features/mac/default_pre.prf，然后将：

isEmpty($$list($$system("/usr/bin/xcrun -find xcrun 2>/dev/null")))

替换为：

isEmpty($$list($$system("/usr/bin/xcrun -find xcodebuild 2>/dev/null")))

3. 创建符号链接（不推荐）

另一种方式是为xcodebuild创建一个符号链接xcrun，这样你就不需要更改任何配置文件：

cd /Applications/Xcode.app/Contents/Developer/usr/bin/
sudo ln -s xcodebuild xcrun

虽然这种方法简单，但它可能会在后续操作中引发其他问题，因为xcrun和xcodebuild不是完全相同的命令。

4. 安装完整版本的Xcode并重置Command Line Tools

有些情况下，你可能需要重置Command Line Tools的位置：

xcode-select --reset

完成上述操作后，尝试重新启动Qt Creator并加载你的项目。

5. 直接注释掉xcrun检查

如果以上方法仍然无效，可以直接注释掉配置文件中的xcrun检查行：

打开文件 Qt_install_folder/5.7/clang_64/mkspecs/features/mac/default_pre.prf 并注释如下内容：

# Make sure Xcode is set up properly
#isEmpty($$list($$system("/usr/bin/xcrun -find xcrun 2>/dev/null"))): \
    #error("Xcode not set up properly. You may need to confirm the license agreement by running /usr/bin/xcodebuild.")

这种方法是最后的手段，仅在其他所有方法均无效时使用。

以上就是解决“Project ERROR: Xcode not set up properly”错误的几种方法。希望对你有所帮助！如果你有其他更好的解决方法，欢迎在评论区分享。

总结

在macOS上使用Qt Creator开发时，可能会由于Xcode配置问题遇到各种错误。通过配置xcode-select，修改Qt配置文件或者重置Command Line Tools的位置，大多数情况下可以解决这些问题。如果问题依然存在，可以尝试直接注释相关检查步骤。