wsl2需与宿主机共享局域网ip以实现无缝网络访问，推荐启用mirrored模式：确保win11 23h2+、创建.wslconfig配置networkingmode=mirrored并重启wsl；若不生效需检查文件路径与扩展名；桥接模式需hyper-v配合静态ip配置。
在Windows 11上调试本地API、部署测试Web服务或让同事用手机直连WSL2里的开发环境时，必须让WSL2拥有和宿主机完全一致的局域网IP，否则每次都要手动查IP、配端口转发、改hosts，甚至连不上NAS或打印机——这问题根源在于WSL2默认活在NAT隔离的私有子网里。
确认系统与功能支持
打开PowerShell，运行winver，确保版本号≥23H2（即内部版本22631或更高）。低于此版本不支持networkingMode=mirrored，强行配置将被忽略。
执行wsl --list --verbose，确认当前发行版状态为Running。若为Stopped，先运行wsl启动一次再继续。
启用镜像网络模式（推荐首选）
这是微软原生支持、无需Hyper-V管理器操作、零额外权限的方案，适用于95%的日常开发场景。
在Windows用户目录（如C:\Users\YourName）下新建纯文本文件，命名为.wslconfig（注意开头是英文点号，无扩展名）。
用记事本或VS Code打开该文件，写入以下内容：
[wsl2] networkingMode=mirrored dnsTunneling=true firewall=true autoProxy=true
保存后，以管理员身份打开PowerShell，执行：wsl --shutdown → 等待终端返回提示符 → 再输入wsl重新启动实例。
进入WSL2终端，运行ip addr show eth0 | grep "inet "，输出的IPv4地址必须与Windows宿主机ipconfig中无线网卡/有线网卡的IPv4地址完全一致（例如都是192.168.1.10）。若仍显示172.x.x.x，说明.wslconfig未被读取——检查文件是否藏在OneDrive同步文件夹内（会因路径重定向失效），或文件名误存为.wslconfig.txt。
桥接模式（需Hyper-V且适用特殊网络环境）
当镜像模式不可用（如企业域控策略禁用）、或需WSL2获得独立MAC地址参与DHCP续租时，才启用此模式。
方法一：创建外部虚拟交换机
① 以管理员身份打开「Hyper-V 管理器」→ 左侧选中本机名 → 右侧点击「虚拟交换机管理器」→ 「新建虚拟网络交换机」→ 类型选「外部」→ 点击「创建虚拟交换机」。
② 名称填wsl-bridge（后续配置强依赖此名称，大小写敏感）→ 外部网络下拉框选择你正在上网的物理网卡（Wi-Fi或以太网）→ 勾选「允许管理操作系统共享此网络适配器」→ 点击「确定」。
方法二：配置.wslconfig启用桥接
编辑C:\Users\YourName\.wslconfig，替换为以下内容：
[wsl2] networkingMode=bridged vmSwitch=wsl-bridge dhcp=false
【vmSwitch名称必须与Hyper-V中创建的完全一致】，否则WSL启动失败并报错VmSwitch not found。
保存后执行wsl --shutdown → 重启WSL → 在WSL中运行sudo nano /etc/wsl.conf，添加：
[network] generateHosts = true generateResolvConf = true
然后执行sudo nano /etc/netplan/01-network-manager-all.yaml，写入静态IP配置（IP、网关、DNS需严格匹配宿主机所在局域网段）：
network:
version: 2
renderer: NetworkManager
ethernets:
eth0:
dhcp4: false
addresses: [192.168.1.110/24]
gateway4: 192.168.1.1
nameservers:
addresses: [192.168.1.1, 8.8.8.8]
最后运行sudo netplan apply生效。此时ip addr应显示你指定的静态IP，且能ping通宿主机和同网段其他设备。
验证外部可访问性
在WSL2中启动一个最简HTTP服务：python3 -m http.server 8000。
在Windows宿主机浏览器访问http://localhost:8000，确认可打开。
在局域网另一台设备（如手机）浏览器中输入宿主机IP加端口，例如http://192.168.1.10:8000，页面成功加载即表示配置完成。
若失败，检查Windows防火墙是否放行TCP 8000端口：「控制面板→系统和安全→Windows Defender 防火墙→高级设置→入站规则→新建规则→端口→TCP 8000→允许连接」。
