Win10系统下使用Docker与WSL2配置Python开发环境的详细步骤
在当今的软件开发领域,容器化和虚拟化技术已经成为提高开发效率和确保环境一致性的重要工具。Docker和Windows子系统 for Linux 2(WSL2)的结合,为Windows 10用户提供了一个强大的开发平台。本文将详细讲解如何在Win10系统下使用Docker与WSL2配置Python开发环境,帮助您快速搭建一个高效、稳定的开发环境。
一、准备工作
系统要求
:
确保您的Win10版本为1903或更高,且已启用WSL2功能。
确保您的CPU支持虚拟化,并在BIOS中启用。
安装WSL2
:
打开 PowerShell(以管理员身份),运行以下命令以启用WSL功能:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
启用虚拟机平台功能:
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
下载并安装WSL2 Linux内核更新包:下载链接。
将WSL2设置为默认版本:
wsl –set-default-version 2
安装Docker Desktop
:
下载并安装Docker Desktop for Windows:下载链接。
安装过程中,确保选择“使用WSL2后端”选项。
二、安装并配置Linux发行版
安装Ubuntu
:
打开Microsoft Store,搜索并安装Ubuntu 20.04 LTS。
安装完成后,启动Ubuntu,完成初始设置(创建用户名和密码)。
更新并升级系统
:
打开Ubuntu终端,运行以下命令更新系统:
sudo apt update
sudo apt upgrade -y
三、配置Docker环境
验证Docker安装
:
在Ubuntu终端中,运行以下命令验证Docker是否已正确安装:
docker –version
配置Docker用户组
:
为了避免每次使用Docker时都需要sudo权限,将当前用户添加到docker组:
sudo usermod -aG docker $USER
重启Ubuntu以使更改生效:
exit
wsl –shutdown
ubuntu
四、搭建Python开发环境
安装Python
:
在Ubuntu终端中,运行以下命令安装Python及其相关工具:
sudo apt install python3 python3-pip -y
创建Dockerfile
:
在Ubuntu的home目录下创建一个新的目录,例如
python-dev
,并进入该目录:
mkdir python-dev
cd python-dev
创建一个名为
Dockerfile
的文件,并添加以下内容:
“`Dockerfile
FROM python:3.9-slim
WORKDIR /app
COPY . /app
RUN pip install –no-cache-dir -r requirements.txt
CMD [“python”, “app.py”]
“`
创建requirements.txt
:
在
python-dev
目录下创建一个名为
requirements.txt
的文件,并添加您项目所需的Python包,例如:
flask
requests
创建示例Python应用
:
创建一个名为
app.py
的文件,并添加以下内容:
“`python
from flask import Flask
app = Flask(
name
)
@app.route(‘/’)
def hello():
return “Hello, Docker and WSL2!”
if
name
== ‘
main
’:
app.run(host=’0.0.0.0′, port=5000)
”`
构建并运行Docker容器
:
在
python-dev
目录下,运行以下命令构建Docker镜像:
docker build -t python-dev .
运行构建好的Docker容器:
docker run -p 5000:5000 python-dev
验证应用运行
:
在Windows浏览器中访问
http://localhost:5000
,如果看到“Hello, Docker and WSL2!”,则说明您的Python开发环境已成功配置。
五、进阶配置与优化
使用VS Code进行开发
:
安装VS Code并安装Remote – WSL扩展。
打开VS Code,使用“Remote – WSL: New Window”功能,选择Ubuntu环境。
在WSL环境中打开
python-dev
目录,进行代码编辑和调试。
数据持久化
:
使用Docker卷(volumes)或绑定挂载(bind mounts)来持久化应用数据。
例如,在运行Docker容器时添加以下参数:
docker run -v /path/to/data:/app/data -p 5000:5000 python-dev
网络配置
:
根据需要配置Docker网络,以实现容器间的通信或与宿主机的通信。
六、常见问题与解决方案
WSL2启动失败
:
确保已启用虚拟机平台功能,并检查BIOS中的虚拟化设置。
Docker权限问题
:
确保当前用户已添加到docker组,并重启WSL。
Python包安装失败
:
检查网络连接,并尝试使用国内镜像源进行安装。
结语
通过以上步骤,您已在Win10系统下成功配置了基于Docker与WSL2的Python开发环境。这不仅提高了开发效率,还确保了环境的一致性和可移植性。希望本文能帮助您顺利搭建和使用这一强大的开发平台,开启高效编程之旅!