Docker开源项目解析：Windows WSL2环境配置与开发实践

引言

对于Windows平台的开发者来说，Docker与WSL2的结合提供了接近原生Linux的开发体验。本文将手把手教你如何在Windows WSL2环境中配置Docker开发环境，并通过一个实际项目演示完整的开发流程。

准备工作

系统要求

Windows 10版本2004或更高/Windows 11
至少4GB内存（推荐8GB以上）
已启用BIOS中的虚拟化支持

前置检查

确认WSL功能已启用：
代码片段
```
wsl --list --verbose
```
如果没有安装WSL，使用管理员权限运行：
代码片段
```
wsl --install
```
确保是WSL2版本（如果不是，使用wsl --set-version <发行版> 2转换）

WSL2环境配置

1. 安装Linux发行版

推荐使用Ubuntu作为开发环境：

代码片段

wsl --install -d Ubuntu-22.04

安装完成后设置用户名和密码。

2. Docker Desktop安装与配置

下载Docker Desktop
安装时勾选”Use WSL 2 based engine”
打开设置 → Resources → WSL Integration，启用你的Ubuntu发行版

验证安装：

代码片段

docker --version
docker-compose --version

Docker开发实践：构建Python Web应用

项目结构准备

代码片段

mkdir docker-wsl-demo && cd docker-wsl-demo
touch Dockerfile docker-compose.yml app.py requirements.txt

目录结构：

代码片段

.
├── Dockerfile          # Docker构建文件
├── docker-compose.yml  # compose配置文件 
├── app.py              # Flask应用代码
└── requirements.txt    # Python依赖项

app.py (Flask示例应用)

代码片段

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return "Hello from Docker on WSL2!"

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

requirements.txt

代码片段

flask==2.3.2

Dockerfile配置

代码片段

# 使用官方Python基础镜像
FROM python:3.9-slim

# 设置工作目录
WORKDIR /app

# 复制依赖文件并安装
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制应用代码
COPY . .

# 暴露端口5000（Flask默认端口）
EXPOSE 5000

# 启动命令
CMD ["python", "app.py"]

docker-compose.yml配置

代码片段

version: '3.8'

services:
  web:
    build: .
    ports:
      - "5000:5000"
    volumes:
      - .:/app
    environment:
      - FLASK_ENV=development

运行与测试

构建并启动容器：
代码片段
```
docker-compose up --build -d 
```
查看运行状态：
代码片段
```
docker-compose ps 
```
访问应用：
在浏览器打开 http://localhost:5000
查看日志：
代码片段
```
docker-compose logs -f web 
```
停止服务：
代码片段
```
docker-compose down 
```

WSL2特有优化建议

性能优化：将项目文件放在WSL文件系统中（如/home/username/projects），而不是Windows挂载的目录（如/mnt/c/...）
内存限制：在%UserProfile%\.wslconfig中添加：
代码片段
```
[wsl2]
memory=6GB  
processors=4  
swap=4GB  
localhostForwarding=true  
```
磁盘空间管理：定期清理未使用的容器和镜像：
代码片段
```
docker system prune -a 
```

FAQ常见问题解决

Q1: Docker命令提示权限不足

代码片段

sudo usermod -aG docker $USER && newgrp docker

Q2: WSL2中端口无法访问
检查Windows防火墙设置，或尝试重启Docker服务：service docker restart

Q3: IO性能慢
确保项目文件在WSL文件系统内（如~/projects），而不是在/mnt/c/...

VS Code集成开发（可选）

安装”Remote – WSL”扩展
Ctrl+Shift+P → “Remote-WSL: New Window”
VS Code会自动识别Docker扩展并提供完整支持

总结

通过本文我们完成了：

Windows WSL2环境的准备与验证
Docker Desktop的集成配置
Python Flask应用的容器化实践
WSL2特有的优化技巧

这种开发模式结合了Windows的易用性和Linux的开发效率，特别适合需要跨平台开发的场景。