如何在任意PC上定位Documents目录及解决QDir创建文件夹失败问题

嘿，我来帮你捋清楚这个问题：你提到的%USERPROFILE%确实是Windows下指代当前用户目录的环境变量，但Qt的QDir类并不会自动解析字符串里的环境变量占位符，这就是你调用mkdir返回false的根本原因。下面给你两种解决方案，优先推荐跨平台的通用方法：

方法一：用Qt原生的标准路径类（强烈推荐，跨平台） #

Qt专门提供了QStandardPaths来处理系统标准路径，不管是Windows、macOS还是Linux，它都能返回正确的Documents文件夹位置，完全不用硬编码路径或者依赖环境变量：

#include <QStandardPaths>
#include <QDir>

// 获取当前用户可写入的Documents路径
QString docsDir = QStandardPaths::writableLocation(QStandardPaths::DocumentsLocation);
// 拼接目标文件夹的完整路径
QString targetFolder = docsDir + "/ATFolder";

// 用mkpath代替mkdir：它会自动创建所有不存在的父目录，容错性更强
bool isCreated = QDir().mkpath(targetFolder);

if (isCreated) {
    qDebug() << "搞定！文件夹创建成功：" << targetFolder;
} else {
    qDebug() << "创建失败了，检查下权限或者路径是否有问题？";
}

为什么推荐这个？ #

• 完全跨平台：不用管不同系统的路径规则，Qt帮你搞定一切
• 容错性高：mkpath会递归创建所有需要的父目录，而mkdir只能创建单级目录，如果遇到Documents路径不存在的极端情况（虽然几乎不会发生），mkdir直接失败，mkpath则能处理
• 符合Qt的最佳实践，官方文档也推荐用这个类来获取系统标准路径

方法二：手动解析Windows环境变量（仅Windows场景） #

如果你只需要适配Windows平台，也可以手动解析USERPROFILE环境变量，再拼接路径：

#include <QProcessEnvironment>
#include <QDir>

// 从系统环境变量中获取USERPROFILE的值
QString userProfile = QProcessEnvironment::systemEnvironment().value("USERPROFILE");
if (userProfile.isEmpty()) {
    qDebug() << "糟了，拿不到USERPROFILE环境变量";
    return;
}

QString targetFolder = userProfile + "/Documents/ATFolder";
bool isCreated = QDir().mkpath(targetFolder);

这种方式只适用于Windows，不如第一种方法通用，所以除非你有特殊需求，否则优先选方法一。

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