为何QLocale::codeToTerritory仅支持两位ISO3166码？3位及数字码无效

我需要通过任意ISO 3166国家代码获取国家名称，当前项目使用三位字母代码。根据Qt文档，QLocale::countryToTerritory应该能解决这个问题，但测试后发现该函数仅支持两位字母代码；尝试已废弃的codeToCountry函数，结果一致；数字代码也无法得到有效结果。

测试代码 #

#include <QCoreApplication>
#include <QLocale>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QString l2 = "DE";
    QString l3 = "DEU";
    QString d3 = "276";

    qDebug() << QLocale::codeToCountry(l2) << QLocale::codeToCountry(l3) << QLocale::codeToCountry(d3);
    qDebug() << QLocale::codeToTerritory(l2) << QLocale::codeToTerritory(l3) << QLocale::codeToTerritory(d3);

    return a.exec();
}

输出结果 #

QLocale::Germany QLocale::AnyTerritory QLocale::AnyTerritory
QLocale::Germany QLocale::AnyTerritory QLocale::AnyTerritory

测试多个不同国家代码后结果一致，项目环境为Windows系统下的Qt 6.3.0 + MSVC2019编译器。请问是文档错误，还是我遗漏了某些操作？

原因分析 #

Qt的QLocale::codeToTerritory和废弃的codeToCountry函数确实仅支持ISO 3166-1 alpha-2（两位字母）代码，文档存在表述模糊的问题。Qt官方实现中，这两个函数没有处理三位字母或数字代码的逻辑。

解决方案 #

如果需要解析三位字母/数字的ISO 3166代码，可以通过以下两种方式实现：

• 手动维护映射表
  创建包含ISO 3166所有代码（alpha-2、alpha-3、数字）与QLocale::Territory枚举的映射，示例：

  QHash<QString, QLocale::Territory> iso3166Map = {
      {"DE", QLocale::Germany},
      {"DEU", QLocale::Germany},
      {"276", QLocale::Germany},
      // 补充其他国家代码...
  };
  

  这种方式简单直接，适合代码量不大的场景。

• 利用ICU库扩展
  Qt底层依赖ICU库处理国际化，可直接调用ICU API解析三位代码：

  #include <unicode/uloc.h>
  
  QLocale::Territory territoryFromISO3(const QString &code) {
      char alpha2[3];
      UErrorCode status = U_ZERO_ERROR;
      uloc_getAlpha2Code(code.toUtf8().constData(), alpha2, 3, &status);
      if (U_SUCCESS(status)) {
          return QLocale::codeToTerritory(QString::fromLatin1(alpha2));
      }
      return QLocale::AnyTerritory;
  }
  

  注意：Qt默认已链接ICU库，自定义构建时需确认配置是否正确。

内容的提问来源于stack exchange，提问作者Hajdu Gábor