必须使用 SHGetKnownFolderPath 获取 Windows 下载目录，Linux/macOS 应遵循 XDG 规范读取 user-dirs.dirs；路径需动态获取、UTF-8 编码返回，并验证可写性。
Windows 上用 SHGetKnownFolderPath 拿下载目录，别碰 CSIDL
Windows 从 Vista 起就废弃了 CSIDL_DOWNLOADS 这类旧接口，现在必须走 KNOWNFOLDERID 体系。直接调 SHGetKnownFolderPath 是唯一靠谱路径，但得注意它返回的是宽字符路径，且需要链接 shell32.lib。
-
SHGetKnownFolderPath第二个参数必须传KF_FLAG_DEFAULT_PATH，否则可能返回重定向路径（比如 OneDrive 同步位置） - 返回的
PWSTR需用CoTaskMemFree释放，不是delete或free - 如果程序没初始化 COM（比如没调
CoInitializeEx），会直接返回E_NOINTERFACE错误 - 示例关键片段：
LPWSTR path = nullptr; HRESULT hr = SHGetKnownFolderPath(FOLDERID_Downloads, KF_FLAG_DEFAULT_PATH, nullptr, &path); if (SUCCEEDED(hr)) { // 使用 path（注意是 wide string） CoTaskMemFree(path); }
Linux/macOS 用 XDG Base Directory 规范，别硬写 ~/Downloads
XDG 不是可选标准，是事实上的 Linux 桌面环境默认行为；macOS 虽无原生 XDG，但主流跨平台库（如 Qt、SDL）和用户习惯都倾向兼容它。硬拼 ~/Downloads 在 KDE、GNOME 或 Flatpak 环境下大概率错——实际路径可能被 XDG_USER_DIRS 重定向。
- 先读
$XDG_CONFIG_HOME/user-dirs.dirs（通常为~/.config/user-dirs.dirs），里面存着类似XDG_DOWNLOAD_DIR="$HOME/MyDownloads"的映射 - 若该文件不存在或未定义
XDG_DOWNLOAD_DIR，才 fallback 到$HOME/Downloads - 注意变量值里的
$HOME必须手动展开，shell 不会帮你做 - macOS 上建议同样走 XDG 路径逻辑，而不是查
NSHomeDirectory()+ 拼/Downloads—— 用户可能改过位置，且某些沙盒环境（如 App Store 版）根本没这个目录
C++ 跨平台封装时，std::filesystem::path 是起点，不是终点
用 std::filesystem::path 拼接或表示路径没问题，但它不解决“怎么拿到下载目录”这个源头问题。很多同学卡在这一步：以为只要用上 std::filesystem 就自动跨平台了，结果 Windows 返回了正确路径，Linux 却始终返回空。
- 别在编译期靠
#ifdef _WIN32分支硬写两套逻辑——把平台探测和路径获取拆成独立函数，测试更容易 - 返回类型建议统一用
std::string（UTF-8 编码），Windows 下从PWSTR转换时用WideCharToMultiByte(CP_UTF8, ...)，别用std::wstring_convert（已弃用） - 如果项目已用 CMake，可在
find_package阶段检查shell32是否可用，避免 Windows 链接失败却拖到运行时报错 - 不要缓存结果：用户可能在程序运行期间修改 XDG 配置或 OneDrive 同步设置，下次调用应重新读取
容易被忽略的权限与沙盒场景
即使路径字符串拿到了，也不代表能写入。特别是 Linux Flatpak/Snap、macOS App Sandbox、Windows UWP 模式下，真实路径存在，但进程无权访问。
立即学习“C++免费学习笔记（深入）”；
- Flatpak 应用默认只能访问
$HOME下的Downloads子目录，且需声明--filesystem=downloads权限 - macOS App Sandbox 要在 entitlements 文件里加
com.apple.security.files.downloads.read-write - Windows 上若程序以低完整性级别运行（比如 IE 模式或受保护模式），
SHGetKnownFolderPath可能成功，但后续CreateFile仍失败 - 最稳妥的做法：拿到路径后，立刻用
std::filesystem::is_writable检查，失败则降级到临时目录并提示用户
