Windows下VS Code中C2016错误处理：让cffi使用GCC编译空结构体

问题背景 #

• 依赖第三方提供的C头文件，其中包含不符合C标准的空结构体，且无法修改这些文件
• Windows环境下VS Code默认使用MSVC编译，触发C2016错误：

  message_definitions.h(45): error C2016: C requires that a struct or union have at least one member

• 示例空结构体定义：

typedef struct {
} Controller_Do_Graceful_Shutdown_t;

• 已确认MSYS2提供的GCC 13.2.0可用
• 使用Python CFFI导入头文件时，ffibuilder默认调用MSVC导致报错，现有CFFI代码：

from cffi import FFI
ffibuilder = FFI()

ffibuilder.set_source("_message_definitions",  # name of the output C extension
"""
    #include "message_definitions.h"
""",
    sources=['message_definitions.c'],
    libraries=[])

if __name__ == "__main__":
    ffibuilder.compile(verbose=True)

解决方案 #

方案1：切换CFFI使用GCC编译 #

有两种方式可以让CFFI调用GCC：

方式A：通过环境变量指定编译器

在运行Python脚本前，在命令行中设置环境变量：

set CC=C:\msys64\ucrt64\bin\gcc.exe
set CXX=C:\msys64\ucrt64\bin\g++.exe

之后直接运行脚本，CFFI会自动读取CC和CXX环境变量，使用指定的GCC编译。

方式B：在代码中设置环境变量

修改CFFI代码，在编译前设置环境变量：

from cffi import FFI
import os

ffibuilder = FFI()

# 指定GCC路径
os.environ['CC'] = 'C:\\msys64\\ucrt64\\bin\\gcc.exe'
os.environ['CXX'] = 'C:\\msys64\\ucrt64\\bin\\g++.exe'

ffibuilder.set_source("_message_definitions",
"""
    #include "message_definitions.h"
""",
    sources=['message_definitions.c'],
    libraries=[])

if __name__ == "__main__":
    ffibuilder.compile(verbose=True)

方案2：抑制MSVC的C2016错误 #

若必须使用MSVC编译，可通过添加编译参数忽略该错误：
修改set_source方法，加入extra_compile_args=['/wd2016']，该参数指示MSVC跳过C2016错误检查：

from cffi import FFI
ffibuilder = FFI()

ffibuilder.set_source("_message_definitions",
"""
    #include "message_definitions.h"
""",
    sources=['message_definitions.c'],
    libraries=[],
    extra_compile_args=['/wd2016']
)

if __name__ == "__main__":
    ffibuilder.compile(verbose=True)

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