启用 WSL 功能

以管理员身份打开 PowerShell 输入以下命令启用 WSL 功能:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

检查 BIOS 中是否开启虚拟化支持(Intel VT-x/AMD-V),Windows 10 版本需为 2004 或更高。

安装 Linux 发行版

打开 Microsoft Store 搜索并安装 Ubuntu 22.04 LTS。安装完成后启动 Ubuntu,根据提示创建用户名和密码。更新软件包列表:

sudo apt update && sudo apt upgrade -y

配置 Docker 仓库

添加 Docker 官方 GPG 密钥并设置稳定版仓库:

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

安装 Docker 引擎

更新 apt 索引后安装组件:

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

验证安装是否成功:

sudo docker run hello-world

配置非 root 权限(可选)

创建 docker 用户组并添加当前用户:

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

测试非 root 权限运行:

docker run hello-world

设置开机自启

在 Windows 创建启动脚本 start_docker.ps1

wsl -d Ubuntu -u root -- service docker start

将该脚本加入任务计划程序,触发器设置为「登录时」。

配置 VS Code 开发环境

安装「Remote - WSL」扩展。通过 code . 命令在 WSL 中打开项目文件夹,VS Code 会自动识别容器环境。在项目根目录创建 .devcontainer 文件夹可进行容器化开发配置。

性能优化建议

%UserProfile%\.wslconfig 添加内存限制:

[wsl2]
memory=6GB
swap=0
localhostForwarding=true

将项目文件存储在 WSL 文件系统内(如 /home/username/projects)而非 Windows 挂载目录。

更多推荐