1. 为什么Windows开发者需要Docker作为Windows平台的Python开发者你一定遇到过这样的烦恼每次换新电脑或者重装系统都要花大半天时间配置开发环境。不同项目依赖的Python版本不同库版本冲突更是家常便饭。更别提团队协作时在我机器上能跑的经典问题了。Docker就像是一个魔法箱把Python解释器、项目代码、依赖库、环境变量统统打包成一个独立的集装箱。这个集装箱可以在任何安装了Docker的机器上运行完全不受宿主机环境影响。我去年接手一个老项目用Docker只花了10分钟就搭好了环境而之前同事手动配置花了整整一天。2. 准备工作安装Docker Desktop2.1 系统要求检查首先确认你的Windows版本Windows 10 专业版/企业版版本2004及以上或 Windows 11至少4GB内存建议8GB以上打开PowerShell输入systeminfo | find OS 名称2.2 安装WSL2后端微软的WSL2Windows Subsystem for Linux是运行Linux容器的推荐方式以管理员身份打开PowerShell执行wsl --install重启电脑后检查WSL版本wsl --list --verbose2.3 安装Docker Desktop官网下载安装包建议稳定版安装时勾选Use WSL 2 instead of Hyper-V安装完成后在开始菜单启动Docker Desktop右下角鲸鱼图标变绿就说明启动成功注意首次启动可能会提示需要开启虚拟化去BIOS里启用Intel VT-x/AMD-V即可3. 选择适合的Python镜像3.1 官方镜像版本对比在Docker Hub搜索python你会看到琳琅满目的标签python:3.12最新完整版约1GBpython:3.12-slim精简版约150MBpython:3.12-alpine超小版约50MB我实测下来slim版本最适合日常开发比完整版节省85%空间比Alpine版兼容性更好包含pip等基本工具拉取命令docker pull python:3.12-slim3.2 镜像加速技巧国内访问Docker Hub可能很慢可以配置镜像加速右键Docker图标 → Settings → Docker Engine添加阿里云镜像{ registry-mirrors: [https://你的ID.mirror.aliyuncs.com] }4. 创建第一个Python容器4.1 交互式运行容器试试经典的Hello Worlddocker run -it --rm python:3.12-slim python -c print(Hello Docker!)参数说明-it交互模式--rm退出后自动删除容器最后是执行的Python命令4.2 持久化容器实战开发时我们需要持久化容器docker run -itd --name mypy -v D:/code:/code python:3.12-slim-itd后台交互模式--name给容器命名-v把本地D:/code映射到容器的/code目录进入容器docker exec -it mypy bash5. 项目文件映射与开发5.1 目录结构规划推荐这样组织项目my_project/ ├── src/ # Python源码 ├── data/ # 数据文件 ├── requirements.txt └── Dockerfile5.2 实时同步代码启动容器时添加卷映射docker run -itd --name dev -v D:/my_project:/app python:3.12-slim现在你在本地IDE修改代码容器内会实时更新5.3 安装项目依赖在容器内pip install -r /app/requirements.txt如果依赖很多建议使用清华源pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt6. 调试与日志查看6.1 三种调试方式终端调试docker exec -it dev python /app/src/main.pyDocker Desktop GUI打开Containers界面点击对应容器的CLI按钮VSCode远程调试 安装Remote-Containers扩展可以直接在容器内调试6.2 日志监控技巧查看实时日志docker logs -f dev如果要调试启动问题可以先不加-d参数docker run -it --rm -v D:/my_project:/app python:3.12-slim python /app/src/main.py7. 打包自定义镜像7.1 编写Dockerfile在项目根目录创建DockerfileFROM python:3.12-slim WORKDIR /app COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt COPY . . CMD [python, ./src/main.py]7.2 构建镜像docker build -t my-python-app .构建完成后检查docker images7.3 多阶段构建技巧如果项目需要编译可以用多阶段构建减小镜像体积# 构建阶段 FROM python:3.12 as builder COPY requirements.txt . RUN pip install --user -r requirements.txt # 运行阶段 FROM python:3.12-slim COPY --frombuilder /root/.local /root/.local COPY . . CMD [python, ./src/main.py]8. 容器网络与端口配置8.1 暴露服务端口比如你的Python应用监听5000端口docker run -itd -p 5000:5000 my-python-app8.2 容器间通信创建自定义网络docker network create mynet启动两个容器并加入同一网络docker run -itd --name app1 --network mynet my-python-app docker run -itd --name app2 --network mynet my-python-app现在app1可以直接通过app2主机名访问app29. 生产环境部署建议9.1 健康检查配置在Dockerfile中添加HEALTHCHECK --interval30s --timeout3s \ CMD python -c import requests; requests.get(http://localhost:5000/health)9.2 资源限制启动时限制CPU和内存docker run -itd --cpus2 --memory1g my-python-app9.3 自动重启策略设置容器崩溃时自动重启docker run -itd --restart unless-stopped my-python-app10. 常见问题排查10.1 性能问题如果发现容器运行慢检查是否在WSL2模式下运行确保项目文件放在WSL2文件系统如\\wsl$避免使用Windows路径直接映射10.2 权限问题遇到文件权限错误时docker run -itd -v D:/code:/code:z python:3.12-slim:z选项会让Docker自动处理SELinux标签10.3 时区设置容器内默认是UTC时间修正为北京时间RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
1. 为什么Windows开发者需要Docker作为Windows平台的Python开发者你一定遇到过这样的烦恼每次换新电脑或者重装系统都要花大半天时间配置开发环境。不同项目依赖的Python版本不同库版本冲突更是家常便饭。更别提团队协作时在我机器上能跑的经典问题了。Docker就像是一个魔法箱把Python解释器、项目代码、依赖库、环境变量统统打包成一个独立的集装箱。这个集装箱可以在任何安装了Docker的机器上运行完全不受宿主机环境影响。我去年接手一个老项目用Docker只花了10分钟就搭好了环境而之前同事手动配置花了整整一天。2. 准备工作安装Docker Desktop2.1 系统要求检查首先确认你的Windows版本Windows 10 专业版/企业版版本2004及以上或 Windows 11至少4GB内存建议8GB以上打开PowerShell输入systeminfo | find OS 名称2.2 安装WSL2后端微软的WSL2Windows Subsystem for Linux是运行Linux容器的推荐方式以管理员身份打开PowerShell执行wsl --install重启电脑后检查WSL版本wsl --list --verbose2.3 安装Docker Desktop官网下载安装包建议稳定版安装时勾选Use WSL 2 instead of Hyper-V安装完成后在开始菜单启动Docker Desktop右下角鲸鱼图标变绿就说明启动成功注意首次启动可能会提示需要开启虚拟化去BIOS里启用Intel VT-x/AMD-V即可3. 选择适合的Python镜像3.1 官方镜像版本对比在Docker Hub搜索python你会看到琳琅满目的标签python:3.12最新完整版约1GBpython:3.12-slim精简版约150MBpython:3.12-alpine超小版约50MB我实测下来slim版本最适合日常开发比完整版节省85%空间比Alpine版兼容性更好包含pip等基本工具拉取命令docker pull python:3.12-slim3.2 镜像加速技巧国内访问Docker Hub可能很慢可以配置镜像加速右键Docker图标 → Settings → Docker Engine添加阿里云镜像{ registry-mirrors: [https://你的ID.mirror.aliyuncs.com] }4. 创建第一个Python容器4.1 交互式运行容器试试经典的Hello Worlddocker run -it --rm python:3.12-slim python -c print(Hello Docker!)参数说明-it交互模式--rm退出后自动删除容器最后是执行的Python命令4.2 持久化容器实战开发时我们需要持久化容器docker run -itd --name mypy -v D:/code:/code python:3.12-slim-itd后台交互模式--name给容器命名-v把本地D:/code映射到容器的/code目录进入容器docker exec -it mypy bash5. 项目文件映射与开发5.1 目录结构规划推荐这样组织项目my_project/ ├── src/ # Python源码 ├── data/ # 数据文件 ├── requirements.txt └── Dockerfile5.2 实时同步代码启动容器时添加卷映射docker run -itd --name dev -v D:/my_project:/app python:3.12-slim现在你在本地IDE修改代码容器内会实时更新5.3 安装项目依赖在容器内pip install -r /app/requirements.txt如果依赖很多建议使用清华源pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt6. 调试与日志查看6.1 三种调试方式终端调试docker exec -it dev python /app/src/main.pyDocker Desktop GUI打开Containers界面点击对应容器的CLI按钮VSCode远程调试 安装Remote-Containers扩展可以直接在容器内调试6.2 日志监控技巧查看实时日志docker logs -f dev如果要调试启动问题可以先不加-d参数docker run -it --rm -v D:/my_project:/app python:3.12-slim python /app/src/main.py7. 打包自定义镜像7.1 编写Dockerfile在项目根目录创建DockerfileFROM python:3.12-slim WORKDIR /app COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt COPY . . CMD [python, ./src/main.py]7.2 构建镜像docker build -t my-python-app .构建完成后检查docker images7.3 多阶段构建技巧如果项目需要编译可以用多阶段构建减小镜像体积# 构建阶段 FROM python:3.12 as builder COPY requirements.txt . RUN pip install --user -r requirements.txt # 运行阶段 FROM python:3.12-slim COPY --frombuilder /root/.local /root/.local COPY . . CMD [python, ./src/main.py]8. 容器网络与端口配置8.1 暴露服务端口比如你的Python应用监听5000端口docker run -itd -p 5000:5000 my-python-app8.2 容器间通信创建自定义网络docker network create mynet启动两个容器并加入同一网络docker run -itd --name app1 --network mynet my-python-app docker run -itd --name app2 --network mynet my-python-app现在app1可以直接通过app2主机名访问app29. 生产环境部署建议9.1 健康检查配置在Dockerfile中添加HEALTHCHECK --interval30s --timeout3s \ CMD python -c import requests; requests.get(http://localhost:5000/health)9.2 资源限制启动时限制CPU和内存docker run -itd --cpus2 --memory1g my-python-app9.3 自动重启策略设置容器崩溃时自动重启docker run -itd --restart unless-stopped my-python-app10. 常见问题排查10.1 性能问题如果发现容器运行慢检查是否在WSL2模式下运行确保项目文件放在WSL2文件系统如\\wsl$避免使用Windows路径直接映射10.2 权限问题遇到文件权限错误时docker run -itd -v D:/code:/code:z python:3.12-slim:z选项会让Docker自动处理SELinux标签10.3 时区设置容器内默认是UTC时间修正为北京时间RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
