QGroundControl 中文枚举字符串解析问题分析与解决方案

问题背景

在QGroundControl无人机地面站系统的开发过程中，开发团队发现了一个与多语言支持相关的技术问题。具体表现为当系统加载包含中文枚举选项的JSON配置文件时，会出现字符串解析失败的情况，导致系统无法正确识别和显示这些枚举选项。

问题现象

系统日志中会出现类似以下警告信息：

警告: ":/json/APM-MavCmdInfoCommon.json" " enum strings/values count mismatch, label:'设置' enumStrings:'开启，关闭'"
警告: ":/json/MavCmdInfoCommon.json" "MAV_CMD_NAV_CONTINUE_AND_CHANGE_ALT enum strings/values count mismatch, label:'模式' enumStrings:'爬升、空档、下降'"

这些警告表明系统在解析包含中文逗号或顿号分隔的枚举字符串时遇到了困难，导致枚举值与对应的字符串数量不匹配。

技术分析

问题的根源在于QGroundControl的原始代码中，枚举字符串的分隔符处理逻辑过于简单。原始实现仅使用英文逗号作为分隔符：

paramInfo->_enumStrings = paramObject.value(_enumStringsJsonKey).toString().split(",", Qt::SkipEmptyParts);

这种实现方式无法正确处理中文环境下常见的多种分隔符形式，包括：

1. 中文全角逗号"，"
2. 中文顿号"、"
3. 斜杠"/"（虽然这不是标准分隔符，但在某些翻译中误用）

解决方案

针对这一问题，开发团队提出了改进方案，主要思路是扩展支持的分隔符类型，使其能够兼容多种语言环境下的常见分隔符。改进后的代码逻辑如下：

static const QStringList separators = {",", "、", "，"};
QString enumStr = paramObject.value(_enumStringsJsonKey).toString();
for (const QString& sep : separators) {
    if (enumStr.contains(sep)) {
        paramInfo->_enumStrings = enumStr.split(sep, Qt::SkipEmptyParts);
        break;
    }
}

或者使用正则表达式方式实现：

const QRegularExpression splitRegex("[,，、]");

实施建议

1. 代码审查：建议对所有涉及枚举字符串解析的代码进行全面检查，确保统一使用新的分隔符处理逻辑。

2. 翻译质量控制：虽然代码层面已经增强了兼容性，但仍建议在翻译管理流程中：

   • 统一规定使用标准分隔符
   • 避免使用斜杠等非标准分隔符
   • 建立翻译审核机制

3. 测试验证：在实施修复后，需要进行全面的多语言测试，特别是中文环境下的功能验证。

技术启示

这一案例展示了国际化软件开发中的典型挑战。在处理多语言支持时，开发人员需要考虑：

1. 文化差异：不同语言地区有不同的标点符号使用习惯。
2. 代码健壮性：核心逻辑应当具备足够的灵活性来适应各种语言环境。
3. 质量控制：建立完善的翻译审核流程，避免因翻译不当导致的程序异常。

通过这一问题的解决，QGroundControl的多语言支持能力得到了显著提升，为全球用户提供了更好的使用体验。这也为其他类似的开源项目提供了有价值的参考。