编译QtCharts 5.12时<private/*.h>文件不存在错误求助

错误解决步骤 #

• 确认使用的qmake是Qt 5.12版本：打开命令行输入qmake -v，输出版本需为5.12.x，避免用错其他版本的qmake。
• 不要直接双击打开.pro文件编译，改用命令行操作：
  1. 进入QtCharts源码根目录（比如D:\QtProjects\qtcharts-5.12.0）
  2. 执行命令：qmake QT_CONFIG+=private_tests，这个参数会让qmake自动添加私有头文件的包含路径
  3. 之后执行nmake（Windows环境）或make（Linux/macOS）启动编译
• 若上述方法无效，可手动修改对应模块的.pro文件：在报错文件所在模块的.pro（比如src/charts/charts.pro）中添加一行：

  INCLUDEPATH += $$PWD/private
  

  再重新执行qmake和编译。

为什么需要private前缀 #

• Qt的头文件分两类：公共头文件供开发者调用，保证跨版本兼容性；私有头文件是Qt内部实现细节，仅用于模块内部或模块间交互，不对外公开，也不承诺版本兼容。
• QtCharts的核心实现代码依赖内部私有逻辑，因此需要包含private/前缀的头文件，这些文件通常放在源码的private子目录下。
• 正常Qt模块编译时，构建系统会自动处理私有头文件的路径，但单独编译QtCharts时需显式开启路径包含，否则编译器无法找到这些文件。

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