Qt读取配置文件最省心的做法是优先使用QSettings操作ini文件，指定好组织名和应用名，读取前用QFile::exists判断路径是否存在，编码统一设为UTF-8，这样做能避开大多数路径错误和中文乱码问题。
Qt读取ini配置文件示例：从创建到解析的完整流程
ini文件是Qt配置存储里最常见的选择，QSettings天生支持ini格式，如果你只想存个窗口大小、最近打开的文件列表或用户偏好，不需要引入JSON或XML,QSettings几行代码就能完成读写。
写入配置的典型写法如下：
QSettings settings("MyCompany", "MyApp");
settings.setValue("Window/width", 1280);
settings.setValue("Window/height", 720);
settings.setValue("Paths/lastOpen", "/home/user/docs");
这里组织名是MyCompany，应用名是MyApp，Qt会在系统标准配置目录生成配置文件，在Windows下，如果指定ini格式，通常会写到用户配置目录；在Linux下一般出现在~/.config路径里。
读取配置同样简单：
QSettings settings("MyCompany", "MyApp");
int width = settings.value("Window/width", 1024).toInt();
int height = settings.value("Window/height", 768).toInt();
QString last = settings.value("Paths/lastOpen", "").toString();
每个value方法第二个参数是默认值，读取不到对应键时，不会报错，直接返回默认值,这个机制对业务容错很有用。
直接指定ini文件路径
有时你不想依赖组织名和应用名，希望配置文件就放在程序旁边,可以这样创建QSettings：
QSettings settings("config.ini", QSettings::IniFormat);
settings.setValue("Serial/port", "COM3");
settings.setValue("Serial/baud", 9600);
这种写法会生成一个名为config.ini的文件，但要注意路径是相对当前工作目录的，部署后可能出现找不到文件的情况,下一节专门讲路径怎么处理。
创建配置文件的三个操作节点
- 先创建QSettings对象，指定格式或唯一标识
- 用setValue写入键值，键支持分组写法
- 程序退出前调用sync()，或让析构函数自动保存
多数情况下不需要手动调sync()，QSettings在析构时会自动写入，但如果你在程序运行中需要立即落盘，比如写完后马上断电测试，就应该调用sync()。
Qt读取配置文件路径怎么设置不出错
使用QSettings默认构造时，配置文件位置由Qt按平台规则决定，Windows下可能写到注册表或AppData目录，Linux下通常在~/.config，这种默认行为适合标准化桌面应用,但很多场景里你希望配置文件跟着程序走。
比较可靠的写法是使用QCoreApplication::applicationDirPath()拼接文件名：
QString configPath = QCoreApplication::applicationDirPath() + "/config.ini"; QSettings settings(configPath, QSettings::IniFormat);
applicationDirPath()返回可执行文件所在目录，在Windows和Linux下都能用，开发调试时,这个路径几乎不会出错。
Windows和Linux下路径选择的差异
- Windows：程序放在独立目录时，可以用exe同目录存放配置；如果安装到Program Files，配置文件更适合写到AppData，避免权限问题
- Linux：安装在/usr/bin时，exe同目录通常只读，配置应该遵循XDG规范，写到~/.config或~/.local/share
跨平台项目中更稳妥的做法是使用QStandardPaths获取配置目录：
QString dir = QStandardPaths::writableLocation(QStandardPaths::AppConfigLocation); QDir().mkpath(dir); QString configPath = dir + "/config.ini";
这段代码会自动定位到系统认可的应用配置目录，并在目录不存在时先创建，对需要分发到不同系统的Qt程序来说,这比写死相对路径可靠得多。
别踩相对路径的坑
开发时用
QSettings settings("config.ini", QSettings::IniFormat);能正常读写，因为IDE启动程序时工作目录通常是工程目录，但打包后用户双击运行时，工作目录可能变成用户主目录或者别的什么地方，结果就是文件读写看似成功，其实写到了错误位置，下次启动又找不到,所以正式项目里不建议依赖相对路径。
Qt配置文件读写对比：QSettings与QFile操作ini的差异
很多人第一次接触qt读取配置文件的方法时，会纠结到底用QSettings封装好，还是自己用QFile按行解析ini，两者都能实现功能,但适用场景差别不小。
| 对比项 | QSettings | QFile手动解析 |
| 键值存储 | 自动处理分组和类型 | 需自己解析字符串 |
| 写入同步 | sync()或析构自动保存 | 需手动flush和close |
| 格式支持 | ini、注册表、plist等 | 只能处理文本 |
| 编码处理 | setIniCodec可指定 | 需手动转码 |
| 错误恢复 | 缺键可给默认值 | 解析失败需自己兜底 |
QSettings读取一段配置只需要一行：
QSettings s("config.ini", QSettings::IniFormat);
QString host = s.value("Database/host", "127.0.0.1").toString();
而用QFile手动解析，得自己处理分组、注释、空行、引号和类型转换：
QFile f("config.ini");
f.open(QIODevice::ReadOnly | QIODevice::Text);
while (!f.atEnd()) {
QString line = f.readLine().trimmed();
// 自己解析 = 和 [group]
}
手动解析在处理超大文件或非标准格式时依然有价值，但日常应用配置用QSettings足够，行业共识认为，能用成熟组件解决的问题不要重复造轮子,出错概率和维护成本都会低很多。
什么时候必须用QFile
- 需要读取非ini格式，比如properties、自定义文本格式
- 需要流式处理非常大的配置文件，避免一次性加载到内存
- 对ini语法有特殊要求，QSettings无法完全匹配
解决Qt读取配置文件乱码的正确姿势
中文配置项乱码大多来自编码不一致，ini文件被Windows记事本保存为ANSI或GBK，但Qt默认按UTF-8读取，或者反过来,就会出现一串看不懂的字符。
解决起来很简单，统一编码即可，推荐配置文件一律保存为UTF-8无BOM，如果历史遗留文件是GBK编码,可以在读取前指定：
QSettings settings("config.ini", QSettings::IniFormat);
settings.setIniCodec("GBK");
QString name = settings.value("User/name").toString();
如果配置文件由程序自己生成，写入和读取都保持UTF-8，就不会出现乱码，外部编辑时用VS Code或Notepad++另存为UTF-8,也能避免大部分问题。
检查乱码的排查顺序
- 确认ini文件实际编码，用编辑器查看右下角状态栏
- 确认QSettings的iniCodec设置是否与文件编码匹配
- 确认文件是否带BOM，QSettings对带BOM的UTF-8有时会处理异常，建议使用无BOM格式
跨平台项目统一配置文件编码为UTF-8无BOM,是多数Qt项目的稳妥选择。
Qt读取配置文件常见问题与Q&A
qt读取配置文件找不到路径怎么办？
先用QFile::exists打印完整路径，确认文件是否真的存在，再检查QDir::currentPath()返回的当前工作目录，看是不是运行目录和预期不一致,路径拼写和文件扩展名也要仔细核对。
qt读取配置文件如何设置默认值？
QSettings的value方法第二个参数就是默认值，键不存在时返回默认值，程序不会崩溃，例如settings.value("size", 800).toInt(),读取不到时返回800。
qt读取配置文件支持哪些格式？
QSettings原生支持ini格式、Windows注册表、macOS的plist，还能通过注册自定义格式扩展读取能力,日常桌面应用用ini格式足够。
配置文件读取在Qt里不是高深技术，但路径、编码、默认值这三件事处理好了，能省掉相当一部分排查时间，用QSettings替代手动解析,是多数场景下性价比最高的选择。