DAY1-Open Harmony PC 命令行适配指南（Windows版）环境准备篇

【学习笔记DAY1】IT从业者张某某-环境准备篇

DAY1-Open Harmony PC 命令行适配指南（Windows版）环境准备篇

参考

Windows环境

https://gitcode.com/OpenHarmonyPCDeveloper/build?isLogin=1

鸿蒙PC生态三方软件移植：开发环境搭建及三方库移植指南-CSDN博客

https://blog.csdn.net/yyz_1987/article/details/154794871

《在 Windows 10 上安装和使用 WSL 2 安装 Ubuntu24详细指南》

概述

WSL介绍

WSL（Windows Subsystem for Linux）允许你直接在 Windows 上运行 Linux 环境，无需启动虚拟机或双系统。WSL 2 是 WSL 的第二个版本，改进了性能和功能，提供了更接近原生 Linux 的体验。

环境准备

window操作系统中，可以采用vmware安装ubuntu22.04以上的版本，也可以采用wsl安装ubuntu22.04的虚拟机，本文采用WSL的方式安装虚拟机。

虚拟机准备

下载wsl ubuntu 22.04 https://wslstorestorage.blob.core.windows.net/wslblob/Ubuntu2204-221101.AppxBundle

WSL2准备

下载WSL 2 内核更新包

https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

检查Windows版本

windows操作系统打开CMD提示符，输入

Plain 复制代码

winver

返回Window版本

版本要求如下：
- 对于 x64 系统：版本 1903 或更高版本（内部版本 18862 或更高版本）。
- 对于 ARM64 系统：版本 2004 或更高版本（内部版本 19041 或更高版本）。

启用虚拟功能

方法1：

控制面板-程序-启用或关闭Windows功能-勾选虚拟机平台和适用于Linux的Windows子系统。

方法2：

在 PowerShell 中以管理员身份运行以下命令，以确保启用适用于 Linux 的 Windows 子系统和虚拟机平台功能：

Bash 复制代码

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

完成上述命令后，重启计算机以完成安装。

安装WSL

下载后双击安装进入wsl

Plain 复制代码

#安装wsl，默认是安装好的
wsl --install

#查看支持内核版本 wsl版本是2.x
C:\Users\zhangjun>wsl -v
WSL 版本： 2.4.13.0
内核版本： 5.15.167.4-1
WSLg 版本： 1.0.65
MSRDC 版本： 1.2.5716
Direct3D 版本： 1.611.1-81528511
DXCore 版本： 10.0.26100.1-240331-1435.ge-release
Windows 版本： 10.0.26100.7171

#如果wsl不是2.x, 将WSL2设置为默认版本
#wsl --set-default-version 2

# 升级下子系统
#wsl --update

查看可以安装的linux版本

Bash 复制代码

C:\Windows\System32>wsl --list --online

以下是可安装的有效分发的列表。

使用 'wsl.exe --install <Distro>' 安装。

NAME FRIENDLY NAME

AlmaLinux-8 AlmaLinux OS 8

AlmaLinux-9 AlmaLinux OS 9

AlmaLinux-Kitten-10 AlmaLinux OS Kitten 10

AlmaLinux-10 AlmaLinux OS 10

Debian Debian GNU/Linux

FedoraLinux-43 Fedora Linux 43

FedoraLinux-42 Fedora Linux 42

SUSE-Linux-Enterprise-15-SP7 SUSE Linux Enterprise 15 SP7

SUSE-Linux-Enterprise-16.0 SUSE Linux Enterprise 16.0

Ubuntu Ubuntu

Ubuntu-24.04 Ubuntu 24.04 LTS

archlinux Arch Linux

kali-linux Kali Linux Rolling

openSUSE-Tumbleweed openSUSE Tumbleweed

openSUSE-Leap-16.0 openSUSE Leap 16.0

Ubuntu-20.04 Ubuntu 20.04 LTS

Ubuntu-22.04 Ubuntu 22.04 LTS

OracleLinux_7_9 Oracle Linux 7.9

OracleLinux_8_10 Oracle Linux 8.10

OracleLinux_9_5 Oracle Linux 9.5

openSUSE-Leap-15.6 openSUSE Leap 15.6

SUSE-Linux-Enterprise-15-SP6 SUSE Linux Enterprise 15 SP6

WSL安装Ubunut22.04

方法1：

步骤1：双击Ubuntu2204-221101.AppxBundle安装22.04

步骤2：单击安装

步骤3：输入用户名和密码，我这里都是ubuntu

步骤4：测试基本的linux命令

方法2：

通过wls命令安装22.04

Bash 复制代码

wsl --install -d ubuntu-22.04

WSL启动Ubuntu并设置国内镜像源

WSL 命令简单总结

• list

• wsl -l 或 wsl --list 列出所有已安装虚拟机

• wsl -l -v 显示详细信息(也不怎么详细)

• wsl -l -o 列出网上可用的系统

• terminate

• wsl -t ubuntu 关闭ubuntu

• wsl --shutdown 关闭所有系统及虚拟机引擎

• run

• wsl -d ubuntu 启动ubuntu并进行终端

• wsl -u root 以root身份支行

• .exe config --default-user 设置默认用户名

例如 ubuntu.exe config --default-user root

• install

• wsl --install 安装默认虚拟机(ubuntu)

• wsl -l -o 列出网上可用的系统

• 执行命令

• wsl <命令>

• 默认虚拟机

wsl 启动默认虚拟机并进入终端

