1. Windows 10 下 Whisper-CPP 编译安装全记录
最近在 Windows 10 系统上折腾 Whisper-CPP 的安装过程,遇到了不少坑,特别是 CPU 指令集兼容性问题。这里把完整的安装过程和解决方案整理出来,希望能帮到有同样需求的朋友。
Whisper-CPP 是 OpenAI Whisper 语音识别模型的 C++ 实现版本,相比原版 Python 实现,它更轻量、运行效率更高,特别适合本地部署和开发集成。下面是我在 Intel Xeon E5-2643 v2 处理器(Ivy Bridge 架构)的 Windows 10 机器上的完整安装过程。
1.1 环境准备与工具安装
首先需要准备必要的开发工具链。由于我的系统是新装的,几乎什么开发环境都没有,所以从头开始:
- 安装 CMake:从官网下载最新版 CMake(我用的 3.31.5),选择添加到系统 PATH
- 安装 Visual Studio 2022:社区版即可,安装时务必勾选"使用 C++ 的桌面开发"工作负载
- Git:用于克隆仓库,可以从 Git 官网安装
注意:如果你的机器性能一般,Visual Studio 安装会比较耗时,建议在空闲时进行。我安装时选择了最小化安装,只勾选了必要的 MSVC 编译器和 CMake 支持。
验证工具是否安装成功:
bash复制cmake --version # 应显示 CMake 版本
cl # 应显示 MSVC 编译器信息
git --version # 应显示 Git 版本
1.2 源代码获取与初步尝试
直接从 GitHub 克隆 whisper.cpp 仓库:
bash复制git clone https://github.com/ggerganov/whisper.cpp
cd whisper.cpp
第一次尝试编译(失败):
bash复制cmake -B build
cmake --build build -j --config Release
这里遇到了第一个坑——我的 CPU(Xeon E5-2643 v2)不支持 AVX2 指令集,而默认编译选项会启用 AVX2,导致运行时出现"Illegal ins
