VS2022里__cplusplus宏为啥总是199711？一个配置项就搞定（附C++标准对照表）

VS2022中__cplusplus宏的199711之谜：深度解析与实战指南

当你第一次在Visual Studio 2022中检查__cplusplus宏的值时，可能会惊讶地发现它始终显示为199711——这个数字仿佛被施了魔法般顽固不变。这不禁让人困惑：明明项目已经配置为C++17甚至C++20标准，为何这个关键宏却停留在二十多年前的C++98时代？本文将彻底揭开这个谜团，提供一键解决方案，并深入探讨背后的技术考量。

1. 问题现象与根源分析

在VS2022中创建一个新项目，无论你在项目属性中如何调整C++语言标准（从C++14到C++20），使用以下测试代码时：

#include <iostream> int main() { std::cout << "__cplusplus value: " << __cplusplus << std::endl; return 0; }

输出结果总是显示：

__cplusplus value: 199711

这个数字对应的是1997年11月发布的C++98标准。这种现象并非bug，而是微软有意为之的设计决策。

1.1 微软的兼容性考量

微软官方文档明确指出，许多现有代码库严重依赖__cplusplus宏返回199711这个特定值。如果突然改变这个默认行为，可能导致大量遗留代码无法正常工作。因此，VS编译器团队决定：

• 保持向后兼容性为首要原则
• 默认禁用__cplusplus宏的更新功能
• 提供显式选项让开发者自主选择

提示：这种设计哲学在编译器开发中很常见——稳定性和兼容性往往比紧跟最新标准更重要。

2. 解决方案：启用正确的宏报告

要让__cplusplus宏正确反映当前C++标准版本，需要进行特定的编译器配置。以下是详细的操作步骤：

2.1 方法一：通过项目属性配置

1. 打开项目属性：

   • 右键点击解决方案资源管理器中的项目
   • 选择"属性"(Properties)

2. 导航到编译器设置：

   • 选择"配置属性" → "C/C++" → "命令行"
   • 在"附加选项"框中添加：/Zc:__cplusplus

3. 验证配置：

   • 确保配置适用于当前活动平台（如Debug x64）
   • 可以同时设置多个配置的平台

配置完成后，重新编译项目，__cplusplus宏现在应该能正确显示当前C++标准版本了。

2.2 方法二：使用_MSVC_LANG替代宏

如果你不想修改编译器选项，微软提供了替代方案——_MSVC_LANG预定义宏。这个宏不受/Zc:__cplusplus选项影响，始终会返回当前C++标准版本。

#include <iostream> int main() { std::cout << "_MSVC_LANG value: " << _MSVC_LANG << std::endl; return 0; }

_MSVC_LANG与__cplusplus的对应关系如下：

3. 深入理解编译器选项

/Zc:__cplusplus这个编译器选项自Visual Studio 2017 15.7版本开始引入，但默认处于禁用状态。它的行为与其他相关选项的关系值得深入探讨。

3.1 与/std选项的联动

/Zc:__cplusplus必须与/std选项配合使用才能生效。以下是它们的组合效果：

3.2 与/permissive-的关系

一个常见的误解是/permissive-选项会自动启用/Zc:__cplusplus。实际上：

• /permissive-仅启用标准一致性模式
• 不会自动开启/Zc:__cplusplus
• 两者需要分别配置

4. C++标准版本对照表

为了帮助开发者准确识别当前使用的C++标准，以下是完整的版本对照表：

注意：VS对某些标准的支持是逐步完善的，即使设置了相应标准，也可能不是100%功能完整。

5. 实际开发中的最佳实践

基于对__cplusplus宏行为的深入理解，以下是针对不同场景的实用建议：

5.1 新项目配置

对于全新项目，推荐采用以下配置组合：

1. 在项目属性 → C/C++ → 语言中：

   • 设置"C++语言标准"为所需版本（如/std:c++17）

2. 在项目属性 → C/C++ → 命令行中：

   • 添加/Zc:__cplusplus
   • 添加/permissive-（如需严格标准符合）

// 版本检查示例 #if __cplusplus >= 201703L // C++17或更高版本的代码 #elif __cplusplus >= 201402L // C++14代码 #else #error "需要C++14或更高版本" #endif

5.2 跨平台兼容性处理

如果需要编写跨平台代码，考虑以下策略：

• 使用特性检测而非版本检测
• 结合_MSC_VER进行编译器特定判断
• 为不同平台提供适当的回退方案

#if defined(_MSC_VER) #if _MSC_VER >= 1920 && defined(_MSVC_LANG) constexpr long cpp_standard = _MSVC_LANG; #else constexpr long cpp_standard = __cplusplus; #endif #else constexpr long cpp_standard = __cplusplus; #endif

5.3 构建系统集成

在CMake等构建系统中，可以这样配置：

if(MSVC) add_compile_options(/Zc:__cplusplus) # 或者针对特定目标 target_compile_options(my_target PRIVATE /Zc:__cplusplus) endif()

6. 高级话题：编译器内部机制

对于那些对编译器工作原理感兴趣的开发者，让我们简单探讨一下这个功能在MSVC中的实现方式。

6.1 预定义宏的处理流程

1. 预处理阶段：编译器识别__cplusplus宏
2. 选项检查：查看是否启用了/Zc:__cplusplus
3. 版本映射：根据/std选项确定最终值
4. 宏展开：替换为相应的长整型字面量

6.2 与其他宏的交互

__cplusplus不是孤立存在的，它与以下宏有密切关系：

• _MSVC_LANG：始终反映实际标准版本
• _MSC_VER：表示编译器版本
• _HAS_CXX17等：特性测试宏

// 综合判断示例 #if defined(_MSC_VER) && _MSC_VER >= 1914 && _MSVC_LANG >= 201703L #define HAS_FILESYSTEM 1 #endif

7. 历史背景与未来展望

理解这个问题的历史背景有助于我们更好地把握C++生态的发展脉络。

7.1 标准化进程中的挑战

C++标准化过程中的几个关键节点：

• 1998：首个ISO标准(C++98)
• 2011：重大更新的C++11
• 2017：特性完备的C++17
• 2020：引入概念的C++20

每个新标准都带来了大量新特性，但也增加了编译器的实现难度。

7.2 微软的兼容性策略演变

Visual C++团队在标准支持上的策略变化：

这种渐进式的支持策略解释了为什么__cplusplus宏的行为需要特别配置。