编译KSyntaxHighlighting遇QChar/QString运算符错误求助

编译错误信息 #

错误1：QChar的operator+歧义 #

/home/igor/Work/Tmp/ksyntaxhighlighting/src/highlightingdata.cpp:144: error: ambiguous overload for ‘operator+’ (operand types are ‘QChar’ and ‘QChar’)
/home/igor/Work/Tmp/ksyntaxhighlighting/src/highlightingdata.cpp: In function ‘bool loadRule(const QString&, KSyntaxHighlighting::HighlightingContextData::Rule&, QXmlStreamReader&)’:
/home/igor/Work/Tmp/ksyntaxhighlighting/src/highlightingdata.cpp:144:61: error: ambiguous overload for ‘operator+’ (operand types are ‘QChar’ and ‘QChar’)
  144 |                 initRuleData(rule.data.anyChar, c.toLower() + c.toUpper());
      |                                                 ~~~~~~~~~~~ ^ ~~~~~~~~~~~
      |                                                          |             |
      |                                                          QChar         QChar

错误2：QLatin1Char与QString的operator%无匹配 #

/home/igor/Work/Tmp/ksyntaxhighlighting/src/ansihighlighter.cpp:973: error: no match for ‘operator%’ (operand types are ‘QLatin1Char’ and ‘QString’)
/home/igor/Work/Tmp/ksyntaxhighlighting/src/ansihighlighter.cpp: In member function ‘QString {anonymous}::DebugSyntaxHighlighter::extractContextName(KSyntaxHighlighting::StateData*) const’:
/home/igor/Work/Tmp/ksyntaxhighlighting/src/ansihighlighter.cpp:973:39: error: no match for ‘operator%’ (operand types are ‘QLatin1Char’ and ‘QString’)
  973 |             label += QLatin1Char('(') % QString::number(stateData->size()) % QLatin1Char(')');
      |                      ~~~~~~~~~~~~~~~~ ^ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      |                      |                                 |
      |                      QLatin1Char                       QString

运算符来源与定义位置 #

这两个运算符都不是Qt标准库原生提供的，而是KSyntaxHighlighting项目为简化代码逻辑自定义的重载：

• QChar的operator+：通常定义在项目内部头文件（如highlightingdata.h或通用工具头），实现对应在同名.cpp文件中，作用是将两个单个字符拼接成字符串。
• QLatin1Char与QString的operator%：定义在项目工具类头文件（如ansihighlighter.h或相关工具头），实现对应在.cpp文件中，用于简化字符与字符串的格式化拼接。

导致错误的可能因素 #

针对QChar operator+歧义 #

• 项目中存在多个operator+重载版本（比如一个返回QString，另一个返回自定义类型），编译器无法确定最优匹配。
• 简化构建流程时，遗漏了包含重载定义的头文件，或编译选项变更导致部分重载未被正确识别。

针对QLatin1Char与QString operator%无匹配 #

• 构建流程简化时，移除了包含该自定义重载的头文件，或重载的实现文件未被纳入编译范围。
• 编译选项变更（如Qt模块依赖未正确链接、项目预定义宏被修改），导致自定义重载的代码未被编译生效。
• 项目代码存在条件编译逻辑，某些宏未定义时该重载不会启用，而你的简化构建恰好触发了这个条件。

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