Windows下pip安装pyk4a报C1083 io.h缺失编译错误求助

问题场景 #

执行以下pip命令安装pyk4a库：

pip install pyk4a --no-use-pep517 --global-option=build_ext --global-option="-IC:\Program Files\Azure Kinect SDK v1.4.1\sdk\include" --global-option="-LC:\Program Files\Azure Kinect SDK v1.4.1\sdk\windows-desktop\amd64\release\lib"

安装过程中编译C扩展失败，核心报错：

c:\users\abdel nasser\desktop\python\python38\include\pyconfig.h(59): fatal error C1083: Cannot open include file: 'io.h': No such file or directory
error: command 'C:\\Program Files (x86)\\Microsoft Visual Studio\\2022\\BuildTools\\VC\\Tools\\MSVC\\14.32.31326\\bin\\HostX86\\x64\\cl.exe' failed with exit code 2

已安装的C++生成工具截图

故障原因 #

报错与pyk4a库无关，是本地Visual Studio 2022生成工具缺少Windows SDK组件导致：
io.h是Windows SDK提供的系统头文件，不属于MSVC编译器核心组件，仅安装C++生成工具时如果未勾选对应Windows SDK，编译Python C扩展就会触发该找不到头文件的错误。

修复步骤 #

• 打开Visual Studio Installer，找到已安装的Visual Studio 2022 Build Tools，点击「修改」
• 切换到「单个组件」页，勾选10.0.19041.0及以上版本的Windows 10 SDK（若使用Win11可勾选对应版本的Windows 11 SDK），同时确认已勾选MSVC v143 - VS 2022 C++ x64/x86 生成工具
• 点击「修改」等待组件安装完成
• 关闭所有已打开的终端窗口，重新打开PowerShell后重新执行pyk4a安装命令即可

如果安装SDK后仍报错，执行安装命令前先在当前终端运行VS环境配置脚本（根据自身安装路径调整版本号）：

& "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvars64.bat"

脚本执行完成后不要关闭终端，直接运行pip安装命令即可正常编译。

补充说明：日志中反复出现的Ignoring invalid distribution -ywin32警告不影响本次安装，要消除该警告只需进入Python安装目录下的site-packages文件夹，删除所有名称以~ywin32开头的临时目录即可。

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