跨平台C++需在编译期区分32/64位ABI：一、用_WIN64/_WIN32或__x86_64__/__i386__等宏条件编译；二、用#if sizeof(void*)==8判断指针大小；三、组合平台与位数宏分层处理；四、禁用__LP64__、运行时sizeof及SIZE_MAX等不可靠方式；五、用编译器命令验证实际宏定义。
如果您在编写跨平台 C++ 代码时需要适配不同位宽的运行环境，则必须在编译期准确区分目标是 32 位还是 64 位 ABI。以下是多种可靠、无副作用的检测方法：
一、使用标准预处理器宏进行条件编译
该方法利用编译器在构建时自动定义的平台与架构宏，确保不匹配分支的代码完全不参与编译，避免符号未声明或链接失败问题。
1、针对 Windows 平台，使用 _WIN64 和 _WIN32 宏组合判断：
2、在源文件中插入如下预处理块：
立即学习“C++免费学习笔记（深入）”；
#if defined(_WIN64)
// 此处为 64 位 Windows 专用代码
#elif defined(_WIN32)
// 此处为 32 位 Windows 专用代码
#endif
3、针对 Linux/macOS 等 POSIX 系统，优先检查 __x86_64__、__aarch64__ 或 __i386__ 等架构宏：
#if defined(__x86_64__) || defined(__aarch64__)
// 64 位架构通用分支
#elif defined(__i386__) || defined(__arm__)
// 32 位架构通用分支
#endif
二、依据 sizeof(void*) 进行编译期分支
该方法依赖指针大小这一 ABI 根本属性，所有主流编译器（MSVC/GCC/Clang）均保证其为编译期常量表达式，值为 4 或 8，且不随运行时环境变化。
1、在头文件或源文件中使用 #if 预处理指令包裹分支：
#if sizeof(void*) == 8
uint64_t addr = reinterpret_cast
#else
uint32_t addr = reinterpret_cast
#endif
2、注意：必须使用 #if 而非 if()，否则未命中分支仍会被完整编译并可能引发错误。
3、可配合 static_assert 验证对齐要求，例如：static_assert(alignof(std::max_align_t) >= 8) 放在 #if sizeof(void*) == 8 分支内。
三、组合平台与位数宏实现精准分发
当需同时区分操作系统类型与位数时，应先按平台宏分层，再在各平台内部按位数宏细化，避免宏冲突或误判。
1、先判断是否为 Windows 环境：
#ifdef _WIN32
2、在 _WIN32 分支内进一步区分位数：
#ifdef _WIN64
// Windows x64 或 ARM64
#else
// Windows x86（32 位）
#endif
3、对非 Windows 环境使用 POSIX 架构宏：
#elif defined(__linux__) || defined(__APPLE__)
#if defined(__x86_64__) || defined(__aarch64__)
// Linux/macOS 64 位
#else
// Linux/macOS 32 位（如 i386）
#endif
#endif
四、避免使用不可靠的替代方案
某些看似可用的宏或运行时手段存在严重移植性缺陷或逻辑漏洞，必须主动规避。
1、禁止单独依赖 __LP64__：它在 Windows x64 下不定义，会导致该平台被错误归类为 32 位。
2、禁止使用 if (sizeof(void*) == 8)：此为运行时语句，编译器仍会尝试编译两个分支，若某一分支引用了仅 64 位存在的类型（如 __m128i）或函数，将直接报错。
3、禁止使用 SIZE_MAX 或 INTPTR_MAX 做 #if 条件：它们不是预处理器字面量，MSVC 与 GCC 展开行为不一致，极易导致跨编译器失效。
五、验证当前工具链实际定义的宏
当出现宏未按预期定义的情况时，应直接查询编译器实际暴露的宏集合，而非依赖文档猜测。
1、在 Linux/macOS 下执行：g++ -dM -E -
2、在 Windows 使用 MSVC 工具链时，运行：cl /EP /C /DTEST nul | findstr "_WIN"
3、在 Clang on Windows（clang-cl）下，确认其模仿 MSVC 行为，仅定义 _WIN32，不定义 __linux__。
