openEuler WSL 开发者指南：在 Windows 上搭建完整的 openEuler 开发环境

【免费下载链接】wslPort openEuler to WSL (Windows Subsystem for Linux)项目地址: https://gitcode.com/openeuler/wsl

前往项目官网免费下载：https://ar.openeuler.org/ar/

openEuler WSL 是将 openEuler 操作系统移植到 Windows Subsystem for Linux (WSL) 的开源项目，让开发者能在 Windows 环境中高效使用 openEuler 进行开发。本指南将带你快速搭建完整的开发环境，从环境准备到应用打包全流程详解。

📋 准备工作：系统要求与依赖检查

在开始前，请确保你的系统满足以下条件：

• Windows 10 版本 2004 或更高（推荐 Windows 11）
• 已启用 WSL 功能（WSL 1 或 WSL 2）
• 至少 4GB 内存和 20GB 可用磁盘空间

检查 WSL 状态的方法：

wsl --list --verbose

如果尚未安装 WSL，请以管理员身份运行 PowerShell：

wsl --install

🔧 两种安装方式：快速部署与源码构建

方式一：从 Microsoft Store 一键安装（推荐新手）

openEuler 提供了官方 WSL 应用，可直接从 Microsoft Store 获取：

安装步骤：

1. 打开 Microsoft Store 搜索 "openEuler"
2. 点击 "获取" 按钮自动完成安装
3. 首次启动时等待系统初始化（约 2-3 分钟）
4. 设置用户名和密码即可开始使用

方式二：从源码构建自定义版本（适合高级用户）

如果你需要定制 openEuler WSL 或参与开发，可通过源码构建：

1. 克隆项目仓库：

git clone https://gitcode.com/openeuler/wsl cd wsl

2. 安装构建依赖：

pip install -r requirements.txt

3. 生成 rootfs 镜像：

bash generate_rootfs.sh

⚙️ 开发环境配置：优化你的 openEuler WSL

基础配置优化

推荐通过修改wsl.conf配置文件优化体验，该文件位于项目的 docker/wsl.conf：

[network] generateResolvConf = false [interop] appendWindowsPath = false

应用配置：

wsl --shutdown wsl

开发工具安装

安装常用开发工具：

sudo dnf update -y sudo dnf install -y gcc make git vim

📦 应用打包：生成 WSL 应用包

如果你需要将自定义版本打包为 Appx 格式，可使用项目提供的打包工具：

1. 进入打包配置界面（需安装 Visual Studio）
2. 配置包信息和签名证书：

3. 执行打包命令：

cd DistroLauncher-Appx msbuild /t:Build /p:Configuration=Release

生成的 Appx 包位于DistroLauncher-Appx\bin\Release目录下。

📚 扩展资源与文档

• 项目官方文档：docs/
• 移植过程详解：docs/移植过程.md
• CI/CD 配置：jenkins/
• 各版本元数据：meta/

❓ 常见问题解决

WSL 启动失败

检查 WSL 版本是否兼容：

wsl --set-default-version 2

网络连接问题

手动配置 DNS（修改/etc/resolv.conf）：

nameserver 8.8.8.8 nameserver 114.114.114.114

通过本指南，你已掌握在 Windows 系统上搭建 openEuler WSL 开发环境的完整流程。无论是通过商店快速安装，还是从源码构建定制版本，openEuler WSL 都能为你提供高效稳定的 Linux 开发体验。立即开始你的 openEuler 开发之旅吧！ 🚀

【免费下载链接】wslPort openEuler to WSL (Windows Subsystem for Linux)项目地址: https://gitcode.com/openeuler/wsl