Qt6 Windows非管理员权限下无法写入JSON配置文件的解决办法

问题核心原因 #

Windows系统对Program Files等默认程序安装目录有严格的权限管控，非管理员账户仅拥有读取权限，无法直接写入该目录下的文件，这是导致你写入JSON失败的根本原因。

方法1：使用Qt标准路径API存储设置文件 #

Qt提供QStandardPaths类，可直接获取系统推荐的用户专属配置目录，这类目录属于当前用户，非管理员权限即可正常读写。

示例代码：

#include <QStandardPaths>
#include <QFile>
#include <QJsonDocument>
#include <QJsonArray>
#include <QDir>

// 获取当前用户的应用配置目录（路径类似 C:\Users\<用户名>\AppData\Roaming\<应用名>）
QString settingsDir = QStandardPaths::writableLocation(QStandardPaths::AppConfigLocation);
// 确保目录存在，不存在则创建
QDir().mkpath(settingsDir);
// 拼接目标JSON文件路径
QString filePath = settingsDir + "/a.json";

QFile file(filePath);
if (!file.open(QIODevice::WriteOnly)) {
    // 可添加错误日志输出，比如 qDebug() << file.errorString();
    return;
}

QJsonArray json;
for (const auto& config : _configs) {
    json.push_back(ToJson(config));
}
file.write(QJsonDocument(json).toJson());
file.close(); // 务必关闭文件，确保写入完成

方法2：迁移旧配置文件（可选） #

如果原程序目录下的settings文件夹已有用户配置，可在应用启动时自动将旧文件迁移到新的用户配置目录，避免用户数据丢失：

#include <QFile>

// 旧配置文件路径
QString oldFilePath = QCoreApplication::applicationDirPath() + "/settings/a.json";
// 新配置文件路径
QString newFilePath = QStandardPaths::writableLocation(QStandardPaths::AppConfigLocation) + "/a.json";

QFile oldFile(oldFilePath);
QFile newFile(newFilePath);

// 仅当旧文件存在且新文件不存在时执行复制
if (oldFile.exists() && !newFile.exists()) {
    oldFile.copy(newFilePath);
    // 可选：复制完成后可删除旧文件，或保留作为备份
}

注意事项 #

不要尝试修改程序安装目录（如Program Files）的权限，这会破坏Windows的安全模型，可能触发杀毒软件拦截，还会降低系统稳定性。

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