Windows环境pip安装Python包fast_slic报C1083错误如何解决

报错原因 #

fast_slic包含C语言扩展模块，安装时需要本地编译，报错fatal error C1083: 无法打开包含文件'basetsd.h'是因为已安装的Visual Studio生成工具缺少Windows SDK组件，basetsd.h是Windows SDK的标准头文件，编译时无法检索到该文件路径导致构建失败。

解决步骤 #

方案1：补全Visual Studio生成工具组件（推荐） #

• 打开已安装的Microsoft Visual Studio Installer，找到已安装的「Visual Studio 2019 生成工具」，点击右侧「修改」按钮
• 切换到「工作负荷」标签页，勾选「使用C++的桌面开发」 workload
• 确认右侧安装详情中，已勾选对应版本的Windows 10 SDK（Windows 11系统也可安装适配的Windows 10 SDK，选择最新推送的版本即可）
• 点击右下角「修改」按钮等待组件安装完成，安装完成后重启操作系统
• 重新打开终端执行pip install fast_slic即可

方案2：使用VS原生命令行工具执行安装 #

如果安装完SDK后仍然报错，可通过VS专属命令行指定编译环境执行安装：

• 在Windows开始菜单中找到「x64 Native Tools Command Prompt for VS 2019」并打开
• 在弹出的终端窗口中执行pip install fast_slic命令，该终端会自动配置好所有编译所需的头文件、库文件路径，避免找不到SDK组件的问题

验证安装 #

安装完成后执行pip show fast_slic，如果返回包的版本信息即为安装成功。

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