Node.js升级后node-gyp编译遇C2872 'byte'歧义符号错误求解决方案

我们正在将基于VS2010的C与Node.js混合应用从Node.js 0.10.26升级至Node.js 18.12.1 LTS版本，使用node-gyp@9.3.1、Python 3.11.1及VS2019（版本16.11.32929.386）编译C addon时，执行node-gyp build触发如下编译错误：

C:\Program Files (x86)\Windows Kits\10\Include\10.0.19041.0\shared\rpcndr.h(192,14): error C2872: 'byte': ambiguous symbol 
C:\Program Files (x86)\Windows Kits\10\Include\10.0.19041.0\shared\rpcndr.h(191,23): message : could be 'unsigned char byte' 
C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC\Tools\MSVC\14.29.30133\include\cstddef(28,12): message : or       'std::byte' 
C:\Program Files (x86)\Windows Kits\10\Include\10.0.19041.0\shared\rpcndr.h(962,25): error C2872: 'byte': ambiguous symbol 
C:\Program Files (x86)\Windows Kits\10\Include\10.0.19041.0\shared\rpcndr.h(191,23): message : could be 'unsigned char byte' 

我们已尝试过相关社区方案但均无效，恳请提供可行解决办法。

方案1：通过预定义宏消除符号歧义 #

在项目的binding.gyp文件中添加预编译宏，强制将byte映射为unsigned char，避免与C++17引入的std::byte冲突：

{
  "targets": [
    {
      "target_name": "your_addon_name",
      "defines": [
        "_HAS_STD_BYTE=0",
        "byte=unsigned char"
      ],
      // 其他原有配置...
    }
  ]
}

添加后重新执行node-gyp clean && node-gyp configure && node-gyp build。

方案2：指定C标准版本为C14及以下 #

std::byte是C17新增特性，将编译标准降至C14可避免该符号出现。修改binding.gyp：

{
  "targets": [
    {
      "target_name": "your_addon_name",
      "cflags_cc": ["/std:c++14"],
      "msvs_settings": {
        "VCCLCompilerTool": {
          "AdditionalOptions": ["/std:c++14"]
        }
      },
      // 其他原有配置...
    }
  ]
}

方案3：升级Windows SDK版本 #

当前使用的Windows SDK版本为10.0.19041.0，该版本存在头文件符号冲突问题。升级至10.0.22000.0及以上版本（可通过VS2019的安装程序更新），新版本已修复该歧义问题。

方案4：调整头文件包含顺序 #

在你的C++ addon源码中，确保Windows SDK相关头文件（如rpcndr.h）在C++标准库头文件（如<cstddef>）之前包含，避免std::byte先被引入导致冲突。

内容的提问来源于stack exchange，提问作者Shilpa