使用Qt5未更新代码却随机触发‘SkipEmptyParts’非Qt成员错误

核心原因 #

这个随机错误和代码本身无关，大概率是构建缓存异常、头文件依赖链混乱或Qt环境临时失效导致的。

具体解决步骤 #

• 清理构建缓存
  直接删除项目的构建目录（通常命名类似build-xxx-Desktop_Qt_5_xx_x_GCC_x64-Debug），然后重新执行qmake + 编译。缓存内的旧文件与当前环境冲突是这类奇怪错误的常见诱因。
• 确认头文件包含
  确保使用Qt::SkipEmptyParts的代码前，已正确引入<QString>或<QtCore>头文件。虽然Qt头文件多为间接包含，但编译单元依赖异常时可能导致头文件未被正确加载：

  // 必须提前包含
  #include <QString>
  

• 重启开发环境
  用Qt Creator的话直接重启IDE；命令行编译则关闭终端重新打开后再编译。系统其他操作可能临时打乱Qt环境变量，重启能重置恢复。
• 验证Qt版本配置
  检查项目构建套件（Kit）是否确实指向Qt5版本，避免误切换到Qt6（Qt6中该枚举被移至Qt::SplitBehaviorFlags下）。在Qt Creator中可通过工具->选项->构建和运行->套件查看当前项目的Qt版本。

兜底方案 #

若以上方法无效，可尝试删除Qt Creator的配置缓存（Windows路径：C:\Users\<你的用户名>\AppData\Roaming\QtProject；Linux路径：~/.config/QtProject），但此操作会重置IDE自定义设置，需谨慎执行。

内容的提问来源于stack exchange，提问作者Stefano Borzì