Windows使用pip安装vllm时候报错

vLLM Windows 构建错误解决方案

您遇到的 vLLM 构建错误，具体表现为 error: could not create 'build\bdist.win-amd64\wheel\.\vllm\model_executor\layers\fused_moe\configs\E=128,N=704,device_name=NVIDIA_RTX_PRO_6000_Blackwell_Workstation_Edition,dtype=fp8_w8a8.json': No such file or directory，通常是由于 Windows 操作系统默认的文件路径长度限制（通常为 260 个字符）所导致的。vLLM 在构建过程中会生成包含详细配置信息的文件，这些文件的路径有时会超出 Windows 的默认限制，从而导致文件创建失败。

解决方案：启用 Windows 长路径支持

解决此问题的最直接方法是启用 Windows 的长路径支持。这可以通过修改注册表或使用 PowerShell 命令来完成。以下是推荐的 PowerShell 方法：

步骤 1：以管理员身份运行 PowerShell

在 Windows 搜索栏中输入 PowerShell，右键点击 Windows PowerShell，然后选择 以管理员身份运行。

步骤 2：执行 PowerShell 命令

在 PowerShell 窗口中，复制并粘贴以下命令，然后按 Enter 键执行：

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" `
-Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

此命令会在注册表路径 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem 下创建一个名为 LongPathsEnabled 的 DWORD 值，并将其设置为 1，从而启用长路径支持。如果该值已存在，此命令会强制更新其值。

步骤 3：验证注册表设置（可选）

您可以通过以下步骤手动验证注册表是否已成功修改：

1. 按下 Win + R 键，输入 regedit，然后按 Enter 键打开注册表编辑器。
2. 导航到 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem。
3. 在右侧窗格中查找 LongPathsEnabled。其 数据 列应显示为 0x00000001 (1)。

步骤 4：重启系统（推荐）

为了确保更改完全生效，建议您重启计算机。

步骤 5：重新尝试安装 vLLM

重启后，您可以再次尝试安装 vLLM。例如，使用 pip install vllm。

替代方案：使用 Windows Subsystem for Linux (WSL)

vLLM 官方文档推荐在 Windows 上使用 Windows Subsystem for Linux (WSL) 进行安装和运行。WSL 提供了一个兼容的 Linux 环境，可以更好地处理文件路径和依赖关系，从而避免 Windows 特有的构建问题。如果您在启用长路径支持后仍然遇到问题，或者希望获得更稳定的 vLLM 运行环境，强烈建议您考虑使用 WSL。

参考文献

[1] Error occured while installing vllm · Issue #14124 - GitHub
[2] Enable long paths in Windows 10, version 1607, and later - Microsoft Learn
[3] GPU - vLLM Documentation