wsl -s 虚拟机名进入默认虚拟机

常用WSL命令及其解释

wsl --help：查看WSL命令的使用方法和可用选项。

wsl -l -v：列出所有已安装的Linux发行版及其详细信息。

wsl -d <子系统名称>：运行指定名称的Linux子系统。

wsl -t <子系统名称>：终止正在运行的指定名称的Linux子系统。

wsl --shutdown：终止所有正在运行的Linux子系统。

wsl --export <子系统名称> <输出路径及名称>：将指定子系统导出为tar文件。

wsl --import <子系统名称> <路径> <备份子系统tar文件>：将备份的子系统导入到新子系统。

wsl --unregister <子系统名称>：卸载指定名称的Linux子系统。

wsl --status：查看WSL子系统的状态。

wsl --install --distribution Debian或wsl --install -d Debian：安装Debian发行版的Linux子系统。

wsl -s <子系统名称>：将指定子系统设为默认，设为默认后可以直接运行。

设置子系统默认登陆用户：在/etc/wsl.conf文件中进行配置，添加[user] default = DemoUser。

这些命令可以帮助你管理和操作WSL子系统，包括安装、运行、导出、导入和卸载Linux子系统，设置默认子系统以及查看子系统状态等操作。

版权声明：本文为CSDN博主「特立独行的猫a」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。

原文链接：https://blog.csdn.net/yyz_1987/article/details/148545443

步骤1：进入Ubuntu操作系统，并查看镜像源

通过wsl -l -v 列出所有已安装的Linux发行版及其详细信息

Bash 复制代码

C:\Windows\System32>wsl -l -v
  NAME      STATE           VERSION
* Ubuntu    Running         2

通过wsl -d Ubuntu 运行指定名称的Linux子系统

Bash 复制代码

C:\Windows\System32>wsl -d Ubuntu
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.

通过sudo cat /etc/apt/sources.list查看当前镜像源

Bash 复制代码

ubuntu@zjpc:/mnt/c/Windows/System32$ pwd
/mnt/c/Windows/System32
ubuntu@zjpc:/mnt/c/Windows/System32$ cd ~
ubuntu@zjpc:~$ pwd
/home/ubuntu
ubuntu@zjpc:~$ sudo cat /etc/apt/sources.list

步骤2：更换镜像源

备份源列表：

Bash 复制代码

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

编辑 sources.list 文件：

Bash 复制代码

sudo vim /etc/apt/sources.list

vim编辑器命令模式下，输入ggdG删除所有内容，输入i，并添加以下任意源：

JSON 复制代码

deb http://mirrors.aliyun.com/ubuntu/ focal main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ focal-security main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal-security main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ focal-updates main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal-updates main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ focal-proposed main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal-proposed main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ focal-backports main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal-backports main restricted universe multiverse

保存文件并退出编辑器：

在 vim 中，按 Esc 键，然后输入 :wq! 并回车以保存并退出。

查看文件是否更改成功：

Bash 复制代码

cat /etc/apt/sources.list

步骤3：更新源和软件

Bash 复制代码

sudo apt-get update
sudo apt-get dist-upgrade
sudo apt-get upgrade

基于微软官方迁移方法（更稳定）

LxRunOffline 第三方工具偶尔有兼容性问题，推荐用 WSL 官方命令迁移（导出→删除→重新导入）：

先导出 Ubuntu 镜像到 D 盘（备份）：

PowerShell 复制代码

wsl --export Ubuntu D:\WSL\Ubuntu-22.04-backup.tar

注销原 Ubuntu 实例（保留备份，放心删）：

PowerShell 复制代码

wsl --unregister Ubuntu

重新导入 Ubuntu 到目标目录（自动开启大小写敏感）：

PowerShell 复制代码

wsl --import Ubuntu D:\WSL\Ubuntu-22.04 D:\WSL\Ubuntu-22.04-backup.tar --version 2

设置默认登录用户（避免每次 root 登录）：

PowerShell 复制代码

# 替换为你的用户名（原Ubuntu的用户名）
ubuntu config --default-user Ubuntu

迁移 WSL 到非系统盘-未使用

默认情况下，WSL 会安装在 C 盘。为了节省 C 盘空间，可以将 WSL 迁移到其他磁盘分区，例如 D 盘。

下载 LxRunOffline 工具：https://github.com/DDoSolitary/LxRunOffline/releases

访问 LxRunOffline 下载页面。

下载适用于 x64 系统的 LxRunOffline-vx.x.x-msvc.zip 版本。

解压并使用 LxRunOffline 工具：

解压下载的文件到任意目录，例如 D:\LxRunOffline。

打开 PowerShell 并以管理员身份运行。

使用以下命令获取发行版名称：

Bash 复制代码

.\LxRunOffline.exe list

执行迁移命令：

使用以下命令将 Ubuntu-22.04 迁移到 D 盘：

Bash 复制代码

.\LxRunOffline.exe m -n Ubuntu -d D:\WSL\Ubuntu-22.04

在cmd命令中停止发行版（如果正在运行）：

Plain 复制代码

wsl -t Ubuntu

再次执行迁移命令：

使用以下命令将 Ubuntu-22.04 迁移到 D 盘：

Bash 复制代码

.\LxRunOffline.exe m -n Ubuntu -d D:\WSL\Ubuntu-22.04

总结

本文是「D1-3」了解鸿蒙PC命令行适配，并完成搭建命令行适配环境，今天完成了基础环境的配置。