优先用GetUserNameEx(NameSamCompatible)获取Windows用户名，Linux/macOS用getpwuid(geteuid())；跨平台需处理宏冲突、缓冲区大小及编码转换。
Windows下用GetUserNameEx比GetUserName更可靠
Windows原生API中，GetUserName只能返回登录名（SAM account name），不带域名，且在域环境里容易丢掉DOMAIN\前缀；而GetUserNameEx支持NameSamCompatible、NameDisplay等格式，能稳定拿到完整标识。
实操建议：
- 优先用
NameSamCompatible（值为1），它在域/本地环境都返回DOMAIN\user或.\user，方便后续解析 - 缓冲区必须预分配足够空间（至少
UNLEN + 1，但GetUserNameEx要求更大，建议用256字节起步） - 调用失败时检查
GetLastError()，常见错误是ERROR_INSUFFICIENT_BUFFER——别直接忽略，要重试
Linux/macOS用getpwuid(geteuid())而非getlogin()
getlogin()依赖终端会话，SSH后台任务、systemd服务、cron里大概率返回NULL；而getpwuid(geteuid())查的是当前有效UID对应的passwd条目，覆盖所有进程场景。
实操建议：
- 必须检查返回指针是否为
NULL，getpwuid失败不抛异常，只静默返回空 - 返回的
struct passwd*指向静态缓冲区，不可长期持有；如需保存，得strdup(pw->pw_name) - macOS上
getpwuid对Mobile Account用户可能返回NULL，可fallback到NSUserName()（Objective-C桥接），但纯C++项目通常绕不开这个限制
跨平台封装时避免宏污染和头文件冲突
Windows头要#include ，Linux/macOS要#include 和#include ，但windows.h默认定义min/max宏，和C++标准库冲突，pwd.h在部分旧版MinGW里又缺定义。
实操建议：
- 在包含
windows.h前加#define NOMINMAX，禁用min/max宏 - 用
#ifdef _WIN32而非#ifdef WIN32——后者在某些CMake配置下可能未定义 - Linux路径下不要假设
/etc/passwd可读（容器或无特权环境可能不可访问），始终走getpwuid系统调用，不手动解析文件
用户名长度和编码：别假设ASCII，但也不必立刻处理UTF-8
Windows用户名支持Unicode（通过GetUserNameEx的NameDisplay可得宽字符），Linux用户名按POSIX规范应为ASCII，但glibc实际允许UTF-8；然而绝大多数服务账户、CI环境、Docker镜像仍用纯ASCII名。
实操建议：
- 函数接口返回
std::string即可，Windows下用WideCharToMultiByte(CP_UTF8, ...)转，别用CP_ACP（系统默认码页不可靠） - 不做运行时UTF-8校验——只要不用于文件路径或网络协议，ASCII子集已覆盖99%场景
- 如果下游要写日志或显示，注意Windows控制台默认不渲染UTF-8，
SetConsoleOutputCP(CP_UTF8)需手动调，但仅限GUI进程有效
跨平台用户名获取真正的难点不在API调用本身，而在不同环境下“用户”定义的歧义：是登录会话用户？进程有效用户？还是passwd数据库里的名义用户？选哪个取决于你的使用场景——比如审计日志要geteuid，交互提示可用getlogin，而权限检查必须结合getgroups一起看。
