Skip to main content

概述

在 Windows + WSL 上,USB 设备不会自动在 Linux 子系统内可见。usbipd-win 工具通过环回 IP 隧道将 USB 总线从 Windows 主机转发到 WSL,从而弥补这一差距。
必须已安装 usbipd-win。如果尚未安装,请在 Windows 管理员终端中运行 winget install usbipd-win。

分步操作

1

列出可用的 USB 设备

记下您的 Qualcomm 设备的 BUSID。
2

绑定设备(持久,一次性)

绑定在重启后保持有效。如果您的设备提供多种 USB 模式,请对每个 BUSID 各绑定一次。
在某些企业计算机上,usbipd bind 或后续的附加步骤可能因防火墙策略而失败。如果看到明确的防火墙错误,请按照下面的企业防火墙变通方案操作。
3

使用自动重新附加将设备附加到 WSL

  • 保持此 PowerShell 窗口打开 — 关闭它会停止自动附加循环。
  • 每次重启 WSL 后都必须重新运行此命令。
  • 如果更换了物理 USB 端口,请从头重新运行所有 usbipd 命令。
以下展示了完整的绑定和附加流程:usbipd — 绑定和附加命令
4

在 WSL 内验证设备

在您的 WSL 终端中:
您应该看到列出了您的 Qualcomm 设备。

企业防火墙变通方案

  1. 关闭所有打开的 WSL 终端。
  2. 在 PowerShell 中关闭 WSL:
  1. 编辑 %UserProfile%\.wslconfig 并添加:
  1. 重启 WSL:
  1. 重试 usbipd bind 和 usbipd attach 步骤。

完成后分离/解绑