跨平台获取用户主目录需优先检查环境变量是否存在，再按平台调用系统api：windows用shgetknownfolderpath，unix用getpwuid_r，失败时回退并验证路径有效性。
Windows下USERPROFILE和Linux/macOS下HOME不能直接互换
环境变量名不同是表象，本质是路径语义和权限模型不一致：USERPROFILE在Windows指向当前用户的配置根目录（如C:\Users\Alice），而HOME在Unix系系统中是用户主目录（如/home/alice），但两者都可能被用户手动篡改或未设置。直接getenv("HOME")或getenv("USERPROFILE")在跨平台代码里会漏掉缺失环境变量的场景，比如某些Windows服务进程、WSL子系统启动的shell、或容器内运行的程序。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 永远先检查
getenv()返回值是否为nullptr，不假设变量一定存在 - Windows上
USERPROFILE优先级高于HOMEDRIVE+HOMEPATH组合，但后者在某些终端（如Git Bash）里更可靠 - macOS需注意
HOME可能指向/Users/xxx，但部分沙盒化App会被重定向到容器路径，此时HOME仍是正确的用户空间入口
std::filesystem::path不能直接替代环境变量读取
std::filesystem::current_path()返回的是进程当前工作目录，不是用户主目录；std::filesystem::temp_directory_path()返回临时目录，也无关。C++20标准库没有提供user_home_path()这样的接口，必须自己组装逻辑。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 不要用
std::filesystem::path::home_directory()——这个函数根本不存在，是常见误记 - 避免硬编码
"C:/Users/" + username或"/home/" + username：用户名可能含空格、Unicode，且Linux支持NIS/LDAP用户，getpwuid(getuid())才真正可靠（但POSIX-only） - 若已用C++17及以上，可封装一个轻量函数，优先查环境变量，失败后按平台调用系统API（Windows用
SHGetKnownFolderPath，Unix用getpwuid）
Windows上SHGetKnownFolderPath比环境变量更稳
当用户修改了USERPROFILE或以受限账户运行时，USERPROFILE可能指向错误位置，而SHGetKnownFolderPath(FOLDERID_Profile, ...)由Shell API从注册表和用户配置中动态解析，能正确处理漫游配置、OneDrive同步目录等场景。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 需链接
shell32.lib，头文件为shlobj.h - 返回的是
LPWSTR，需转为UTF-8再构造成std::string（用WideCharToMultiByte(CP_UTF8, ...)） - 失败时仍应回退到
getenv("USERPROFILE")，不能抛异常——某些精简版Windows或旧版Server可能不支持该API
Unix系系统用getpwuid(getuid())最准，但要注意链接和线程安全
getpwuid(getuid())读取的是系统密码数据库，不受HOME环境变量干扰，能正确处理NIS、LDAP、systemd-homed等现代用户管理机制。但它不是异步信号安全的，且glibc版本低于2.34时getpwuid_r才是线程安全的首选。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 必须链接
-lresolv（某些发行版需要）和-lc - 优先使用
getpwuid_r：分配足够大的buf（建议至少1024字节），并检查返回值是否为0（成功）而非NULL - 如果
getpwuid_r不可用或失败（如容器内无/etc/passwd），再fallback到getenv("HOME")，并验证路径是否存在且可访问（std::filesystem::is_directory()）
真正麻烦的不是路径获取本身，而是“主目录”这个概念在不同平台、不同部署环境下含义浮动：WSL里HOME可能是/home/alice，但实际数据落在Windows分区；macOS Catalina之后，~/Library被隔离，而~本身仍可写。别指望一次判断覆盖所有边缘case，得按实际用途选策略——存配置？走XDG_CONFIG_HOME；放缓存？用std::filesystem::temp_directory_path()；只读用户文档？老老实实调平台API。
