2. 开发环境总览：搭建鸿蒙源码开发环境所需的软硬件清单与整体流程

好，咱们正式开始动手之前，得先把家底儿盘清楚。

搭建鸿蒙源码开发环境，说白了就是给你的电脑配齐一套“行头”。我见过不少新手，一上来就急着敲命令，结果编译到一半发现磁盘不够、内存爆了，或者系统版本不对，那叫一个头疼。所以，咱们先花几分钟，把需要的东西列个清单，心里有个底。

2.1 硬件清单：你的电脑够不够“壮”？

编译鸿蒙源码，可不是写个 Hello World。它需要电脑有把子力气。我个人习惯，在开始一个大项目前，先看看硬件能不能扛得住。

2.2 软件清单：这些工具你得备齐

硬件到位了，软件就是我们的“武器库”。说白了，就是一堆命令行工具和开发套件。

• Linux 系统：推荐 Ubuntu 20.04 或 22.04 LTS。这是官方支持最好的环境。
• Git：版本控制工具，用来下载源码。版本要 2.20 以上。
• Python：鸿蒙的构建系统依赖 Python。建议 3.8 到 3.10 版本。
• repo 工具：Google 出的，用来管理多个 Git 仓库。鸿蒙源码就是靠它拉下来的。
• 编译工具链：包括 GCC、Clang、Make、CMake 等。鸿蒙官方会提供一套预编译好的工具链，我们直接下载就行。
• Node.js 和 Hvigor：如果你要开发应用层，这两个是必须的。Hvigor 是鸿蒙自己的构建工具，类似 Android 的 Gradle。

2.3 整体流程：一张图看懂全过程

嗯，这里我用一张流程图，把整个搭建过程串起来。你跟着这个节奏走，就不会乱。

你看，整个流程并不复杂。说白了就是：准备机器 → 装工具 → 拉代码 → 配环境 → 编译 → 验证。这六步走完，你的开发环境就立起来了。

2.4 避坑指南：我踩过的那些坑

流程看着简单，但实际操作中，有几个地方特别容易出问题。我把自己踩过的坑分享给你，你遇到了直接绕过去就行。

• 磁盘空间不足：我曾经以为120GB够用，结果编译到一半，系统提示磁盘满了。后来一查，光是编译生成的中间文件就占了80GB。所以，至少留150GB空闲空间。
• Python 版本不对：鸿蒙的构建脚本对 Python 版本很敏感。我试过用 Python 3.12，结果一堆语法错误。老老实实换回 3.9，一切正常。建议用 Python 3.8 - 3.10。
• 网络问题导致 repo sync 失败：下载源码时，如果网络不稳定，很容易中断。我的经验是：用国内镜像源，或者挂个稳定的代理。实在不行，就分多次 sync，用 repo sync -c --no-tags 只下载当前分支，能省不少流量。
• 编译时缺少依赖库：比如 libssl-dev、libffi-dev 这些。别慌，看报错信息，缺什么就用 apt install 装什么。我一般会提前装好一组常用库：sudo apt install -y git python3 python3-pip curl wget build-essential。

好了，清单和流程都清楚了。接下来，咱们就一步步动手，把环境真正搭起来。你准备好了吗？