1. 项目概述在Windows环境下搭建OpenHarmony PC开发环境是每个想要参与鸿蒙生态开发的工程师必须跨越的第一道门槛。不同于传统的嵌入式开发环境配置OpenHarmony PC开发需要借助WSLWindows Subsystem for Linux这一桥梁在Windows系统中构建Linux开发环境。本文将详细记录我在Windows 11专业版版本22H2上从零开始配置OpenHarmony开发环境的完整过程包括WSL安装、Ubuntu子系统配置、开发工具准备等关键步骤。特别说明本文所有操作均在合规合法的开发环境下完成严格遵守相关法律法规仅用于技术学习和研究目的。2. 环境准备2.1 系统要求检查在开始之前我们需要确保Windows系统满足以下最低要求操作系统版本对于x64系统Windows 10版本1903或更高内部版本18362或更高推荐使用Windows 11 21H2及以上版本以获得最佳体验硬件配置至少8GB内存16GB以上推荐100GB可用磁盘空间SSD推荐支持虚拟化的CPUIntel VT-x或AMD-VBIOS设置确保已启用虚拟化技术通常在BIOS的CPU设置中可以通过以下命令检查Windows版本winver2.2 启用Windows功能WSL2需要以下Windows功能支持通过控制面板启用打开控制面板 → 程序 → 启用或关闭Windows功能勾选适用于Linux的Windows子系统虚拟机平台通过PowerShell启用管理员权限dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart执行完成后需要重启计算机。2.3 安装WSL2内核更新下载WSL2内核更新包官方下载地址https://aka.ms/wsl2kernel安装下载的MSI包wsl_update_x64.msi设置WSL2为默认版本wsl --set-default-version 23. Ubuntu子系统安装与配置3.1 安装Ubuntu 22.04 LTS推荐使用Microsoft Store安装Ubuntu 22.04 LTS打开Microsoft Store搜索Ubuntu 22.04 LTS点击获取按钮进行安装或者使用命令行安装wsl --install -d Ubuntu-22.043.2 初始设置首次启动Ubuntu子系统时会进行初始化设置创建默认用户建议使用英文用户名设置密码用于sudo操作等待初始配置完成3.3 更换软件源为了提高软件下载速度建议更换为国内镜像源备份原有源列表sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak编辑源列表以阿里云源为例sudo nano /etc/apt/sources.list替换为以下内容deb http://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse deb http://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse deb http://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse deb http://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse deb-src http://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse deb-src http://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse deb-src http://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse deb-src http://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse更新软件包索引sudo apt update sudo apt upgrade -y4. OpenHarmony开发环境配置4.1 安装基础工具链安装编译OpenHarmony所需的工具链sudo apt install -y git python3 python3-pip curl unzip tar gcc g make cmake ninja-build4.2 安装Node.jsOpenHarmony应用开发需要Node.js环境安装Node.js 16.xcurl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash - sudo apt-get install -y nodejs验证安装node -v npm -v4.3 安装OpenHarmony编译工具安装hb工具python3 -m pip install --user ohos-build添加hb工具到PATHecho export PATH$PATH:~/.local/bin ~/.bashrc source ~/.bashrc验证hb工具hb -h5. 常见问题与解决方案5.1 WSL2网络问题问题现象WSL2中无法访问外部网络解决方案重置WSL网络wsl --shutdown检查Windows防火墙设置如仍无法解决可尝试以下命令netsh winsock reset5.2 磁盘空间不足问题现象WSL2虚拟机占用过多磁盘空间解决方案清理APT缓存sudo apt clean压缩WSL2虚拟硬盘wsl --shutdown diskpart # 在diskpart中执行 select vdisk fileC:\Users\用户名\AppData\Local\Packages\Ubuntu包名\LocalState\ext4.vhdx attach vdisk readonly compact vdisk detach vdisk exit5.3 文件系统性能问题问题现象在/mnt目录下操作Windows文件速度慢解决方案尽量避免在/mnt下进行大量文件操作将项目代码放在WSL2原生文件系统中如~/projects如需频繁访问Windows文件可考虑使用wslpath命令转换路径6. 进阶配置6.1 迁移WSL2到其他磁盘默认情况下WSL2会安装在系统盘可以通过以下步骤迁移导出当前发行版wsl --export Ubuntu D:\wsl-ubuntu.tar注销原有发行版wsl --unregister Ubuntu导入到新位置wsl --import Ubuntu D:\wsl\ D:\wsl-ubuntu.tar --version 2设置默认用户ubuntu config --default-user 用户名6.2 配置VS Code远程开发在Windows上安装VS Code安装Remote - WSL扩展在WSL终端中输入code .这将自动配置VS Code远程开发环境6.3 配置GPU加速可选如果需要进行AI相关开发可以配置WSL2 GPU加速确保Windows已安装最新显卡驱动在WSL2中安装CUDA工具包sudo apt install -y nvidia-cuda-toolkit验证安装nvidia-smi7. 环境验证完成所有配置后建议执行以下验证步骤检查WSL版本wsl -l -v检查Ubuntu基本功能uname -a lsb_release -a检查开发工具链gcc --version python3 --version node -v hb -h测试网络连接ping -c 4 www.baidu.com完成以上所有步骤后你的Windows系统就已经准备好进行OpenHarmony PC开发了。后续可以根据具体开发需求安装额外的工具和SDK。