WSL-Ubuntu26.04环境搭建
本文是一份在 Windows 系统上通过 WSL 2 搭建 Ubuntu 26.04 开发环境的完整操作指南,涵盖 Windows 端 WSL 命令、Ubuntu 26.04 安装导入导出、宿主机文件互访,以及软件源、终端语言、Node.js(NVM)、Copilot、Docker、pyenv Python 3.12 等环境配置与验证方法。
WSL的使用方法
Windows端的WSL命令
以下命令在 Windows PowerShell 或命令提示符中运行:
| 命令 | 作用 |
|---|---|
wsl --status | 查看 WSL 配置和默认发行版信息。 |
wsl --list --online | 查看可在线安装的 Linux 发行版。 |
wsl --list --verbose | 查看已安装发行版及其运行状态和 WSL 版本;Stopped 表示当前未运行,不代表安装失败。 |
wsl --set-default-version 2 | 将新安装发行版的默认版本设为 WSL 2。 |
wsl --set-default Ubuntu-26.04 | 将 Ubuntu-26.04 设为运行 wsl 时默认启动的发行版。 |
wsl | 启动默认发行版。 |
wsl --distribution Ubuntu-26.04 | 启动指定发行版;也可简写为 wsl -d Ubuntu-26.04。 |
wsl --terminate Ubuntu-26.04 | 关闭指定发行版。 |
wsl --shutdown | 关闭所有正在运行的 WSL 发行版及 WSL 2 虚拟机。 |
wsl --update | 更新 WSL。 |
wsl --help | 查看 WSL 命令帮助。 |
进入 Ubuntu 后,可用以下 Linux 命令查看和切换目录,或退出发行版:
WSL 2 使用 Windows 虚拟化平台。较新的 VMware Workstation 通常可与 WSL 2 共存;旧版 VMware 可能受影响,建议更新 VMware。具体表现取决于 VMware 版本和虚拟化配置。
WSL 2 导入导出Ubuntu文件系统
可以用 WSL 导出/导入迁移整个 Ubuntu 文件系统。旧电脑和新电脑都在 Windows PowerShell 中操作。
旧电脑:导出发行版
wsl --list --verbose
wsl --shutdown
wsl --export Ubuntu-26.04 E:\Ubuntu-26.04.tar把 E:\Ubuntu-26.04.tar 复制到新电脑。发行版名称请以 wsl --list --verbose 显示的实际名称为准。
新电脑:导入为 WSL 2
先确保 WSL 已安装并更新,然后运行:
wsl --update
wsl --import Ubuntu-26.04 D:\WSL\Ubuntu-26.04 E:\Ubuntu-26.04.tar --version 2第一个路径是安装位置,第二个路径是复制过来的归档文件。导入后启动:
wsl -d Ubuntu-26.04导入的发行版通常会默认以 root 登录。要恢复原来的默认用户,先找出原用户名(通常在 /home 下),再编辑 /etc/wsl.conf,保留文件中其他已有设置,并加入:
[user]
default=你的用户名然后在 PowerShell 中重启该发行版:
wsl --terminate Ubuntu-26.04
wsl -d Ubuntu-26.04确认文件、应用和默认用户都正常后,再考虑删除旧电脑上的发行版或备份文件。注意:wsl --export 迁移的是 Linux 文件系统,不会迁移 Windows 侧的 WSL 设置、Windows 应用或另存于发行版之外的数据。
Ubuntu26.04的安装
在管理员身份运行的 PowerShell 或命令提示符中执行:
wsl --list --online
mkdir D:\APP\WSL\Ubuntu26.04
wsl --set-default-version 2
wsl --install --distribution Ubuntu-26.04 --location "D:\APP\WSL\Ubuntu26.04"按提示重启电脑。首次启动 Ubuntu:
wsl -d Ubuntu-26.04首次启动时按提示创建 Linux 用户名和密码。输入密码时终端不会显示字符,这是正常的。
和宿主机互相访问文件系统
Windows 的 D 盘在 WSL 中对应 /mnt/d/。例如:
cd /mnt/d/blduan/Desktop从 Windows 文件资源管理器访问 WSL 文件,可输入:
\\wsl.localhost\Ubuntu-26.04\home\blduan也可以在 WSL 当前目录运行:
建议通过 \\wsl.localhost\... 访问 Linux 文件,不要直接用 Windows 工具修改 WSL 的 ext4.vhdx 虚拟磁盘。
Ubuntu26.04的环境设置
软件源设置
以下示例将 Ubuntu 软件源改为清华镜像。先备份配置:
sudo cp /etc/apt/sources.list.d/ubuntu.sources \
/etc/apt/sources.list.d/ubuntu.sources.bak
sudo nano /etc/apt/sources.list.d/ubuntu.sources将文件中 URIs: 后的官方地址(通常为 archive.ubuntu.com 和 security.ubuntu.com)改为:
https://mirrors.tuna.tsinghua.edu.cn/ubuntu/保留原有的 Suites、Components、Signed-By 等配置。保存后更新软件包索引:
sudo apt update如果更新失败,可恢复备份:
sudo cp /etc/apt/sources.list.d/ubuntu.sources.bak \
/etc/apt/sources.list.d/ubuntu.sources
sudo apt update若找不到 ubuntu.sources,先运行 ls /etc/apt/sources.list.d/ 查看实际配置文件名。
终端语言设置
要让命令输出为英文,同时保持中文文件名可正常显示,使用英文 UTF-8 locale:
sudo apt update
sudo apt install -y locales
sudo locale-gen en_US.UTF-8
sudo update-locale LANG=en_US.UTF-8退出 WSL 后,在 Windows PowerShell 中重启发行版:
wsl --terminate Ubuntu-26.04
wsl -d Ubuntu-26.04查看当前语言设置:
locale如果 LC_ALL 被单独设置为其他语言,它会覆盖 LANG。确认没有不需要的 LC_ALL 设置。使用 UTF-8 locale 不会损坏中文文件名;如果终端仍不能正确显示中文,使用支持 UTF-8 的终端(如 Windows Terminal)。
安装配置 Node.js 和 npm
推荐使用 NVM 管理 Node.js。npm 会随 Node.js 一起安装;不要再用 sudo apt install nodejs 混装。
在 Ubuntu 中运行:
sudo apt update
sudo apt install -y curl ca-certificates
if ! command -v nvm >/dev/null 2>&1; then
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
fi
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
nvm install --lts
nvm alias default 'lts/*'验证安装:
which node
which npm
node -v
npm -vwhich node 和 which npm 应指向 /home/blduan/.nvm/versions/node/.../bin/。WSL 默认会把 Windows 的 PATH 加入 Linux PATH,因此务必检查,避免误调用 Windows 上的 Node.js/npm。若路径仍指向 Windows,确认 NVM 已加载;必要时关闭并重新打开 Ubuntu。
npm 缓存和全局包目录
建议把缓存放在 WSL Linux 文件系统中:
mkdir -p "$HOME/.cache/npm"
npm config set cache "$HOME/.cache/npm" --location=user
npm config get cache使用 NVM 时不要设置固定的 npm prefix。NVM 会为每个 Node.js 版本管理独立的全局包目录:
npm config get prefix
npm root -g路径应位于 /home/blduan/.nvm/versions/node/... 下。安装全局包直接使用 npm install -g <包名>,不要加 sudo。如果 prefix 仍显示 Windows 路径,先确认 which npm 指向 NVM,再清除用户级覆盖:
npm config delete prefix --location=userCopilot
这里使用 GitHub Copilot CLI。安装:
npm install -g @github/copilot --include=optional \
--registry=https://registry.npmjs.org/运行命令是copilot,如果出错则重启虚拟机。
Docker
以下是在 Ubuntu WSL 内直接安装 Docker Engine 的方式。若使用 Docker Desktop,建议改用其 WSL Integration,不要重复安装 Docker Engine。
添加 Docker 官方软件源并安装:
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
-o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo ${UBUNTU_CODENAME:-$VERSION_CODENAME}) stable" \
| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io \
docker-buildx-plugin docker-compose-plugin可直接使用 sudo docker ...。若希望省略 sudo,可将用户加入 docker 组;该组权限相当于 root:
sudo usermod -aG docker "$USER"退出并重新进入 Ubuntu 后生效。
Docker镜像Ubuntu14.04
拉取并启动 Ubuntu 14.04 容器:
sudo docker pull ubuntu:14.04
sudo docker run -it --name ubuntu14 ubuntu:14.04 bash退出容器后,容器会停止但保留。再次进入:
sudo docker start -ai ubuntu14Python 3.12
如果 Ubuntu 仓库默认提供 Python 3.14,建议使用 pyenv 安装 Python 3.12,而不要替换系统 Python。这样系统工具仍使用发行版所需的 Python 版本。
安装构建依赖和 pyenv:
sudo apt update
sudo apt install -y build-essential curl git libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev libncursesw5-dev xz-utils \
tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
curl -fsSL https://pyenv.run | bash把以下配置添加到 ~/.bashrc(如果已存在,不要重复添加):
export PYENV_ROOT="$HOME/.pyenv"
[[ -d "$PYENV_ROOT/bin" ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init - bash)"重新加载 Bash 配置并查看可用的 3.12 补丁版本:
source ~/.bashrc
pyenv install --list | grep -E '^[[:space:]]*3\.12\.[0-9]+$' | tail -n 5选择列表中最新的补丁版本,将下面的 3.12.X 替换为实际版本号:
pyenv install 3.12.X
pyenv global 3.12.X
python --version
python3.12 --versionpyenv global 只设置当前用户的默认 Python,不会替换 /usr/bin/python3。若只希望某个项目使用 3.12,在项目目录中运行 pyenv local 3.12.X,而不是 pyenv global。
- 原文作者:生如夏花
- 原文链接:https://DBL2017.github.io/post/%E5%B7%A5%E5%85%B7%E4%BD%BF%E7%94%A8/wsl-ubuntu26.04%E7%8E%AF%E5%A2%83%E6%90%AD%E5%BB%BA/
- 版权声明:本作品采用知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议进行许可,非商业转载请注明出处(作者,原文链接),商业转载请联系作者获得授权。