WSL 与 Docker 入门指南在 Windows 上使用 Linux 和容器化开发环境一、WSLWindows Subsystem for Linux是什么WSL 是 Windows 系统内置的 Linux 兼容层让你不用装虚拟机、不用双系统就能在 Windows 上直接运行 Linux 命令行工具和完整 Linux 发行版如 Ubuntu、Debian 等。WSL 1兼容性翻译层文件系统性能好但不支持 Docker 等需要完整 Linux 内核的场景WSL 2真正的 Linux 内核运行在轻量虚拟机中支持完整的系统调用和 Docker推荐直接使用 WSL 2。官网官方文档https://learn.microsoft.com/zh-cn/windows/wsl/GitHub 仓库https://github.com/microsoft/WSL安装步骤系统要求Windows 10 版本 2004 及以上或 Windows 11一键安装推荐以管理员身份打开 PowerShell 或 CMD执行wsl--install这条命令会自动完成启用 WSL 和虚拟机平台组件下载并安装 Ubuntu默认发行版设置 WSL 2 为默认版本安装完成后重启电脑首次启动 Ubuntu 时会提示你设置用户名和密码。指定发行版安装# 查看可用发行版wsl--list--online# 安装指定发行版如 Ubuntuwsl--install-d Ubuntu验证安装# 查看已安装的发行版和版本wsl--list--verbose# 或简写wsl-l-v输出应显示VERSION为2。常用命令速查命令说明wsl启动默认发行版wsl -d 发行版名启动指定发行版wsl --shutdown关闭所有 WSL 实例wsl --update更新 WSL 内核wsl --set-version 发行版名 2转换为 WSL 2wsl --set-default-version 2设置默认版本为 WSL 2从 Windows 访问 Linux 文件在 WSL 终端中Windows 的 C 盘挂载在/mnt/ccd/mnt/c/Users/你的用户名从 Linux 访问 Windows 文件在 Windows 文件资源管理器地址栏输入\\wsl$即可访问。二、Docker是什么Docker 是一个容器化平台把应用及其所有依赖代码、运行时、库、配置打包成一个容器在任何安装了 Docker 的环境中运行结果完全一致——在我机器上能跑不再是问题。镜像Image打包好的应用模板只读容器Container镜像的运行实例可随时创建、启动、停止、删除Dockerfile定义如何构建镜像的脚本文件官网官方文档https://docs.docker.com/下载页面https://www.docker.com/products/docker-desktop/Docker Hubhttps://hub.docker.com/安装步骤Windows WSL 2 后端系统要求Windows 10 2004 或 Windows 11WSL 2 已安装1. 下载 Docker Desktop访问 Docker Desktop 下载页面选择 Windows 版本下载安装包双击安装。安装完成之后Docker拉取资源会很慢需要换源Docker千问换源Docker搜索引擎换源:Docker自带AI换源:2. 配置 WSL 2 后端安装完成后启动 Docker Desktop进入 Settings → General → 勾选 “Use WSL 2 based engine”默认已勾选进入 Settings → Resources → WSL Integration → 勾选你使用的 Linux 发行版如 Ubuntu3. 验证安装打开 PowerShell 或 WSL 终端docker--versiondockercompose versiondockerrun hello-world最后一条命令如果输出 “Hello from Docker!” 说明一切正常。注意Docker Desktop 对商业用户公司规模超过 250 人或年收入超过 1000 万美元需要付费许可证个人使用和小型团队免费。免费替代方案Docker Engine直接在 WSL 2 内安装——完全免费Podman——开源无许可证限制Docker desktop 详解快速上手 [后面部署会细讲]# 拉取一个 Nginx 镜像dockerpull nginx# 运行容器端口映射 8080-80dockerrun-d-p8080:80 nginx# 查看运行中的容器dockerps# 停止容器dockerstop容器ID# 删除容器dockerrm容器IDDockerfile 示例 [后面部署会细讲]创建一个名为Dockerfile的文件# 基于 Python 3.12 镜像 FROM python:3.12-slim # 设置工作目录 WORKDIR /app # 复制代码 COPY . . # 安装依赖 RUN pip install --no-cache-dir -r requirements.txt # 启动应用 CMD [python, app.py]构建并运行# 构建镜像dockerbuild-tmy-app.# 运行dockerrun-p5000:5000 my-app三、WSL Docker 常用工作流场景操作在 WSL 中开发Docker 运行VSCode 连接 WSL 写代码在 WSL 终端执行docker run数据持久化用docker volume或将 Windows 目录挂载到容器中数据库开发docker run -d -p 3306:3306 -e MYSQL_ROOT_PASSWORD123 mysql前端开发docker run -p 3000:3000 node:18-alpine跑 Node 服务总结WSLDocker作用在 Windows 上跑 Linux把应用打包成可移植的容器关系Docker Desktop 依赖 WSL 2 作为后端引擎在 WSL 2 上运行最流畅开发者价值不用装虚拟机就有完整的 Linux 环境开发和生产环境一致部署不踩坑推荐安装顺序先装 WSL 2 → 再装 Docker Desktop → 开启容器化开发。
03_WSL 与 Docker 入门指南
发布时间:2026/6/15 23:16:07
WSL 与 Docker 入门指南在 Windows 上使用 Linux 和容器化开发环境一、WSLWindows Subsystem for Linux是什么WSL 是 Windows 系统内置的 Linux 兼容层让你不用装虚拟机、不用双系统就能在 Windows 上直接运行 Linux 命令行工具和完整 Linux 发行版如 Ubuntu、Debian 等。WSL 1兼容性翻译层文件系统性能好但不支持 Docker 等需要完整 Linux 内核的场景WSL 2真正的 Linux 内核运行在轻量虚拟机中支持完整的系统调用和 Docker推荐直接使用 WSL 2。官网官方文档https://learn.microsoft.com/zh-cn/windows/wsl/GitHub 仓库https://github.com/microsoft/WSL安装步骤系统要求Windows 10 版本 2004 及以上或 Windows 11一键安装推荐以管理员身份打开 PowerShell 或 CMD执行wsl--install这条命令会自动完成启用 WSL 和虚拟机平台组件下载并安装 Ubuntu默认发行版设置 WSL 2 为默认版本安装完成后重启电脑首次启动 Ubuntu 时会提示你设置用户名和密码。指定发行版安装# 查看可用发行版wsl--list--online# 安装指定发行版如 Ubuntuwsl--install-d Ubuntu验证安装# 查看已安装的发行版和版本wsl--list--verbose# 或简写wsl-l-v输出应显示VERSION为2。常用命令速查命令说明wsl启动默认发行版wsl -d 发行版名启动指定发行版wsl --shutdown关闭所有 WSL 实例wsl --update更新 WSL 内核wsl --set-version 发行版名 2转换为 WSL 2wsl --set-default-version 2设置默认版本为 WSL 2从 Windows 访问 Linux 文件在 WSL 终端中Windows 的 C 盘挂载在/mnt/ccd/mnt/c/Users/你的用户名从 Linux 访问 Windows 文件在 Windows 文件资源管理器地址栏输入\\wsl$即可访问。二、Docker是什么Docker 是一个容器化平台把应用及其所有依赖代码、运行时、库、配置打包成一个容器在任何安装了 Docker 的环境中运行结果完全一致——在我机器上能跑不再是问题。镜像Image打包好的应用模板只读容器Container镜像的运行实例可随时创建、启动、停止、删除Dockerfile定义如何构建镜像的脚本文件官网官方文档https://docs.docker.com/下载页面https://www.docker.com/products/docker-desktop/Docker Hubhttps://hub.docker.com/安装步骤Windows WSL 2 后端系统要求Windows 10 2004 或 Windows 11WSL 2 已安装1. 下载 Docker Desktop访问 Docker Desktop 下载页面选择 Windows 版本下载安装包双击安装。安装完成之后Docker拉取资源会很慢需要换源Docker千问换源Docker搜索引擎换源:Docker自带AI换源:2. 配置 WSL 2 后端安装完成后启动 Docker Desktop进入 Settings → General → 勾选 “Use WSL 2 based engine”默认已勾选进入 Settings → Resources → WSL Integration → 勾选你使用的 Linux 发行版如 Ubuntu3. 验证安装打开 PowerShell 或 WSL 终端docker--versiondockercompose versiondockerrun hello-world最后一条命令如果输出 “Hello from Docker!” 说明一切正常。注意Docker Desktop 对商业用户公司规模超过 250 人或年收入超过 1000 万美元需要付费许可证个人使用和小型团队免费。免费替代方案Docker Engine直接在 WSL 2 内安装——完全免费Podman——开源无许可证限制Docker desktop 详解快速上手 [后面部署会细讲]# 拉取一个 Nginx 镜像dockerpull nginx# 运行容器端口映射 8080-80dockerrun-d-p8080:80 nginx# 查看运行中的容器dockerps# 停止容器dockerstop容器ID# 删除容器dockerrm容器IDDockerfile 示例 [后面部署会细讲]创建一个名为Dockerfile的文件# 基于 Python 3.12 镜像 FROM python:3.12-slim # 设置工作目录 WORKDIR /app # 复制代码 COPY . . # 安装依赖 RUN pip install --no-cache-dir -r requirements.txt # 启动应用 CMD [python, app.py]构建并运行# 构建镜像dockerbuild-tmy-app.# 运行dockerrun-p5000:5000 my-app三、WSL Docker 常用工作流场景操作在 WSL 中开发Docker 运行VSCode 连接 WSL 写代码在 WSL 终端执行docker run数据持久化用docker volume或将 Windows 目录挂载到容器中数据库开发docker run -d -p 3306:3306 -e MYSQL_ROOT_PASSWORD123 mysql前端开发docker run -p 3000:3000 node:18-alpine跑 Node 服务总结WSLDocker作用在 Windows 上跑 Linux把应用打包成可移植的容器关系Docker Desktop 依赖 WSL 2 作为后端引擎在 WSL 2 上运行最流畅开发者价值不用装虚拟机就有完整的 Linux 环境开发和生产环境一致部署不踩坑推荐安装顺序先装 WSL 2 → 再装 Docker Desktop → 开启容器化开发。