windows用sleep(ms)，linux/macos需用nanosleep并处理eintr中断；应采用条件编译的inline函数封装，正确转换毫秒为tv_sec/tv_nsec，避免溢出与macos零纳秒bug，不推荐std::this_thread::sleep_for因其精度、信号响应及旧环境兼容性问题。
Windows下用Sleep，Linux/macOS下必须换函数
Windows的Sleep是大写S、接受毫秒、在Windows.h里；Linux/macOS没有这个函数，得用nanosleep或usleep——但usleep已被标记为废弃，POSIX推荐nanosleep。直接写条件编译是最稳妥的做法，别试图封装成统一接口再加一层抽象，容易引入精度误差或信号中断问题。
常见错误：有人用std::this_thread::sleep_for(std::chrono::milliseconds(n))当跨平台解法——它确实能用，但底层实现依赖系统API，在某些嵌入式或老版本libc环境下可能不可靠（比如musl libc 1.2.2之前对clock_nanosleep支持不全），且无法响应信号中断控制，而原生系统调用可以。
-
Sleep(1)在Windows上实际可能休眠1–15ms（取决于系统调度粒度），不是严格1ms -
nanosleep传入的timespec结构需手动把毫秒转成tv_sec和tv_nsec，别直接赋值tv_nsec = ms * 1000000——超过1秒会溢出 - Linux下
nanosleep可被信号中断，返回-1并置errno = EINTR，必须循环重试
如何安全地封装一个msleep函数
不要用宏定义隐藏差异，用inline函数+条件编译更清晰。重点处理三件事：单位转换、中断重试、平台头文件隔离。
#ifdef _WIN32
#include <windows.h>
#else
#include <time.h>
#include <errno.h>
#endif
<p>inline void msleep(unsigned int ms) {</p>
<h1>ifdef _WIN32</h1>
<pre class="brush:php;toolbar:false;">Sleep(ms);
else
struct timespec ts = {ms / 1000, (ms % 1000) * 1000000L};
while (nanosleep(&ts, &ts) == -1 && errno == EINTR) {
// 被信号中断，继续睡剩余时间
}
endif
}
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
注意：ts.tv_nsec必须小于1秒（10^9 ns），所以用ms % 1000取余；ts.tv_sec用整除。别写ts.tv_nsec = ms * 1000000——1000ms就溢出了。
为什么不用std::this_thread::sleep_for
它在绝大多数桌面环境工作正常，但有三个硬伤：
- 某些实时性要求高的场景（如音频驱动、工业PLC通信）需要精确到系统timer resolution，而
std::this_thread::sleep_for中间多了一层C++标准库调度，延迟不可控 - Android NDK r21之前，
std::this_thread::sleep_for底层调用clock_nanosleep(CLOCK_MONOTONIC, ...)，但部分旧内核不支持该flag，会fallback到nanosleep并丢失单调时钟语义 - 无法在
signal handler中安全调用（虽然你本就不该在signal handler里sleep，但封装层若隐式依赖std::thread，会增加意外风险）
macOS上nanosleep的兼容性坑
macOS 10.12+完全支持nanosleep，但早期版本（如10.7）存在bug：当tv_nsec为0时，函数可能立即返回而不休眠。所以保险起见，显式避免tv_nsec == 0且tv_sec == 0的情况：
// 在nanosleep前加判断： if (ts.tv_sec == 0 && ts.tv_nsec == 0) return;
另外，macOS的mach_absolute_time精度虽高，但nanosleep最小分辨率仍是1ms左右，和Linux/Windows一致——别指望亚毫秒级睡眠，那得用busy-wait或硬件timer。
跨平台Sleep真正难的不是写两行条件编译，而是理解每个平台的中断语义、精度边界和信号行为。写完记得在目标平台上实测msleep(1)和msleep(10)的实际耗时，用clock_gettime(CLOCK_MONOTONIC, ...)前后打点，别只信文档。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
