pthread_setname_np是Linux下为线程设置名称的非标准扩展函数，可指定任意线程ID并设置最多15字符+1终止符的名称，失败返回非零值且不截断，需定义_GNU_SOURCE并避免空格、斜杠等非法字符。
Linux 下用 pthread_setname_np 设置线程名
在 Linux 环境中，C++ 本身不提供跨平台线程命名接口，但可通过 pthread 的非标准扩展函数 pthread_setname_np 实现。它接受两个参数：线程 ID 和最多 16 字节（含结尾 \0）的 C 字符串。
常见错误是传入超长名字或忽略返回值——该函数失败时返回非零值，且不会截断字符串，直接导致 EINVAL 错误。
- 必须用
pthread_self()获取当前线程 ID，不能用std::thread::native_handle()直接转，因为后者类型是pthread_t，可直接传，但需确认编译器未禁用 GNU 扩展（如加了-D_GNU_SOURCE） - 名字里不能含空格或斜杠（
/），否则会被内核拒绝，返回EINVAL - 若在线程启动后立即调用，建议加少量延时或用互斥锁确保线程已进入执行状态，否则可能因调度延迟导致设置失败
#define _GNU_SOURCE
#include <pthread.h>
#include <string>
void set_thread_name(const std::string& name) {
if (name.length() > 15) return; // 超长会被截断或失败
pthread_setname_np(pthread_self(), name.c_str());
}
macOS 下用 pthread_setname_np 行为不同
macOS 也提供 pthread_setname_np，但签名是单参数版本：int pthread_setname_np(const char *name)，只作用于当前线程，且最大长度仍是 64 字节（注意不是 16）。这点和 Linux 完全不兼容。
若代码需跨 Linux/macOS，不能直接封装同一函数调用，必须条件编译。
立即学习“C++免费学习笔记（深入）”；
- macOS 不校验字符集，但名字中出现
/会导致后续ps或 Xcode 调试器显示异常（显示为空或截断） - 该函数在 macOS 上失败概率低，但仍需检查返回值：成功返回 0，失败返回 errno（如
ENOMEM） - Objective-C/Swift 线程（如
NSThread）设名不影响底层 pthread 名，调试器看到的仍是默认名
Windows 下用 SetThreadDescription（Win10 1607+）
Windows 原生支持从 Win10 1607 开始通过 SetThreadDescription 设置线程描述，接受 HANDLE 和宽字符串指针。它不等价于“名称”，而是调试器可见的描述字段，长度无硬限制（内部用堆分配）。
容易踩的坑是误用 SetThreadName（这是 Visual Studio 调试器私有协议，触发异常 INT 0x2d，仅用于调试器通信，不影响系统视图）。
-
SetThreadDescription需要handle，而std::thread::native_handle()在 MSVC 中返回的是HANDLE，可直接使用 - 必须用
L"..."宽字符串，传char*会崩溃 - 旧版 Windows（如 Win7）调用该函数会返回
ERROR_INVALID_FUNCTION，需运行时判断并降级处理（比如只记录日志）
#include <windows.h>
#include <string>
void set_thread_description(const std::wstring& desc) {
SetThreadDescription(GetCurrentThread(), desc.c_str());
}
调试时看不到名字？检查工具链和上下文
即使正确调用设置函数，ps -T -o pid,tid,comm,args、htop 或 IDE 调试器仍可能不显示——原因往往不在代码本身。
comm 列只显示线程名的前 15 字节（Linux），且部分工具（如早期 gdb）需配合 info threads 才能读取；VS 调试器依赖 SetThreadDescription，对 pthread 名完全无视。
- Linux 下用
cat /proc/<tid>/comm查看实际设置的名，比ps更准确 - 若用容器（如 Docker），需确认未启用
--userns-remap或 seccomp 策略屏蔽prctl系统调用（pthread_setname_np底层调用它） - ASan/TSan 运行时可能拦截或重写线程创建逻辑，导致设置时机错乱，建议关闭检测器验证是否为此类干扰
跨平台封装时，别指望一个函数名统一行为；每个系统对“线程名”的定义、存储位置、消费方都不同。真正关键的不是设不设，而是你打算让谁看到它——调试器、监控脚本，还是运维命令行？选对 API 才算走对第一步。
