Qt使用QSetting记住上次打开路径的方法

引言

图片查看工具开发中，有几个小毛病常常让人头疼：每次启动都傻傻地固定在同一个目录，打开过的路径下次还得重新翻，图片加载进来要么撑爆控件要么缩得看不清。这些细节说大不大，但直接让工具从“能用”跌到“难用”。今天就来聊聊，怎么用 Qt 把这些老问题一个个收拾干净，让图片查看器真正变得顺手。

一、前期准备：代码备份与方法拆分

动手改造之前，代码安全永远是第一位的。先把原有的文件打开逻辑完整备份一份，万一改出问题还能快速回滚。另外，为了让思路更清晰，我们把打开功能拆成几个独立方法，方便一步步调试和迭代。

// 头文件中声明打开方法
private slots:
    void open1();  // 原始打开逻辑备份
    void open2();  // 记录路径+默认路径优化
    void open3();  // 智能指针优化内存
    void open4();  // 图片自适应最终版

有个小细节容易忽略：在 Qt Creator 里，头文件声明方法后，快捷键是不会自动生成函数体的，需要手动到 cpp 文件里实现。提前知道这点，能省下不少调试时间。

我们把原始代码复制到 open1() 里作为备份，后续优化全部在 open2() 里操作，保持代码结构干净，互不干扰。

二、核心优化 1：记住用户上次打开路径

用户每次打开图片，最自然的需求就是直接跳到上次用过的目录，而不是重新逐层翻找。Qt 本身并不自带路径记忆功能，所以得借助配置文件来持久化存储路径，实现自动记忆。

1. 配置文件规划

在程序编译后的 debug 目录下，创建一个 config 文件夹，里面放一个 setting.ini 文件，所有路径数据都存到这儿。

2. 获取配置文件路径

先通过 Qt 的核心对象获取程序 exe 所在的目录，然后拼接出配置文件的完整路径：

// 获取exe所在目录
QString appPath = QApplication::applicationDirPath();
// 配置文件完整路径：debug/config/setting.ini
QString iniPath = appPath + "/config/setting.ini";

3. 用 QSettings 读写配置文件

Qt 的 QSettings 类是读写 ini 配置文件的利器，引入头文件就能轻松实现键值对的存储和读取：

#include 

读取上次路径

程序启动时，先从配置文件读取 lastPath 字段：

// 初始化配置文件对象
QSettings* pIni = new QSettings(iniPath, QSettings::IniFormat);
// 读取上次保存的路径
QString lastPath = pIni->value("lastPath/path").toString();

// 若首次打开无记录，设置默认路径
if (lastPath.isEmpty()) {
    // 获取系统默认图片目录
    lastPath = QStandardPaths::writableLocation(QStandardPaths::PicturesLocation);
}

这里用到 QStandardPaths 类，它能精准拿到系统预设的目录（桌面、文档、图片、音乐等），避免硬编码路径带来的兼容性问题。

保存当前路径

用户选择图片后，截取文件所在目录，写到配置文件里：

// 获取用户选择的文件完整路径
QString fileName = QFileDialog::getOpenFileName(this, "打开图片", lastPath, "图片文件(*.png *.jpg *.jpeg)");
// 截取目录（去掉文件名）
int endIndex = fileName.lastIndexOf("/");
QString currentPath = fileName.left(endIndex);
// 写入配置文件
pIni->setValue("lastPath/path", currentPath);

4. 内存管理优化

手动 new 出来的 QSettings 对象必须释放，不然会内存泄漏：

// 手动释放
delete pIni;
pIni = nullptr;

更优雅的方式是使用 C++11 智能指针 std::unique_ptr，不用手动释放，自动管理内存：

#include 
// 智能指针管理QSettings
std::unique_ptr pIni = std::make_unique(iniPath, QSettings::IniFormat);

三、核心优化 2：默认路径锁定系统图片目录

传统图片查看器默认路径是固定的，用户每次都得手动切换。我们直接把默认路径设为系统图片文件夹，通过 QStandardPaths::PicturesLocation 一键获取，不用手动配置，Windows、Linux、macOS 全平台通用。

当配置文件里没有历史记录时，程序自动跳转到系统图片目录，开箱即用，用户一上手就能省掉一步操作。

四、核心优化 3：图片自适应控件显示

路径问题解决后，另一个常见毛病是图片加载后不是变形就是显示不全。我们用 QPixmap 的缩放功能，让图片完美适配显示控件。

// 加载图片
QPixmap* pix = new QPixmap(fileName);
// 获取显示标签的大小
QSize labelSize = ui->label->size();
// 图片自适应缩放，保持比例
QPixmap scaledPix = pix->scaled(labelSize, Qt::KeepAspectRatio, Qt::SmoothTransformation);
// 设置图片到标签
ui->label->setPixmap(scaledPix);
// 开启标签内容自适应
ui->label->setScaledContents(true);

关键参数说明：

• Qt::KeepAspectRatio：保持图片宽高比，避免拉伸变形；
• Qt::SmoothTransformation：平滑缩放，提升图片显示清晰度；
• 图片加载后记得 delete pix，释放内存资源。

五、优化成果总结

经过这三步核心优化，图片查看器实现了三大能力：

1. 路径记忆：重启后直接定位上次打开目录，告别重复查找；
2. 智能默认：默认打开系统图片目录，适配全平台；
3. 自适应显示：图片自动适配控件大小，清晰不变形。

整个优化围绕用户体验展开，用的都是 Qt 原生类，操作轻量，代码简洁易维护，没有引入任何第三方依赖，完美解决了初始版本的所有痛点。后续还可以把路径存储升级为系统注册表，进一步提升配置的安全性，让工具更专业。