告别双系统！用winget一键安装usbipd-win实现WSL2完美支持USB设备-编程实验室

告别双系统！用winget一键安装usbipd-win实现WSL2完美支持USB设备

还在为开发过程中频繁切换双系统而烦恼吗？WSL2的出现本应让Linux开发环境与Windows无缝融合，但USB设备支持一直是困扰开发者的痛点。传统解决方案要么性能低下，要么配置复杂，直到usbipd-win的出现彻底改变了这一局面。本文将带你探索如何利用Windows原生包管理器winget，以最简流程实现WSL2对USB设备的完美支持，从此告别双系统切换的繁琐。

1. 为什么选择winget安装usbipd-win

在开源社区中，usbipd-win已经成为WSL2用户连接USB设备的事实标准工具。这个由微软工程师开发的工具通过USB/IP协议实现了Windows与WSL2之间的USB设备共享。传统安装方式需要手动下载.msi安装包，而使用winget则带来了三大显著优势：

一键安装：无需手动下载、验证安装包，避免版本混淆和下载错误
自动更新：通过winget upgrade命令可轻松保持工具最新状态
可脚本化：适合批量部署和自动化环境配置

更重要的是，winget作为微软官方推出的包管理器，其软件源经过严格审核，从根本上杜绝了恶意软件的风险。对于经常需要配置开发环境的技术人员来说，这种安装方式既安全又高效。

2. 环境准备与工具安装

2.1 系统要求检查

在开始之前，请确保你的系统满足以下基本要求：

Windows 10 2004或更高版本（建议使用Windows 11）
已启用WSL2功能并安装Linux发行版
PowerShell 7.0+（推荐）或Windows Terminal
管理员权限（仅安装阶段需要）

可以通过以下命令快速验证WSL版本：

wsl --list --verbose

输出应显示你的Linux发行版和"2"版本标识。如果仍在使用WSL1，建议先升级：

wsl --set-version <发行版名称> 2

2.2 使用winget安装usbipd-win

打开管理员模式的PowerShell，执行以下命令：

winget install --interactive --exact dorssel.usbipd-win

这个命令会：

自动从微软官方源获取最新稳定版
显示安装进度和确认提示（因--interactive参数）
将usbipd-win添加到系统PATH，无需手动配置

安装完成后，可以通过以下命令验证：

usbipd --version

注意：如果遇到"无法识别命令"错误，请尝试重启终端或检查系统PATH是否包含usbipd-win的安装路径（通常为C:\Program Files\usbipd-win）

3. USB设备连接全流程指南

3.1 设备识别与绑定

首先连接你的USB设备（如Arduino、USB转串口工具等），然后在管理员PowerShell中运行：

usbipd list

你将看到类似如下的输出：

BUSID VID:PID DEVICE STATE 1-1 0403:6001 Future Technology Device Int... Not shared 1-2 046d:c52b Logitech USB Receiver Not shared

记录下目标设备的BUSID（如1-1），然后执行绑定命令：

usbipd bind --busid <BUSID>

成功绑定后，设备状态将变为"Shared"。此时Windows会释放该设备，准备被WSL2连接。

3.2 WSL端设备连接

在WSL2终端中（Ubuntu等发行版），首先确保已安装usbip工具：

sudo apt update && sudo apt install linux-tools-generic hwdata sudo update-alternatives --install /usr/local/bin/usbip usbip /usr/lib/linux-tools/*-generic/usbip 20

然后回到Windows PowerShell，获取WSL2的IP地址：

wsl hostname -I

在WSL终端中，使用以下命令连接设备：

sudo usbip attach -r <WSL_IP> -b <BUSID>

连接成功后，在WSL中运行lsusb即可看到设备。现在你可以像在原生Linux中一样使用这个USB设备了。

3.3 设备断开与状态管理

当使用完毕后，可以选择以下任一方式断开连接：

优雅断开（推荐）：
```
usbipd detach --busid <BUSID>
```
物理断开：直接拔除设备
强制解除绑定：
```
usbipd unbind --busid <BUSID>
```

提示：频繁插拔同一设备可能导致BUSID变化。建议在脚本中使用usbipd list命令动态获取BUSID，而非硬编码。

4. 高级配置与疑难解答

4.1 自动化脚本示例

对于需要频繁连接相同设备的用户，可以创建PowerShell脚本自动化整个过程：

# 自动连接指定设备到WSL2 $deviceName = "Arduino Uno" $busid = (usbipd list | Where-Object { $_.DEVICE -like "*$deviceName*" }).BUSID usbipd bind --busid $busid $wslIp = (wsl hostname -I).Trim() wsl -e sudo usbip attach -r $wslIp -b $busid

4.2 常见问题解决方案

问题1：WSL中无法识别已连接的USB设备

解决方案：
1. 确认WSL2内核版本支持USB/IP：
```
uname -a
```
  应显示5.10.16.3或更高版本
2. 检查usbip内核模块是否加载：
```
lsmod | grep usbip
```
  如果没有输出，尝试：
```
sudo modprobe usbip-core sudo modprobe usbip-host
```

问题2：usbip attach命令报错"Connection refused"

可能原因：Windows防火墙阻止了连接

解决方案：添加防火墙规则允许WSL2子网：

New-NetFirewallRule -DisplayName "WSL2 USBIP" -Direction Inbound -LocalPort 3240 -Protocol TCP -Action Allow

4.3 VSCode集成技巧

对于使用VSCode进行开发的用户，可以创建任务自动化USB设备连接：

在.vscode/tasks.json中添加：

{ "label": "Connect USB Device", "type": "shell", "command": "powershell.exe", "args": [ "-Command", "usbipd bind --busid <BUSID>; $wslIp = (wsl hostname -I).Trim(); wsl -e sudo usbip attach -r $wslIp -b <BUSID>" ], "problemMatcher": [] }