1. 环境准备：Ubuntu虚拟机搭建、Python3.8+安装、Git配置与SSH密钥生成、repo工具安装与初始化

做OpenHarmony开发，第一步就是搭环境。说实话，这一步看着简单，但坑是真不少。我见过太多人卡在环境上，一卡就是半天。今天咱们就把这四件事一次性捋清楚。

1.1 Ubuntu虚拟机搭建

我个人习惯用VMware Workstation Pro，版本16以上都行。当然你用VirtualBox也没问题，但VMware对OpenHarmony的编译环境兼容性更好一些。

具体步骤其实不复杂：

1. 下载Ubuntu 20.04 LTS镜像（别用22.04，有些依赖包还没完全适配）
2. 创建虚拟机时选“自定义”，处理器给4核以上
3. 网络类型选NAT，方便后面联网下载代码
4. 安装系统时勾选“安装第三方软件”，省得后面折腾显卡驱动

1.2 Python3.8+安装

OpenHarmony的编译脚本依赖Python 3.8以上版本。Ubuntu 20.04默认装的是Python 3.8，但有时候系统会自带Python 3.6，这就得手动处理了。

先检查当前版本：

python3 --version

如果版本低于3.8，按下面步骤升级：

sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.8 python3.8-dev python3.8-distutils
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 1

安装完成后，验证一下：

python3 --version
# 输出应为 Python 3.8.x

还要确保pip也装好了：

sudo apt install python3-pip
pip3 --version

1.3 Git配置与SSH密钥生成

Git是代码管理的核心工具。OpenHarmony的代码仓库托管在Gitee上，所以你得先配好Git，再生成SSH密钥。

先装Git：

sudo apt install git -y

然后配置用户名和邮箱——这个必须做，不然提交代码时会报错：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"

接下来生成SSH密钥。为什么要用SSH？说白了，就是让你不用每次拉代码都输密码，省事又安全。

ssh-keygen -t rsa -C "你的邮箱@example.com"
# 一路回车，默认保存在 ~/.ssh/id_rsa

生成后，把公钥添加到Gitee账户：

cat ~/.ssh/id_rsa.pub
# 复制输出的内容

然后登录Gitee，进入“设置” → “SSH公钥”，粘贴保存。

1.4 repo工具安装与初始化

repo是Google开发的一个工具，专门用来管理多Git仓库的项目。OpenHarmony的代码分散在几百个仓库里，没有repo你根本拉不下来。

安装repo很简单：

mkdir -p ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo

然后把repo加到环境变量里：

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

验证安装：

repo --version

接下来初始化OpenHarmony代码仓库。以OpenHarmony 3.2 Release为例：

mkdir ohos3.2
cd ohos3.2
repo init -u https://gitee.com/openharmony/manifest.git -b OpenHarmony-3.2-Release --no-repo-verify

初始化成功后，会看到提示信息。这时候就可以同步代码了：

repo sync -c -j4

-j4 表示用4个线程并行下载。如果你的网络带宽够大，可以改成 -j8 甚至 -j16，速度会快很多。

知识体系总览

下面这张图把本章的核心流程串起来了，你可以对照着检查自己做到哪一步：

环境检查清单

最后，给你一张检查表。每完成一项就打个勾，确保万无一失：

序号	检查项	验证命令	预期结果
1	Ubuntu版本	lsb_release -a	20.04 LTS
2	Python版本	python3 --version	3.8.x 或更高
3	Git配置	git config --list	user.name 和 user.email 已设置
4	SSH连通性	ssh -T git@gitee.com	Welcome to Gitee.com
5	repo工具	repo --version	显示版本号
6	代码同步	repo sync -c -j4	无报错，代码完整