在 Ubuntu 24.04 上搭建 OpenHarmony（鸿蒙）PC 命令行移植开发环境
- 个人首页： VON
- 鸿蒙系列专栏： 鸿蒙开发小型案例总结
- 综合案例 ：鸿蒙综合案例开发
- 鸿蒙6.0：从0开始的开源鸿蒙6.0.0
- 鸿蒙5.0：鸿蒙5.0零基础入门到项目实战
- Electron适配开源鸿蒙专栏：Electron for OpenHarmony
- Flutter 适配开源鸿蒙专栏：Flutter for OpenHarmony
目录
前言
本文面向希望在 Ubuntu 24.04 系统上进行 OpenHarmony（鸿蒙）命令行工具移植的开发者。由于部分教程仍基于 Ubuntu 22.04 编写，在新版系统中会遇到如 libltdl7-dev 包名变更等问题。本指南已针对 Ubuntu 24.04 的兼容性问题完成修正，并配以实际操作截图，助你顺利搭建开发环境。
1. 安装常见依赖工具
首先更新软件源：
# 更新软件源sudoapt update 接着安装必备开发工具。注意：Ubuntu 24.04 中 libltdl7-dev 已被移除，应使用 libltdl-dev 替代。
原始命令（适用于 Ubuntu 22.04）：
sudo apt install -y curl git vim gcc g++ make pkg-config autoconf automake patch libtool autopoint gperf tcl8.6-dev wget unzip gccgo-go flex bison premake4 python3 python3-pip ninja-build meson sox gfortran subversion build-essential module-assistant gcc-multilib g++-multilib libltdl7-dev cabextract libboost-all-dev libxml2-utils gettext libxml-libxml-perl libxml2 libxml2-dev libxml-parser-perl texinfo xmlto po4a libtool-bin yasm nasm xutils-dev libx11-dev xtrans-dev 执行时会报错，如下图所示：
✅ 修正后的完整安装命令（适用于 Ubuntu 24.04）：
sudoaptinstall-ycurlgitvim gcc g++ make pkg-config autoconf automake patch libtool autopoint gperf tcl8.6-dev wgetunzip gccgo-go flex bison premake4 python3 python3-pip ninja-build meson sox gfortran subversion build-essential module-assistant gcc-multilib g++-multilib cabextract libboost-all-dev libxml2-utils gettext libxml-libxml-perl libxml2 libxml2-dev libxml-parser-perl texinfo xmlto po4a libtool-bin yasm nasm xutils-dev libx11-dev xtrans-dev libltdl-dev 安装完成后效果如下：
2. 下载 OpenHarmony SDK
创建并进入工作目录：
# 创建鸿蒙 PC 命令行移植的工作目录mkdir ~/harmonypc # 进入工作目录cd ~/harmonypc 下载官方 SDK（文件较大，请耐心等待）：
# 下载 OHOS SDKwget https://cidownload.openharmony.cn/version/Master_Version/ohos-sdk-full_ohos/20250819_020817/version-Master_Version-ohos-sdk-full_ohos-20250819_020817-ohos-sdk-full_ohos.tar.gz 下载过程如下图：
解压主 SDK 包：
# 解压 OHOS SDKtar xf version-Master_Version-ohos-sdk-full_ohos-20250819_020817-ohos-sdk-full_ohos.tar.gz 解压后目录结构如下：
进入 linux 子目录，解压 native 和 toolchains 两个关键组件：
cd ~/harmonypc/ohos-sdk/linux/ # 解压 native（含 Clang 编译器）unzip-q native-linux-x64-6.0.0.46-Beta1.zip # 解压 toolchains（含签名等工具）unzip-q toolchains-linux-x64-6.0.0.46-Beta1.zip 解压完成后可用 ls 查看内容：
3. 配置环境变量
设置 OHOS_SDK 环境变量，指向 SDK 的 Linux 目录：
# 设置 OHOS_SDK 环境变量exportOHOS_SDK=~/harmonypc/ohos-sdk/linux 验证两个核心工具是否存在：
ls$OHOS_SDK/native/llvm/bin/clang ls$OHOS_SDK/toolchains/lib/binary-sign-tool 正常应输出文件路径，如下图所示：
为使环境变量永久生效，将其写入 shell 配置文件：
echo'export OHOS_SDK=~/harmonypc/ohos-sdk/linux'>> ~/.`basename$SHELL`rc ✅ 此命令会自动适配bash或zsh，无需手动判断。
4. 下载并构建 lycium_plusplus 示例项目
克隆构建框架仓库：
# 进入工作目录cd ~/harmonypc # 下载 lycium_plusplusgit clone https://gitcode.com/OpenHarmonyPCDeveloper/lycium_plusplus.git 克隆过程如下：
进入构建脚本目录，尝试编译 tree 命令：
# 进入 build.sh 目录cd ~/harmonypc/lycium_plusplus/lycium/ # 构建 tree 命令 ./build.sh tree 首次运行可能因缺少 cmake 而失败：
安装 CMake：
# 安装 cmakesudoaptinstall-y cmake 安装过程如下：
再次执行构建：
# 重新构建 tree 命令 ./build.sh tree 若看到类似以下输出，即表示构建成功：
结尾总结
通过以上步骤，你已在 Ubuntu 24.04 上成功：
- 修复并安装了兼容新版系统的开发依赖
- 下载并配置了 OpenHarmony SDK
- 设置了持久化环境变量
- 使用
lycium_plusplus成功构建了tree命令
这标志着你的 OpenHarmony PC 移植开发环境已准备就绪！接下来可尝试移植更多命令行工具，或深入参与 OpenHarmony 生态建设。
🌐 资源参考OpenHarmony 官网：https://www.openharmony.cn/GitCode 社区项目：https://atomgit.com/OpenHarmonyPCDeveloper
祝你开发顺利，共建鸿蒙未来！🚀
