Python 3.12.1下安装imagededup遇wheel构建失败问题求助

1. 正确配置Visual Studio Build Tools #

• 先卸载已装的Visual Studio Build Tools，重新下载最新版本
• 安装时**必须勾选「C++桌面开发」**这个工作负载，还要确保勾选以下组件：
  • MSVC v143 - VS 2022 C++ x64/x86生成工具（选对应版本的最新版即可）
  • 匹配你系统的Windows SDK（比如Windows 11 SDK）
  • C++ CMake工具 for Windows
• 安装完成后重启电脑，让环境变量生效

2. 修复Python依赖工具 #

• 打开管理员权限的命令提示符，先修复pip：

  python -m ensurepip --upgrade
  

• 升级setuptools和wheel——这俩是构建wheel包的核心，必须更到最新：

  python -m pip install --upgrade setuptools wheel
  

3. 用预编译wheel绕过本地编译 #

• 找到对应Python3.12、amd64架构的imagededup预编译wheel文件（去Python官方的wheel仓库搜索）
• 下载后用本地文件安装，命令示例：

  pip install 你下载的wheel文件路径\imagededup-xxx-cp312-none-win_amd64.whl
  

• 如果找不到3.12的预编译包，可临时降级到Python3.11再安装，imagededup对3.11的支持更成熟

4. 清理错误操作的残留 #

• 清空pip缓存，避免错误缓存干扰安装：

  pip cache purge
  

• 用pip list检查已装包，如果有损坏的imagededup相关条目，用pip uninstall imagededup彻底卸载

5. 最后重试安装 #

• 所有配置完成后，执行标准安装命令：

  pip install imagededup
  

内容的提问来源于stack exchange，提问作者Ricardo Sousa Ribeiro