WSL_到_Ubuntu_安装说明

从更新 WSL 到安装 Ubuntu

一、发生了什么

你一开始看到“更新 WSL”的提示，是因为 OceanBase 客户端依赖 WSL2 环境，而系统里的 WSL 版本需要先更新到可用状态。

更新完成后，系统会引导你安装 Ubuntu。Ubuntu 是一个 Linux 发行版，装上它以后，Windows 里就能直接使用 Linux 环境。

二、完整安装流程

1. 以管理员身份打开 PowerShell

右键点击 Windows 开始菜单，选择“终端（管理员）”或“PowerShell（管理员）”。

2. 更新 WSL

wsl--update

如果提示需要提升权限，说明当前终端不是管理员权限，请关闭后重新打开“终端（管理员）”。

查看 WSL 状态：

wsl--status

查看 WSL 版本：

wsl--version

3. 设置默认使用 WSL2

wsl--set-default-version 2

WSL2 通常兼容性和性能更好。

4. 安装 Ubuntu

推荐使用微软提供的一键安装命令：

wsl--install--web-download

该命令会尝试完成以下工作：

• 启用 WSL 和虚拟机平台功能；
• 安装或更新 WSL2 内核；
• 下载并安装 Ubuntu；
• 设置 WSL2 为默认版本。

如果系统提示重启，请重启电脑。

5. 查看已安装的 Linux 发行版

重启后，在 PowerShell 中运行：

wsl-l-v

正常情况下会看到类似结果：

NAME STATE VERSION Ubuntu Stopped 2

其中VERSION显示为2，表示 Ubuntu 使用的是 WSL2。

三、首次启动 Ubuntu

可以在 Windows 开始菜单中搜索并打开 Ubuntu，也可以在 PowerShell 中运行：

wsl

首次启动时，Ubuntu 会要求创建 Linux 用户名和密码：

• 用户名建议使用英文小写字母；
• 输入密码时屏幕不会显示字符，这是正常现象；
• 这个密码只用于 Ubuntu/Linux，不一定等于 Windows 密码。

四、Ubuntu 终端中的基础命令

以下命令需要在 Ubuntu 终端中运行，而不是 PowerShell 中运行。

查看当前目录

pwd

查看当前目录中的文件

ls

查看包括隐藏文件在内的详细列表：

ls-la

回到自己的 Linux 家目录

cd~

进入某个目录

cd目录名

返回上一级目录：

cd..

更新 Ubuntu 软件源

sudoaptupdate

更新已经安装的软件：

sudoaptupgrade-y

也可以合并执行：

sudoaptupdate&&sudoaptupgrade-y

安装常用开发工具

sudoaptinstallgitpython3 nodejs-y

查看软件版本

git--versionpython3--versionnode--version

五、Windows 和 Ubuntu 之间访问文件

在 Ubuntu 中访问 Windows 的 C 盘：

cd/mnt/c

进入 Windows 桌面：

cd/mnt/c/Users/Administrator/Desktop

在 Windows 资源管理器中打开当前 Ubuntu 目录：

explorer.exe.

建议把 Linux 项目放在 Ubuntu 的 Linux 家目录中，例如：

mkdir-p~/projectscd~/projects

六、常用 WSL 管理命令

在 PowerShell 中运行：

停止所有 WSL 实例：

wsl--shutdown

再次启动 Ubuntu：

wsl-d Ubuntu

将 Ubuntu 设为默认发行版：

wsl--set-defaultUbuntu

查看所有可安装的发行版：

wsl--list--online

七、注意事项

• WSL 和 Ubuntu 不会替换 Windows，也不需要安装双系统。
• 资源管理器里的 Linux 图标是 WSL 提供的访问入口，不是异常程序。
• 不要直接删除 Ubuntu 文件系统中的系统目录，例如/etc、/usr、/var。
• wsl --unregister Ubuntu会删除 Ubuntu 发行版及其中的全部数据，除非确认不再需要，否则不要运行。
• 如果 OceanBase 仍然提示 WSL 异常，先运行wsl --update，然后重启电脑，再运行wsl -l -v检查 Ubuntu 是否为版本 2。
  x 图标是 WSL 提供的访问入口，不是异常程序。
• 不要直接删除 Ubuntu 文件系统中的系统目录，例如/etc、/usr、/var。
• wsl --unregister Ubuntu会删除 Ubuntu 发行版及其中的全部数据，除非确认不再需要，否则不要运行。
• 如果 OceanBase 仍然提示 WSL 异常，先运行wsl --update，然后重启电脑，再运行wsl -l -v检查 Ubuntu 是否为版本 2。