OpenHarmony 生态迎来重磅利器！Harmonybrew 作为开源包管理器，完美移植 Homebrew 成熟体系，为鸿蒙全场景设备提供开箱即用的命令行解决方案。它不仅保留原生操作逻辑降低学习成本，更实现60% Homebrew formula 直接兼容，彻底解决国产工具生态残缺的痛点。本文详解其安装配置流程与技术优势，揭示如何通过开源力量补齐鸿蒙开发短板。

一、前言

历经一年打磨，Harmonybrew 开源项目正式官宣上线！

Harmonybrew 是一款面向 OpenHarmony 平台的 Homebrew 移植项目，旨在为鸿蒙全场景设备提供开箱即用、简洁高效的包管理器与配套软件仓库。项目全面适配鸿蒙 PC、鸿蒙开发板、鸿蒙容器等多种鸿蒙设备形态，补齐了 OpenHarmony 命令行生态的核心短板。

开源社区地址：https://atomgit.com/Harmonybrew

二、快速上手教程（鸿蒙 PC HiShell 环境）

本文以鸿蒙 PC HiShell 环境为例，整理完整安装配置流程，步骤简单、全程一键部署。

2.1 卸载冲突软件

若设备中已安装GitNext、DevBox 两款软件，需提前卸载，避免环境冲突导致安装失败。

2.2 开启系统安全与开发者权限

为保障 Harmonybrew 正常安装运行，需开启两项系统权限：

1. 开启开发者选项：设置 → 系统 → 开发者选项，打开开发者开关；
2. 允许非应用市场扩展：设置 → 隐私和安全 → 高级，开启「运行来自非应用市场的扩展程序」。

2.3 一键安装 Harmonybrew

打开终端，执行以下官方安装命令，即可自动完成全套部署：

zsh -c “$(curl -fsSL https://harmonybrew.atomgit.com/install.sh)”

2.4 配置环境变量

安装完成后，按照脚本提示执行以下命令，将 brew 工具写入系统环境变量，全局生效：

echo >> ~/.zshrc
echo ‘eval “$(/storage/Users/currentUser/.harmonybrew/bin/brew shellenv)”‘ >> ~/.zshrceval “$(/storage/Users/currentUser/.harmonybrew/bin/brew shellenv)”

配置完成后，即可在任意终端直接使用 brew 全套命令，正常管理软件包。

三、项目核心特色

3.1 拒绝无效自研，复用业界成熟生态

在项目开发初期，我们便摒弃了「为了自研而自研」的无效开发思路，没有重复造轮子，而是直接移植业界最成熟、使用最广泛的 Homebrew 包管理器体系。

长期以来，不少国产工具存在操作逻辑晦涩、生态残缺、适配性差等问题，大幅提升了开发者的使用门槛。而 Harmonybrew 完美保留原生 Homebrew 的操作逻辑，开发者无需学习全新指令，沿用原有使用习惯，即可在鸿蒙设备上高效管理软件包。

生态层面优势更为突出：项目可直接兼容大部分 Homebrew 软件配方，超 60% 的 Homebrew formula 可直接在 Harmonybrew 流水线编译、测试、运行，无需单独适配鸿蒙平台，极速扩充 OpenHarmony 命令行软件生态。

3.2 深耕开源鸿蒙，全设备形态适配

区别于多数聚焦 HarmonyOS 商业版的鸿蒙工具项目，Harmonybrew 以开源上游 OpenHarmony 为核心，将其定为 Tier 1 最高优先级适配平台。

该架构设计让项目彻底脱离硬件厂商绑定，不止适配鸿蒙 PC，还全面兼容鸿蒙开发板（dayu200 rk3568）、鸿蒙容器（DockerHarmony）等设备形态。其中，开发板与容器环境为最高等级支持，系统限制少、兼容性最优。

开发者可借助开发板、容器等开放环境完成开发、调试、问题排查工作，大幅降低硬件适配门槛，提升开发与排错效率。

补充说明：HarmonyOS 作为 OpenHarmony 商业发行版，可兼容运行本项目，但受系统安全策略限制，鸿蒙 PC HiShell 环境部分功能存在轻微受限，属于系统原生限制，非项目适配问题。

3.3 海量软件包，持续高速迭代更新

目前 Harmonybrew 软件仓库已收录 2000+ 常用软件包，且以每日数百个的速度持续新增、更新，覆盖开发、编译、运维、调试等全场景需求。

开发者可通过 brew formulae 命令查看全部软件包列表，核心收录分类如下：

✅ 编译器/解释器

ohos-sdk、Node.js（22/24/26）、OpenJDK（17/21/25）、Python（3.12/3.13/3.14）、Go、Rust、Perl、Ruby

✅ 构建工具

Make、CMake、Ninja、Meson、m4、autotools 三件套（autoconf、automake、libtool）

✅ 数据库服务

PostgreSQL、MariaDB、Redis

✅ GNU 基础工具集

Coreutils、Diffutils、Grep、Gawk、Gnu-tar、Gzip

✅ 常用开发工具

Git、Strace、Patchelf、Vim、JQ3.4 不止是工具，更是鸿蒙开发者学习阵地

Harmonybrew 的价值，远不止一套包管理器。

项目开源社区的所有脚本、文档、适配案例，均按照OpenHarmony 实战教学标准编写，不仅服务于包管理功能，更可作为新人开发者入门鸿蒙生态、提升实操能力的免费学习资料。

所有技术沉淀、适配经验、踩坑解决方案全部开源公开，助力更多开发者快速融入 OpenHarmony 开源生态，降低鸿蒙开发的学习与实践门槛。

四、常用核心命令

沿用原生 Homebrew 简洁指令，上手零成本：

# 安装鸿蒙版 Homebrew
zsh -c “$(curl -fsSL https://harmonybrew.atomgit.com/install.sh)”
# 卸载鸿蒙版 Homebrew
zsh -c “$(curl -fsSL https://harmonybrew.atomgit.com/uninstall.sh)”
# 更新包管理器与软件索引
brew update
# 查看全部可用软件包
brew formulae
# 关键词搜索软件包
brew search [keyword]
# 安装指定软件包
brew install [formula]
# 卸载指定软件包
brew uninstall [formula]
# 查看已安装软件
brew list
# 清除本地缓存
rm -rf $(brew –cache)
# 彻底删除安装目录（深度卸载）
rm -rf $(brew –prefix)

五、写在最后

Harmonybrew 始终秉持务实开源、复用成熟生态、服务开发者的理念，拒绝形式化自研，专注为 OpenHarmony 补齐命令行生态短板。

未来项目将持续扩充软件包数量、优化全设备适配兼容性、完善开源文档与案例，为鸿蒙开发者提供更高效、更省心的开发体验。欢迎各位开发者体验、Star、Fork、参与共建，一起完善 OpenHarmony 开源生态！

开源地址：https://atomgit.com/Harmonybrew

参考：https://blog.csdn.net/hqzing/article/details/161371004