3. 开发环境搭建（上）：安装Ubuntu虚拟机、配置VSCode、安装Python3、Git、Repo工具
说实话，做鸿蒙移植这件事，最磨人的往往不是代码本身，而是环境搭建。我见过太多人卡在这一步，折腾一整天连个Hello World都跑不起来。所以这一章，咱们把地基打牢。
我会带着你一步步来。先装虚拟机，再配开发工具，最后把Python、Git、Repo这些必备品装好。嗯，跟着我的节奏走，别跳步。
本章核心目标：在你的Windows或macOS电脑上，搭建一套完整的鸿蒙系统移植开发环境。说白了，就是让Linux跑起来，让代码能写、能拉、能编译。
3.1 安装Ubuntu虚拟机
鸿蒙的编译环境是基于Linux的。我个人习惯用Ubuntu 20.04 LTS，这个版本稳定，社区支持好，踩过的坑网上都有答案。
你可能会问：为什么不用双系统？我在项目中遇到过，双系统切换起来太麻烦，而且万一搞崩了引导，整个电脑都进不去。虚拟机就灵活多了，快照一恢复，啥事没有。
3.1.1 下载VMware Workstation
去VMware官网下载Workstation Pro（Windows）或Fusion（macOS）。有30天试用期，足够了。如果你有教育邮箱，可以申请免费许可证。
3.1.2 下载Ubuntu 20.04 LTS镜像
去Ubuntu官网下载桌面版ISO文件。我建议用64位的，别问为什么，现在32位基本绝迹了。
3.1.3 创建虚拟机
- 打开VMware，点击「创建新的虚拟机」
- 选择「典型（推荐）」配置
- 选择「稍后安装操作系统」
- 客户机操作系统选「Linux」，版本选「Ubuntu 64位」
- 给虚拟机起个名字，比如「HarmonyOS_Dev」
- 磁盘大小建议给80GB以上，鸿蒙源码拉下来就十几个G，编译中间文件更占空间
- 自定义硬件：内存至少8GB，处理器至少2核
注意：我曾经因为磁盘只给了40GB，编译到一半空间不够，整个环境废了重来。磁盘空间别省，80GB起步，100GB更稳。
3.1.4 安装Ubuntu系统
挂载ISO镜像，启动虚拟机。安装过程很简单，选中文、设置用户名密码、分区默认就行。唯一要注意的是：安装时勾选「为图形或无线硬件安装第三方软件」，这样显卡驱动能自动装好，界面不会卡顿。
3.2 配置VSCode
编辑器这块，我推荐VSCode。轻量、插件丰富、远程开发支持好。你想想看，后面我们要在虚拟机里写代码，VSCode的Remote-SSH插件能让你在Windows上直接编辑Linux里的文件，多方便。
3.2.1 在Windows/macOS上安装VSCode
去code.visualstudio.com下载安装包，一路下一步就行。装完后打开，你会看到一个欢迎页面。
3.2.2 安装必要插件
按Ctrl+Shift+X打开扩展商店，搜索并安装以下插件：
| 插件名称 | 用途 |
|---|---|
| Remote - SSH | 远程连接虚拟机，直接在宿主机编辑代码 |
| C/C++ | 代码高亮、智能提示、调试支持 |
| Python | Python语言支持，后面写脚本用得上 |
| GitLens | 增强Git功能，看代码历史很方便 |
| Chinese (Simplified) | 中文界面，看着舒服 |
小技巧：装完Remote-SSH后，按F1输入「Remote-SSH: Connect to Host」，然后输入用户名@虚拟机IP，就能连上去了。第一次连接会提示你输入密码，之后可以配置密钥免密登录。
3.2.3 配置VSCode设置
打开设置（Ctrl+,），推荐调整以下几项：
editor.fontSize：设为16，保护眼睛editor.wordWrap：设为on，代码自动换行files.autoSave：设为afterDelay，自动保存文件terminal.integrated.fontSize：设为14，终端字体别太小
3.3 安装Python3
鸿蒙的编译脚本很多是用Python写的。Ubuntu 20.04默认带了Python 3.8，但有时候版本不够新。我建议装Python 3.9或3.10。
3.3.1 检查当前Python版本
打开虚拟机终端，输入：
python3 --version如果显示的是3.8.x，可以继续用。但如果你遇到某些脚本报语法错误，那就升级吧。
3.3.2 安装Python 3.9
sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt install python3.9 python3.9-dev python3.9-distutils装完后，用python3.9 --version确认一下。
3.3.3 设置Python3默认指向新版本
我个人习惯不直接改系统默认的python3链接，而是用update-alternatives来管理：
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 1
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.9 2
sudo update-alternatives --config python3然后选2，就切到3.9了。
注意：别把系统自带的python3.8删掉！Ubuntu很多系统工具依赖它，删了可能会出问题。我刚开始玩Linux时就干过这种蠢事，结果apt都用不了，只能重装系统。
3.4 安装Git
Git是版本控制工具，鸿蒙源码托管在Gitee上，全靠Git来拉取和管理代码。
3.4.1 安装Git
sudo apt install git装完后验证：
git --version3.4.2 配置Git基本信息
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"这两项必须配，不然提交代码时会报错。名字用英文或拼音，邮箱用你注册Gitee的那个。
3.4.3 配置SSH密钥（可选但推荐）
用SSH方式拉取代码，不用每次都输密码：
ssh-keygen -t rsa -b 4096 -C "你的邮箱"一路回车，然后查看公钥：
cat ~/.ssh/id_rsa.pub复制输出内容，粘贴到Gitee的「设置」-「SSH公钥」里。
3.5 安装Repo工具
Repo是Google开发的工具，用来管理多个Git仓库。鸿蒙源码由几百个仓库组成，用Repo一条命令就能全部拉下来。
3.5.1 下载Repo脚本
mkdir -p ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo如果curl下载慢，可以用Gitee的镜像：
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > ~/bin/repo3.5.2 将Repo加入PATH
编辑~/.bashrc，在末尾添加：
export PATH=~/bin:$PATH然后执行source ~/.bashrc使其生效。
3.5.3 验证Repo
repo --version如果显示版本号，说明安装成功。
小技巧：Repo第一次运行时会自动下载自身的最新版本，所以第一次执行可能会慢一点。别急，等它跑完就好。
3.6 本章知识体系
下面这张图帮你理清今天装的所有东西之间的关系：
从这张图可以看得很清楚：宿主机上跑着VSCode，通过Remote-SSH连到Ubuntu虚拟机。虚拟机里装了Python、Git、Repo这三个核心工具。这就是我们后续所有工作的基础。
3.7 验证环境
全部装完后，我建议你跑一遍快速验证，确保每个工具都能用：
# 验证Python
python3 --version
# 验证Git
git --version
# 验证Repo
repo --version
# 验证SSH连接（如果配了密钥）
ssh -T git@gitee.com如果每一条都返回了正常信息，恭喜你，环境搭建成功了！
总结一下：今天我们干了三件事——装虚拟机、配VSCode、装三个核心工具。看起来步骤多，但每一步都是后面工作的基石。别嫌麻烦，磨刀不误砍柴工。