遵循ISO C++标准并统一构建配置是实现MSVC、GCC和Clang兼容的关键，应避免编译器特有扩展、使用宏封装差异、规范头文件包含，并通过CMake等工具统一设置语言标准与警告等级。
在C++跨平台开发中，让代码在MSVC、GCC和Clang之间保持兼容是常见需求。不同编译器对标准的支持、扩展特性和ABI存在差异，稍不注意就可能引发编译错误或运行时问题。以下是一些实用技巧，帮助你写出更兼容的代码。
遵循现代C++标准
最有效的兼容策略是坚持使用ISO C++标准语法，并明确指定语言标准版本。
- 避免编译器特有的扩展语法（如GCC的__attribute__或MSVC的__declspec），除非必要且做好封装
- 在构建系统中统一设置标准版本，例如-std=c++17或/std:c++17
- 启用严格模式：-Wall -Wextra -pedantic（GCC/Clang），MSVC使用/W4并尽量向/permissive-靠拢
处理常见的编译器差异
某些语法或行为在不同编译器下表现不一，需特别注意。
-
内联命名空间与导出符号：MSVC默认导出所有符号，而GCC/Clang需要显式标记。可使用宏统一处理：
#ifdef _MSC_VER
#define DLL_EXPORT __declspec(dllexport)
#else
#define DLL_EXPORT __attribute__((visibility("default")))
#endif - 变参宏的逗号问题：MSVC允许空变参，但GCC严格检查。使用##__VA_ARGS__解决： #define LOG(fmt, ...) printf(fmt, ##__VA_ARGS__)
- constexpr和模板实例化：确保复杂constexpr函数在各编译器上都能在编译期求值，避免依赖未定义行为
规避头文件和包含顺序问题
头文件管理不当容易在某个编译器上出错。
立即学习“C++免费学习笔记（深入）”；
- 每个头文件都加include guard或使用#pragma once（三者都支持）
- 包含头文件时使用引号"header.h"还是尖括号<header>要一致，推荐项目内头文件用引号
- 避免隐式依赖：确保每个头文件独立可编译，不要依赖前序包含
- MSVC有时对模板友元声明更宽松，GCC/Clang可能报错，建议写全限定声明
构建系统与条件编译
合理使用预定义宏区分平台和编译器。
- 识别编译器：
#ifdef _MSC_VER
// MSVC
#elif defined(__GNUC__)
// GCC 或 Clang
#elif defined(__clang__)
// Clang（注意它也定义__GNUC__） - 避免过度使用#ifdef，把差异封装成小函数或类
- 使用CMake等工具统一配置编译选项，例如设置标准、警告等级和宏定义
基本上就这些。只要坚持标准、小心扩展、统一构建配置，大多数兼容性问题都能避免。关键是在开发早期就考虑多编译器支持，而不是后期补救。
