WSL 配置

WSL DNS PATH 配置

本文档用于说明 WSL(Windows Subsystem for Linux)中 /etc/wsl.conf 文件内各配置项的作用及影响。

配置如下:

1
2
3
4
5
[network]
generateResolvConf = false

[interop]
appendWindowsPath = false

一、[network] 网络相关配置

generateResolvConf = false

作用:
禁止 WSL 在启动时自动生成 /etc/resolv.conf 文件。

默认行为(true):

  • WSL 启动时会根据 Windows 当前网络状态自动生成 /etc/resolv.conf
  • 通常使用 Windows 的 DNS(例如 VPN 或公司内网 DNS)

设置为 false 后:

  • 不再自动覆盖 /etc/resolv.conf
  • DNS 完全由用户手动维护
  • 适用于代理、IPTV、Docker、服务器等场景

示例:

1
2
nameserver 1.1.1.1
nameserver 8.8.8.8

二、[interop] Windows 与 Linux 互操作

appendWindowsPath = false

作用:
禁止将 Windows 的 PATH 环境变量追加到 WSL 的 PATH 中。

默认行为(true):

  • Windows 的可执行程序会出现在 WSL 的 PATH 中
  • 可能导致命令冲突(如 curl、git)

设置为 false 后:

  • 仅使用 Linux 自身的 PATH
  • 环境更干净、稳定
  • 适合开发与服务器运行环境

三、配置生效

修改 /etc/wsl.conf 后执行:

1
wsl --shutdown

重新进入 WSL 后配置生效。