Windows系统下使用C++获取AppData文件夹路径的最优方法是什么

2021年后Windows平台C++获取AppData路径的最优实现 #

首先明确：老方案getenv("APPDATA")存在明显缺陷：依赖进程环境变量，容易被父进程篡改导致返回错误值，对MSIX打包应用、桌面桥转制应用兼容性差，微软官方已经不推荐使用。
当前推荐两种经过验证的稳定方案：

方案1：SHGetKnownFolderPath 全版本兼容方案

该方案是微软官方明确推荐的标准实现，兼容Win7及以上所有Windows版本，稳定性最高。
需要引入头文件<shlobj.h>、<knownfolders.h>，链接shell32.lib，示例代码如下：

#include <iostream>
#include <windows.h>
#include <shlobj.h>
#include <knownfolders.h>
#include <string>

#pragma comment(lib, "shell32.lib")

int main() {
    std::string appdataLocation;
    PWSTR pszPath = nullptr;
    // 获取Roaming AppData路径，如需Local AppData替换为FOLDERID_LocalAppData
    HRESULT hr = SHGetKnownFolderPath(FOLDERID_RoamingAppData, KF_FLAG_CREATE, nullptr, &pszPath);
    if (SUCCEEDED(hr)) {
        // 宽字符转UTF-8，如需窄字符ANSI可改用WideCharToMultiByte的CP_ACP参数
        int bufSize = WideCharToMultiByte(CP_UTF8, 0, pszPath, -1, nullptr, 0, nullptr, nullptr);
        if (bufSize > 0) {
            appdataLocation.resize(bufSize - 1);
            WideCharToMultiByte(CP_UTF8, 0, pszPath, -1, appdataLocation.data(), bufSize, nullptr, nullptr);
        }
        CoTaskMemFree(pszPath);
    }
    std::cout << appdataLocation << '\n';
    return 0;
}

注意：如果需要低权限进程使用的LocalLow路径，替换FolderID为FOLDERID_LocalAppDataLow即可。

方案2：C++/WinRT 现代C++方案

如果你的应用仅需要兼容Win10 1809及以上版本，优先选择该方案，无需手动管理内存，语法更符合现代C规范，出错概率更低。
需要先在项目中开启C/WinRT支持，示例代码如下：

#include <iostream>
#include <string>
#include <winrt/Windows.Storage.h>

using namespace winrt::Windows::Storage;

int main() {
    std::string appdataLocation;
    auto roamingFolder = ApplicationData::Current().RoamingFolder().Path();
    // 宽字符转UTF-8
    int bufSize = WideCharToMultiByte(CP_UTF8, 0, roamingFolder.c_str(), -1, nullptr, 0, nullptr, nullptr);
    if (bufSize > 0) {
        appdataLocation.resize(bufSize - 1);
        WideCharToMultiByte(CP_UTF8, 0, roamingFolder.c_str(), -1, appdataLocation.data(), bufSize, nullptr, nullptr);
    }
    std::cout << appdataLocation << '\n';
    return 0;
}

选型建议 #

• 需兼容Win7、早期Win10版本的存量应用，优先选择方案1
• 仅面向新Win10/Win11的新应用，优先选择方案2
• 拿到路径后推荐搭配C++17 std::filesystem库做路径拼接、权限校验操作，避免硬编码路径分隔符

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