1. 下载 Microsoft Visual C++ Build Tools
打开浏览器,访问 Visual Studio 下载页面。页面上会有一个'下载 Visual Studio'按钮,点击后选择 'Build Tools for Visual Studio 2022'(或者类似版本的 Build Tools)。
2. 安装 Visual C++ Build Tools
下载完成后,运行安装程序 vs_buildtools.exe。在安装界面,你会看到一堆选项。这里别选错了,应该勾选 'C++ build tools'。
重点勾选以下组件:
- MSVC v143 - VS 2022 C++ x64/x86 build tools
- Windows 10 SDK(如果你用的是 Windows 10,具体版本按需选)
- C++ CMake tools for Windows(如果后续要用 CMake 构建工具)
上面这两个是必须的,其他的看需求选就行。点击'安装',安装程序会开始下载和部署。这过程可能有点久,取决于你的网速和机器性能。
3. 配置系统环境变量(通常自动配置)
大多数情况下,安装程序会自动把路径加到系统环境变量里。不过为了保险起见,还是验证一下比较好:
- 右键点击'此电脑'或'我的电脑',选'属性'。
- 点'高级系统设置',再点'环境变量'。
- 在'系统变量'里找到
Path,双击编辑。 - 检查有没有类似
C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\<版本号>\bin\Hostx64\x64的路径。
如果没有,可能需要手动添加,否则编译器找不到。
4. 重启命令提示符或终端
装完别急着用,重启一下你正在用的命令提示符或终端,让新的环境变量生效。
5. 再次安装 insightface
如果前面都顺利,现在应该能正常编译了。打开命令行,试着运行下面这行命令重新安装 insightface:
pip install insightface
按这个流程走一遍,基本就能解决之前遇到的编译报错问题。

