判断msvc需用#if defined(_msc_ver) && _msc_ver >= 1920，禁用#ifdef搭配&&；linux/macos下检测gcc需#if defined(__gnuc__) && !defined(__clang__)；跨平台导出应结合_win32与__gnuc__/__clang__宏；#pragma once非标准且路径敏感，应以#ifndef为主。
怎么判断当前编译器是不是 MSVC
直接看 _MSC_VER 是否定义，它只在 MSVC（含 clang-cl）中存在，且值随版本递增（如 VS2019 是 1920，VS2022 是 1930+）。别用 __GNUC__ 或 __clang__ 反向排除——Clang 在 Windows 上可能同时定义 __clang__ 和 _MSC_VER，误判会导致条件编译失效。
常见错误：写成 #ifdef _MSC_VER && _MSC_VER >= 1920 ——&& 在预处理指令里不合法，必须用 #if 而非 #ifdef。
-
#if defined(_MSC_VER) && _MSC_VER >= 1920✅ -
#ifdef _MSC_VER && _MSC_VER >= 1920❌（语法错误，预处理器直接报错） -
#if _MSC_VER >= 1920⚠️（没检查是否定义，GCC/Clang 下会警告“undefined identifier”）
Linux/macOS 下怎么安全检测 GCC 版本
__GNUC__ 系列宏只在 GCC 和兼容它的编译器（如 ICC、TCC）中定义，但 Clang 默认也定义它们——除非加 -fno-gnu-keywords。所以单靠 __GNUC__ 不能断定是 GCC，得配合 __clang__ 排除。
典型场景：需要 GCC 特有内联汇编语法或 __attribute__((optimize))，但又不想在 Clang 下触发警告或编译失败。
立即学习“C++免费学习笔记（深入）”；
-
#if defined(__GNUC__) && !defined(__clang__)✅ 基本可靠 -
#ifdef __GNUC__❌ Clang 也会进，可能出错 - 版本比较用
__GNUC__ * 100 + __GNUC_MINOR__，比如__GNUC__ * 100 + __GNUC_MINOR__ >= 902表示 ≥ GCC 9.2
怎么写跨平台的 __declspec(dllexport) / __attribute__((visibility("default")))
Windows DLL 导出用 __declspec(dllexport)，Linux/macOS 共享库用 __attribute__((visibility("default")))，两者语义接近但语法互斥。硬写两个宏容易漏掉编译器分支，最稳的方式是统一抽象为一个宏。
关键点：Clang 和 GCC 在 Linux/macOS 下默认 visibility=hidden，但 Windows 下 __attribute__ 被忽略；MSVC 则完全不认 __attribute__。所以不能只靠编译器宏，还得结合目标平台。
- 推荐定义：
#if defined(_WIN32) && !defined(__MINGW32__)→ 用__declspec(dllexport) -
#elif defined(__GNUC__) || defined(__clang__)→ 用__attribute__((visibility("default"))) - MinGW 是个特例：它跑在 Windows 上但用 GCC 工具链，
__declspec可用，但更推荐走 GCC 分支保持一致
为什么 #pragma once 不能完全替代 #ifndef 头文件卫士
#pragma once 看起来简洁，但不是标准 C++，部分老编译器（如某些嵌入式工具链、早期 Sun CC）不支持；更重要的是，它依赖文件路径的唯一性判断——硬链接、符号链接、挂载点映射都可能导致重复包含或漏包含。
而 #ifndef MY_HEADER_H 是标准行为，稳定、可预测，现代编译器对其做了充分优化（如 GCC 的“include guard optimization”），性能差距几乎为零。
- CI 构建时若用 NFS 挂载源码，
#pragma once可能失效，#ifndef不会 - 头文件被重命名后复制到不同路径（如测试用 mock 头），
#pragma once会认为是两个文件，#ifndef需手动改宏名才能避免冲突 - 混合使用时，建议以
#ifndef为主，#pragma once当作辅助加速（双保险）
实际项目里最常翻车的，是把平台判断逻辑写死在头文件顶层，结果被另一个模块用不同编译器选项包含时，宏定义状态不一致——这种问题往往要追半天 include 顺序和构建配置。
