Windows系统安装apex报vcvarsall.bat缺失错误如何解决

1. 安装匹配的Microsoft Visual C++编译环境 #

• 打开Visual Studio Installer，选择修改现有安装，或者全新安装Visual Studio社区版
• 工作负载选项中勾选「使用C++的桌面开发」，该组件默认包含VC 14.2+版本工具集、对应版本Windows SDK、vcvarsall.bat等编译必要组件
• 完成安装后重启电脑，确保系统环境变量自动更新生效

2. 验证编译环境可用性 #

• 打开你要安装apex的Python虚拟环境对应的终端，执行cl命令，无「不是内部或外部命令」提示即说明编译环境配置正常
• 如果仍提示找不到vcvarsall.bat，手动将VC工具集Build目录添加到系统环境变量Path中，默认路径格式为C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build，可根据你安装的VS版本、版本号、安装位置调整对应路径

3. 重新编译安装Apex #

• 将apex官方源码拉取到本地，进入源码根目录
• 确认当前终端已激活目标Python虚拟环境，同时CUDA环境变量配置正常，执行nvcc -V确认CUDA版本和你已安装的PyTorch版本完全匹配
  安装前请确认PyTorch版本和CUDA版本完全匹配，否则编译完成后也会出现运行时异常
• 执行带扩展的编译安装命令：pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" .

如果你不需要使用CUDA和C++扩展功能，可直接执行简化安装命令跳过编译环节：pip install apex，大幅降低报错概率

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