3、Windows环境搭建:安装Python、Git、Node.js、HPM、DevEco Device Tool
说实话,很多初学者在鸿蒙设备开发上栽的第一个跟头,不是代码写错了,而是环境没搭好。我见过太多人花了一整天装环境,最后发现某个版本对不上,心态直接崩了。
这一节,我带你一步步把Windows上的开发环境捋顺。你跟着我的节奏来,半小时内搞定。
3.1 为什么是这五个工具?
先说说为什么非得装这五个东西。你想想看,鸿蒙设备开发本质上是在PC上写代码,然后烧录到开发板上运行。这中间需要:
- Python:鸿蒙的编译脚本、打包工具,基本都是Python写的。没有它,寸步难行。
- Git:代码版本管理,拉取鸿蒙源码必备。我习惯用Git Bash,比Windows自带的cmd好用太多。
- Node.js:HPM(鸿蒙包管理器)依赖它运行。说白了,Node.js是HPM的运行时环境。
- HPM:鸿蒙的包管理工具,类似Python的pip。装组件、查依赖,全靠它。
- DevEco Device Tool:华为官方出品的IDE插件,集成了编译、烧录、调试功能。这是咱们和设备打交道的核心工具。
核心逻辑:这五个工具的关系,就像盖房子时的脚手架、水泥、砖头、图纸和工人。缺一个,活就干不下去。
下面这张图,帮你理清它们之间的关系:
3.2 安装Python
Python的安装,我建议你直接去官网下载。别用微软商店里的版本,那个路径有时候会出幺蛾子。
具体步骤:
- 打开
python.org,下载 Python 3.8 或 3.9 版本。鸿蒙官方推荐 3.8,我个人习惯用 3.9,兼容性更好。 - 安装时,一定要勾选「Add Python to PATH」。这一步忘了,后面你会哭的。
- 安装完成后,打开 cmd 或 PowerShell,输入
python --version验证。
小技巧:我习惯在安装完后,顺手把 pip 源换成国内镜像。不然下载包的时候,那个速度...你懂的。
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
3.3 安装Git
Git 的安装相对简单。去 git-scm.com 下载 Windows 版本,一路 Next 就行。
不过有几个选项需要注意:
- 选择默认编辑器:我建议选 VSCode,别选 Vim。除非你是个 Vim 老手。
- 调整 PATH 环境:选「Git from the command line and also from 3rd-party software」。这样你在 cmd 里也能直接用 git 命令。
- 换行符转换:选「Checkout Windows-style, commit Unix-style line endings」。这是为了避免团队协作时换行符打架。
安装完验证一下:
git --version
注意:我曾经遇到过一个问题——Git 安装后,在 VSCode 终端里找不到 git 命令。后来发现是安装时没选「添加到 PATH」。如果你也遇到类似情况,手动把 Git 的 bin 目录加到系统环境变量里就行。
3.4 安装Node.js
Node.js 是 HPM 的运行基础。去 nodejs.org 下载 LTS 版本,别追新。LTS 版本稳定,不容易踩坑。
安装步骤:
- 下载 .msi 安装包,双击运行。
- 一路默认选项,安装路径可以改到 D 盘(如果你 C 盘空间紧张的话)。
- 安装完成后,验证:
node --version
npm --version
嗯,这里要注意:npm 是 Node.js 自带的包管理器,后面装 HPM 会用到它。
3.5 安装HPM
HPM 的全称是 HarmonyOS Package Manager。说白了,它就是鸿蒙版的 npm 或 pip。
安装命令很简单:
npm install -g @ohos/hpm-cli
安装完成后,验证:
hpm --version
如果看到版本号,说明装好了。如果报错,多半是 Node.js 版本不对,或者网络问题。试试切换 npm 源:
npm config set registry https://registry.npmmirror.com
避坑指南:我曾经在 Windows 上装 HPM 时,遇到过一个权限问题。npm 全局安装需要管理员权限,所以记得「以管理员身份运行」cmd 或 PowerShell。
3.6 安装DevEco Device Tool
DevEco Device Tool 是华为官方提供的插件,基于 VSCode。所以第一步,你得先装 VSCode。
安装步骤:
- 下载并安装 VSCode(code.visualstudio.com)。
- 打开 VSCode,点击左侧扩展图标(或按 Ctrl+Shift+X)。
- 搜索「DevEco Device Tool」,点击安装。
- 安装完成后,重启 VSCode。
装好后,你会在 VSCode 左侧看到一个「DevEco」的图标。点进去,就能看到设备管理、烧录配置等功能。
个人经验:DevEco Device Tool 第一次启动时,会自动检测你电脑上有没有装 Python、Git、Node.js。如果检测不到,它会提示你安装。所以前面几步一定要做扎实,不然这里会卡住。
3.7 环境验证
所有工具装完后,我建议你做一个完整的验证。打开 cmd,依次输入以下命令:
| 工具 | 验证命令 | 预期输出 |
|---|---|---|
| Python | python --version |
Python 3.8.x 或 3.9.x |
| Git | git --version |
git version 2.x.x |
| Node.js | node --version |
v16.x.x 或 v18.x.x |
| HPM | hpm --version |
@ohos/hpm-cli/x.x.x |
如果全部通过,恭喜你,环境搭建完成。如果某个命令报错,别慌。检查一下环境变量,或者重新安装对应工具。
最后提醒一句:环境变量修改后,记得重启 cmd 或 VSCode。不然新加的路径不会生效。这个坑,我踩过不止一次。
公众号:蓝海资料掘金营,微信deep3321