【鸿蒙PC工具链环境适配】新服务器环境搭建全记录：Debian 12 开发工具链一键部署

欢迎加入开源鸿蒙 PC 社区：https://harmonypc.csdn.net/
在这里插入图片描述

一、服务器初始状态

SSH 登录后首先查看硬件和系统信息：

📸 图 1：服务器初始状态 — 系统信息检查（uname、os-release、lscpu、free、df）

01-系统信息检查

项目详情
OSDebian GNU/Linux 12 (bookworm)
内核6.1.0-10-amd64
CPU1 vCPU，Intel Xeon E5-2673 v4 @ 2.30GHz
内存961 MiB 总量，实际可用约 578 MiB
磁盘50 GB（已用 6.1G，剩余 44G）
Swap2.0 GiB
架构x86_64

📸 图 2：初始工具检查（gcc/g++/make ✅ / cmake/git/node/java ❌）

02-初始工具检查

工具状态
GCC / G++ 12.2.0✅ 已安装
Make 4.3✅ 已安装
Python 3.11.2✅ 已安装
Curl 7.88.1✅ 已安装
CMake❌ 未安装
Git❌ 未安装
Node.js❌ 未安装
Java❌ 未安装

二、安装过程

步骤 1~2：更新 APT 索引 & 安装核心开发工具链

apt-get update
apt-get install -y git cmake tree wget vim htop \
  pkg-config ninja-build autoconf automake libtool gdb strace

安装 37 个新包 + 升级 2 个包，共占用 172 MB 磁盘空间。

📸 图 3：APT 更新 + 核心工具安装（git 2.39.5、cmake 3.25.1、ninja 1.11.1、gdb 13.1）

03-核心工具安装

步骤 3：安装 Qt6 全栈开发环境

apt-get install -y qt6-base-dev qt6-tools-dev qt6-tools-dev-tools \
  qt6-base-dev-tools libqt6opengl6-dev libqt6svg6-dev \
  libgl1-mesa-dev libglu1-mesa-dev libxkbcommon-dev \
  libx11-dev libxext-dev libxi-dev libxcb1-dev \
  libfontconfig1-dev libfreetype6-dev libssl-dev \
  libicu-dev libsqlite3-dev libjpeg-dev libpng-dev libtiff-dev

本次安装了 Qt6 Base (6.4.2)、Qt6 Tools (Designer/Linguist/Assistant)、Qt6 SVG、OpenGL/Mesa 22.3.6、X11/XCB/Wayland 全栈图形依赖。

📸 图 4：Qt6 全栈 + OpenGL/Mesa + X11 图形库安装

04-Qt6图形库安装

步骤 4~5：安装 Java/Node.js + Clang/LLVM 工具链

# Java & 构建工具（DevEco Studio 运行必需）
apt-get install -y default-jdk default-jre maven gradle \
  openssh-server rsync unzip zip

# Clang/LLVM + Node.js + 交叉编译
apt-get install -y nodejs npm ccache patchelf clang llvm lld \
  qemu-user-static binfmt-support
  • Java OpenJDK 17.0.19 + Gradle 4.4.1 + Maven 3.8.7：DevEco Studio / HAP 构建
  • Node.js 18.20.4 + npm 9.2.0：hvigor 前端依赖
  • Clang/LLVM 14.0.6 + LLD：HarmonyOS NDK 编译备选
  • QEMU User Static 7.2：ARM 二进制本地模拟运行

📸 图 5：Java/Node.js + Clang/LLVM + QEMU 安装全过程

05-Java-Node-Clang安装

三、最终环境汇总

3.1 磁盘使用变化

时刻已用剩余使用率
安装前6.1 GB44 GB13%
安装后8.6 GB42 GB18%

总安装增加约 2.5 GB。

3.2 完整工具链版本清单

类别工具版本
编译器GCC / G++12.2.0 (Debian 12.2.0-14)
编译器Clang / LLVM14.0.6
链接器LLD14.0.6
构建系统CMake3.25.1
构建系统Ninja1.11.1
构建系统Make4.3
构建系统Autoconf2.71
构建系统Automake1.16.5
构建系统Libtool2.4.7
版本管理Git2.39.5
调试器GDB13.1
调试器Strace6.1
QtQt66.4.2
JavaOpenJDK17.0.19
JavaGradle4.4.1
JavaMaven3.8.7
Node.jsNode18.20.4
Node.jsnpm9.2.0
PythonPython33.11.2
图形OpenGL / Mesa22.3.6
图形GTK33.24.38
交叉编译QEMU User Static7.2
ELF 工具Patchelf0.17.2
缓存Ccache4.8
远程OpenSSH Server9.2p1

3.3 快速验证

最终在服务器上执行全面验证：

📸 图 6：最终环境全量验证汇总（OS/磁盘/编译器/运行时/Qt 全部 Check）

