WSL Ubuntu 安装 Golang Python Node.js Java Docker Podman 开发环境配置

安装 Deno

curl -fsSL https://deno.land/install.sh | sh

安装 OpenJDK 与 Maven，配置加速

sudo apt update
sudo apt install default-jdk -y
java -version
# 安装特定版本
sudo apt install openjdk-17-jdk -y
# 管理多个 JDK 版本
sudo update-alternatives --config java

安装 Maven

sudo apt install maven -y
# 新开一个终端
mvn -version

安装 uv

curl -LsSf https://astral.sh/uv/install.sh | sh
sh, bash, zsh
source $HOME/.local/bin/env
uv --version

临时加速

uv pip install numpy --default-index https://pypi.tuna.tsinghua.edu.cn/simple

永久加速

# 推荐使用清华源
echo 'export UV_DEFAULT_INDEX="https://pypi.tuna.tsinghua.edu.cn/simple"' >> ~/.bashrc
# 或者用阿里源
# echo 'export UV_DEFAULT_INDEX="https://mirrors.aliyun.com/pypi/simple/"' >> ~/.bashrc
# 让配置立即生效
source ~/.bashrc

安装 Python

uv python install 3.12
uv python list
python3 --version

安装 Podman

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)
sudo apt-get -y install podman
sudo apt-get -y install podman-compose
podman -v
podman-compose -V

也可以安装 Docker。

设置别名

nano ~/.bashrc
alias docker='podman'
alias docker-compose='podman-compose'
source ~/.bashrc
docker --version
docker-compose -V

加速

cat /etc/containers/registries.conf.d/custom.conf
sudo nano /etc/containers/registries.conf.d/custom.conf

添加以下内容

unqualified-search-registries = ['docker.io', 'k8s.gcr.io', 'gcr.io']
[[registry]]
prefix = "docker.io"
insecure = true
location = "registry-1.docker.io"
[[registry.mirror]]
location = "docker.1ms.run"
[[registry]]
prefix = "k8s.gcr.io"
insecure = true
location = "k8s.gcr.io"
[[registry.mirror]]
location = "registry.cn-hangzhou.aliyuncs.com/google_containers"
[[registry]]
prefix = "gcr.io"
insecure = true
location = "gcr.io"
[[registry.mirror]]
location = "registry.cn-hangzhou.aliyuncs.com/google_containers"
[[registry]]
prefix = "ghcr.io"
insecure = true
location = "ghcr.io"
[[registry.mirror]]
location = "registry.cn-hangzhou.aliyuncs.com/google_containers"

保存并退出：Ctrl + O → 回车 → Ctrl + X

测试

podman run quay.io/podman/hello
podman run docker.io/hello-world
docker run docker.io/hello-world

附录：WSL 常用命令与源配置

切换中科大源

# 显示完整的发行版信息
lsb_release -a
# 查看
cat /etc/apt/sources.list.d/ubuntu.sources
# 进入目录
cd /etc/apt/sources.list.d
# 备份
sudo cp ubuntu.sources ubuntu.sources.bak
# DEB822 格式
sudo sed -i 's@//.*archive.ubuntu.com@//mirrors.ustc.edu.cn@g' /etc/apt/sources.list.d/ubuntu.sources
# 因镜像站同步有延迟，可能会导致生产环境系统不能及时检查、安装上最新的安全更新，不建议替换 security 源。(可选)
sudo sed -i 's/security.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list.d/ubuntu.sources
sudo apt update

WSL2 常用命令

WSL2 提供了一系列强大的命令，涵盖了从安装、日常管理到备份恢复的全过程。下面这个表格汇总了这些核心命令，可以帮你快速建立起一个整体印象。

🔧 环境准备与安装

在开始使用各种命令之前，需要先确保 WSL2 环境已经就绪。

• 一键安装（推荐）：对于 Windows 10（版本 2004 及更高版本）和 Windows 11 用户，最简便的方法是使用命令 wsl --install。这个命令会自动启用所需功能、安装默认的 Ubuntu 发行版并将 WSL2 设置为默认版本。
• 手动安装：如果需要更多控制，可以分步执行。首先以管理员身份打开 PowerShell，启用'适用于 Linux 的 Windows 子系统'和'虚拟机平台'功能，然后重启电脑。接着，下载并安装 WSL2 Linux 内核更新包，最后使用 wsl --set-default-version 2 命令设置默认版本。
• 安装特定发行版：你可以通过 Microsoft Store 搜索并安装喜欢的发行版（如 Ubuntu 22.04 LTS），也可以使用命令行，例如 wsl --install -d Ubuntu-22.04。

📦 发行版管理与日常使用

安装好发行版后，以下命令能帮助你高效管理。

• 查看与设置默认发行版：使用 wsl --list --verbose（或 wsl -l -v）可以清晰查看所有已安装的发行版、它们的运行状态（Running 或 Stopped）以及 WSL 版本。如果你安装了多个发行版，可以使用 wsl --set-default <发行版名称> 来设置默认启动项。
• 启动与关闭：直接输入 wsl 即可启动默认发行版。要关闭某个发行版，使用 wsl --terminate <发行版名称>。当需要彻底关闭所有 WSL 相关进程时（例如应用某些配置更改后），最有效的方法是使用 wsl --shutdown。
• 彻底删除发行版：如果某个发行版不再需要，可以使用 wsl --unregister <发行版名称> 将其完全注销并删除，从而释放磁盘空间。

💾 备份与恢复指南

定期备份 WSL 环境可以防止配置好的开发环境因意外丢失。

• 备份（导出）：使用 wsl --export 命令可以将指定的发行版打包成一个 .tar 备份文件。建议在执行操作前先使用 wsl --terminate 或 wsl --shutdown 确保发行版已完全关闭，以保证备份文件的一致性。
• 恢复（导入）：使用 wsl --import 命令可以将备份文件恢复到指定位置。这个命令的一个关键作用是迁移 WSL 发行版的存储位置。默认情况下，WSL 虚拟硬盘文件（ext4.vhdx）存放在 C 盘，通过'导出 - 注销 - 导入到新位置'的方式，可以将其转移到 D 盘等其他驱动器，有效节省 C 盘空间。
  基本步骤如下：
  1. wsl --export <发行版名称> <备份文件路径.tar>
  2. wsl --unregister <发行版名称> （注销当前发行版以释放它）
  3. wsl --import <新发行版名称> <目标安装路径> <备份文件路径.tar> --version 2

💎 进阶使用技巧

除了上述核心命令，还有一些非常实用的技巧可以提升你的使用体验。

• 文件系统互访：
  • 在Windows 文件资源管理器的地址栏输入 \\wsl$\<发行版名称>（例如 \\wsl$\Ubuntu-20.04），可以直接访问 WSL 系统的文件，进行拖拽、复制等操作。
  • 在WSL 终端中，Windows 的盘符（如 C 盘、D 盘）默认挂载在 /mnt/ 目录下（如 /mnt/c/, /mnt/d/），可以直接在 WSL 中访问 Windows 文件。
• 与 VS Code 集成：在 Windows 上安装 VS Code 后，添加'Remote - WSL'扩展插件。之后在 WSL 终端中进入你的项目目录，输入命令 code .，即可在 Windows 版的 VS Code 中调用 WSL 环境进行开发，享受无缝的体验。

掌握这些命令，你就能从容地管理你的 WSL2 环境了。