pip安装zxing-cpp报错"returned non-zero exit status 1"的完美解决方案
在 Windows 环境下使用 Python 进行开发时，偶尔会遇到一些让人头秃的报错。最近，有小伙伴在尝试通过 pip install zxing-cpp 安装二维码识别库时，遇到了满屏红字的编译失败报错：
returned non-zero exit status 1.
[end of output]
note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for zxing-cpp面对这种"returned non-zero exit status 1"的错误，很多新手往往会感到无从下手。今天这篇博客就来带大家彻底搞懂这个报错的原因，并提供从"秒解决"到"硬核编译"的几种完美方案！
为什么会报错？
简单来说，pip install zxing-cpp 这个命令在后台试图调用 C++ 编译器（比如 Visual Studio 的 MSVC）来从源码编译这个库。报错说明你的电脑环境中缺少必要的编译工具链，或者 pip 没有找到适配你当前 Python 版本的预编译包（Wheel），导致它被迫尝试本地编译，最终中途崩溃。
方案一：强制安装预编译包（最推荐，秒解决）
通常情况下，pip 会自动下载对应你 Python 版本的预编译包（.whl 文件），里面已经包含了编译好的库，无需你在本地折腾。报错往往是因为 pip 尝试去下载源码包了。
你可以尝试强制只安装二进制包，跳过编译步骤：
pip install zxing-cpp --prefer-binary如果依然报错，大概率是因为你的 Python 版本（比如报错日志中的 cpython-38，即 Python 3.8）在 zxing-cpp 的官方仓库里，暂时没有提供对应 Windows 系统的预编译包。这时候，请看方案二。
方案二：升级 Python 版本（根治方案）
zxing-cpp 对较新的 Python 版本支持更好。Python 3.8 相对较老，很多现代 C++ 库的预编译包已经不再为它提供。
强烈建议你升级 Python 到 3.10 或 3.11 版本 。升级后，在一个新的虚拟环境中再次执行 pip install zxing-cpp，大概率就能直接秒装成功，完全不需要经历复杂的编译过程。这是最省心省力的办法！
方案三：手动配置 Windows 编译环境（硬核方案）
如果你因为项目限制，必须死磕 Python 3.8，那就必须把你的电脑变成一台合格的 C++ 编译机。你需要完成以下两步：
- 安装 C++ 编译工具 ：
前往微软官网下载并安装 Visual Studio 2022 Community（社区版） 。在安装选项中，必须勾选"使用 C++ 的桌面开发" 这一 workload。 - 安装 CMake ：
去 CMake 官网下载并安装 Windows 版本的 CMake，安装时记得勾选"将 CMake 添加到系统环境变量 PATH"。
安装完上述工具后，重启电脑 ，然后重新打开命令行执行 pip install zxing-cpp，通常就能顺利编译通过。
方案四：检查并安装基础依赖
有时候缺少基础的构建工具也会导致这个问题。你可以先运行以下命令，把 Python 的构建依赖补齐：
pip install --upgrade pip setuptools wheel cmake然后再尝试安装 zxing-cpp。
总结
遇到 returned non-zero exit status 1 这种编译报错不要慌。最省心的办法就是换用 Python 3.10 或 3.11；如果换不了，就得老老实实去安装 Visual Studio 的 C++ 开发环境。希望这篇博客能帮你快速搞定环境配置，愉快地开始二维码识别开发！