06-最终环境验证汇总

四、已安装的能力清单

编译链

  • ✅ GCC 12.2.0 + G++ 12.2.0：C/C++ 标准编译器，支持 C++20
  • ✅ Clang/LLVM 14.0.6 + LLD：备用编译器 + 高速链接器（HarmonyOS DevEco 需要）
  • ✅ CMake 3.25.1 + Ninja 1.11.1：跨平台构建系统（Qt 项目标配）

Qt 全栈

  • ✅ Qt6 6.4.2：Qt6Core、Qt6Gui、Qt6Widgets、Qt6OpenGL、Qt6OpenGLWidgets、Qt6Svg、Qt6PrintSupport、Qt6Quick、Qt6QuickWidgets
  • ✅ Qt6 Tools：Designer、Linguist、Assistant
  • ✅ qmake6：Qt 项目生成工具（已验证可用）

图形 & 桌面

  • ✅ OpenGL / Mesa 22.3.6：GL、GLU、GLES 全套
  • ✅ X11 + XCB：所有 X11 扩展开发头文件
  • ✅ Wayland：Wayland Client/Server/Cursor/EGL
  • ✅ GTK3 3.24.38 + Cairo + Pango + HarfBuzz：GTK 平台主题支持
  • ✅ Fontconfig + FreeType：字体渲染

系统库

  • ✅ OpenSSL 3.0：加密/TLS
  • ✅ ICU 72.1：国际化
  • ✅ DBus 1.14：进程间通信
  • ✅ SQLite3：嵌入式数据库
  • ✅ JPEG/PNG/TIFF/WebP：图像编解码

DevEco / HarmonyOS 工具链

  • ✅ Java OpenJDK 17：DevEco Studio 运行必需
  • ✅ Gradle 4.4.1 + Maven 3.8.7：HAP/HSP 构建
  • ✅ Node.js 18.20.4 + npm 9.2.0：hvigor 构建工具依赖

调试 & 辅助

  • ✅ GDB 13.1 + Strace 6.1：调试利器
  • ✅ Patchelf 0.17.2：ELF 文件修改（修复 so 对齐 / RPATH）
  • ✅ Ccache 4.8：编译缓存加速
  • ✅ QEMU User Static 7.2：ARM 二进制本地运行（用于测试鸿蒙产物）

五、后续工作建议

  1. 安装 DevEco Studio：需要从华为官网下载 Linux 版本，Java 和 Node 环境已就绪
  2. 拉取鸿蒙 Qt 源码：git clone 各个适配项目到服务器
  3. 配置交叉编译工具链：HarmonyOS SDK 的 OHOS NDK（ohos.toolchain.cmake）
  4. 测试编译：先用 CMake + Ninja 编译一个小项目验证工具链
  5. SSH Key 配置：ssh-keygen 生成密钥，配置到工蜂/GitHub
# harmonyos # 服务器 # debian
Logo
Harmony PC 开发者社区

赋能鸿蒙PC开发者，共建全场景原生生态，共享一次开发多端部署创新价值。

更多推荐

鸿蒙 PC 上可用的 AI Agent 工具汇总（持续更新）

本文总结了主流AI编程工具在鸿蒙PC平台的获取方式，涵盖通用类和编程类工具。开源工具占多数，包括OpenClaw、Hermes Agent等，主要通过Harmonybrew、npm或应用市场安装。部分工具如Claude Code新版需要Linux兼容方案运行，而OpenCode目前只有第三方移植版本。闭源工具如Anthropic的Claude Code和Tencent的CodeBuddy Code

avatar Harmony PC 开发者社区

鸿蒙 PC 开发 RN 跨平台应用完整体验｜从环境搭建到应用运行全流程实战

本文介绍了在鸿蒙PC上本地开发React Native应用的完整流程： 环境准备： 需准备鸿蒙PC（HarmonyOS 6.1.0+）和网络连接 安装DevEco Studio和配置HDC调试工具 设置必要的环境变量 项目创建： 使用React Native CLI初始化项目 安装鸿蒙适配依赖包 配置Metro打包工具支持鸿蒙平台 原生工程集成： 在DevEco Studio创建原生鸿蒙工程 配置

avatar Harmony PC 开发者社区

几个主流的环境管理器（rustup、uv、nvm、fnm）已经在鸿蒙 PC 上可用

在进行软件开发的过程中，开发者经常需要用到各种环境管理器来管理自己的开发环境：Rust 用 rustup，Python 用 uv，Node.js 用 nvm 或 fnm。这些环境管理器都没有官方适配鸿蒙，用户很难在鸿蒙 PC 上使用这些工具。现在，这四款环境管理器已经全部收录进 Harmonybrew 并完成了鸿蒙适配。本文介绍它们的使用方式以及适配原理。

avatar Harmony PC 开发者社区