如何将Docker卷挂载到WSL 2发行版？

一、将Docker卷挂载到WSL 2发行版（消除挂载警告） #

挂载到Windows本地盘触发警告的核心原因是跨NTFS和ext4文件系统导致性能损耗，按以下步骤操作即可规避：

• 首次使用先打开PowerShell，执行wsl命令进入WSL终端，按照提示设置用户名和密码（记住自己设置的用户名，后续路径会用到）
• 在WSL终端中执行mkdir -p ~/docker_volumes，命令执行完成就会在WSL文件系统中创建专门用于Docker挂载的目录
• 挂载路径支持两种写法，均可正常使用无警告：
  1. WSL终端内执行：docker run -v ~/docker_volumes/你的项目目录:/容器内目标路径 镜像名称
  2. PowerShell内执行：docker run -v \\wsl$\你的发行版名称\home\你的WSL用户名\docker_volumes\你的项目目录:/容器内目标路径 镜像名称
     默认安装的WSL发行版一般为Ubuntu，不知道发行版名称的可以在PowerShell执行wsl -l -v查看NAME列的内容

二、解决PowerShell执行Docker命令无法访问WSL 2文件系统的问题 #

按优先级依次排查以下配置：

• 检查Docker Desktop的WSL集成开关：打开Docker Desktop → 设置 → Resources → WSL Integration，开启对应WSL发行版的集成开关，点击Apply & Restart重启Docker生效
• 确认WSL路径可访问：在PowerShell执行dir \\wsl$\，如果能看到对应WSL发行版的文件夹，说明路径正常；如果看不到，先执行一次wsl启动WSL发行版后再试
• 如需用相对路径挂载，可先在PowerShell执行cd \\wsl$\你的发行版名称\home\你的WSL用户名\docker_volumes切换到WSL目录下，再执行docker run命令即可正常识别相对路径

新手操作提示 #

• 所有需要挂载给Docker的读写文件都建议放到WSL的docker_volumes目录下，不要挂载Windows本地C/D盘的路径，可避免90%的性能问题和权限问题
• 如需在Windows中编辑WSL内的文件，直接通过\\wsl$\路径访问操作即可，和操作本地文件无差异

内容的提问来源于stack exchange，提问作者AxD