Ubuntu环境下如何在Qt的QSettings中正确读取非拉丁字符？

我之前也碰到过类似的坑，在Ubuntu环境里用QSettings读俄文这类非拉丁字符时，经常出现像"Ð\224адад"这样的乱码，本质就是编码不匹配搞的鬼。下面是几个亲测有效的解决步骤：

1. 给QSettings显式指定UTF-8编码 #

QSettings在Linux下处理INI文件时，默认编码不会自动适配UTF-8的非拉丁字符，所以必须手动指定编码。初始化QSettings后，调用setIniCodec()方法明确设置UTF-8：

// 初始化自定义INI配置文件
QSettings settings("/path/to/your/config.ini", QSettings::IniFormat);
// 关键操作：强制用UTF-8编码解析文件
settings.setIniCodec("UTF-8");

// 读取俄文值
QString russianText = settings.value("your_key").toString();

这一步能确保QSettings以正确的编码解析配置文件里的非拉丁字符，从根源避免乱码。

2. 确保配置文件本身是UTF-8编码 #

如果你的配置文件是从Windows迁移过来的，或者之前用其他工具保存时用了非UTF-8编码（比如Windows-1251），就算QSettings设置了编码也会乱码。可以在Ubuntu下用命令检查和转换：

• 检查文件编码：

  file /path/to/your/config.ini
  

  如果输出里没有"UTF-8"字样，说明需要转换编码。

• 将文件转换为UTF-8（假设原编码是Windows-1251）：

  iconv -f WINDOWS-1251 -t UTF-8 /path/to/old.ini > /path/to/new_utf8.ini
  

之后用转换后的UTF-8版本文件读取即可。

3. 写入配置时保持编码一致 #

如果是你自己的程序写入配置文件，记得写入时也要设置相同的UTF-8编码，这样后续读取才不会出问题：

QSettings settings("/path/to/your/config.ini", QSettings::IniFormat);
settings.setIniCodec("UTF-8");
// 写入俄文内容
settings.setValue("your_key", QStringLiteral("Привет мир!"));
settings.sync(); // 确保写入立即生效

额外提醒 #

如果你的程序是读取系统级配置（比如~/.config下的NativeFormat配置），Ubuntu系统默认是UTF-8编码，一般不需要额外设置，但如果还是出现乱码，同样可以尝试显式指定编码排查问题。

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