
说真的,每次看到搜索框里冒出”华为 15 Pro 环境变量配置”这种词,我都替提问的朋友捏把汗——这款机型压根儿就不存在,市面上也从来没卖过。2026 年华为手机的当家花旦,早就换成了 Pura 80 Pro、Mate 80 Pro Max、nova 14 Ultra,以及折叠旗舰 Mate X7 这一票真家伙(参考 ZOL 中关村在线 Pura 80 Ultra 与 Mate 80 Pro Max 参数对比 和 腾讯新闻 Mate 80 Pro Max 评测,这两款在售旗舰一直是被对比最多的对象)。所以这篇,就拿在售的真机做主角,把”环境变量配置”这件事从头到尾讲透。

不管你是搞鸿蒙原生开发、用 ADB 调试手机,还是单纯想给电脑配 Node.js / Java / Python / Go 环境,下面这一整套流程,老九我都给你安排得明明白白。下面开整。
一、先搞清楚:环境变量到底是干嘛的?
很多人一看到”环境变量”三个字就头大,说白了它就是操作系统给你开的一个全局记事本——把常用的路径、密钥、配置参数写进去,系统和软件会自动去那里找。
在华为生态里,环境变量配置最典型的应用场景有三类,老九给你整理成下面这张对比表,方便收藏:
| 场景 | 典型用途 | 涉及工具 |
|---|---|---|
| 手机开发者调试 | ADB 连接、HDC 命令行、应用安装 | 华为手机开发者选项 |
| 鸿蒙 / 安卓应用开发 | 编译、调试、模拟器启动 | HarmonyOS NEXT SDK、DevEco Studio、Android Studio |
| 电脑端开发环境 | Node.js、Java、Python、Go 等多语言 | Windows / macOS / Linux 终端 |
下面我们就一个一个拆解,干货走起。
二、华为手机开发者选项:先把门打开
环境变量再牛,也得先把手机的开发者大门打开。这一步不搞定,后面 HDC、ADB 全白搭。
2.1 开启开发者模式(Pura 80 Pro / Mate 80 Pro Max / nova 14 Ultra / Mate X7)
操作步骤,认准这一套:
- 打开 设置 → 关于手机
- 找到 版本号,连续点击 7 次
- 系统会提示”您已处于开发者模式”
- 返回设置首页,进入 系统和更新 → 开发人员选项
2.2 必开的几个开关(按优先级排序)
进入开发者选项后,下面这几项老九建议你按优先级依次打开:
- 🔴 必开(优先级最高):USB 调试——连电脑跑 ADB 的命根子,不开啥都连不上
- 🟡 强烈建议:”仅充电”模式下允许 ADB 调试——避免手机锁屏后断连,调试到一半断了真的很破防
- 🟢 按需开启:选择模拟位置信息应用——做 LBS、导航类测试才用得上
2.3 常见坑(老九亲测总结)
- 点击版本号没反应? 多半是点到”系统版本号”而不是”手机版本号”,认准带”版本号”的那一行就行,别点错。
- 开发者选项灰了? 检查是不是登录了华为账号且系统在线,正常联网后几秒内会自动激活。
- HDC 调试开了但连不上? 优先看 USB 线是不是只支持充电不支持数据,换一根合格线能解决大半问题。
三、ADB 环境变量配置:跨系统通用教程
开发者选项开好后,电脑端才是重头戏。ADB(Android Debug Bridge)是连接华为手机和 PC 的桥梁,路径配错命令就找不到。说白了就是”系统去哪儿找这个工具”的指引。
3.1 Windows 11 / Windows 10 配置
第一步:下载工具包
到华为开发者联盟或者 Android 开发者官网下载 platform-tools,解压到一个纯英文路径,比如:
C:\dev\platform-tools
第二步:配置系统环境变量
- 右键 此电脑 → 属性 → 高级系统设置
- 点击 环境变量
- 在”系统变量”里找到
Path,双击编辑 - 新增一条:
C:\dev\platform-tools - 确定保存,关掉所有窗口
第三步:验证
打开 cmd 或 PowerShell,输入:
adb version
看到版本号输出就说明配成功了。再连上手机 USB,输入:
adb devices
正常情况下会列出你的设备序列号,前面带 device 字样。如果显示 unauthorized,检查手机端有没有弹出”允许 USB 调试”的授权框——这玩意儿默认是不显示的,需要你先点过”始终允许”。
3.2 macOS 配置
打开终端,编辑 shell 配置文件(zsh 用户编辑 ~/.zshrc,bash 用户编辑 ~/.bash_profile):
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
保存后执行:
source ~/.zshrc
验证:
adb version
3.3 Linux(Ubuntu 22.04 / Debian 12 为例)
sudo apt update
sudo apt install adb
或手动配置:
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
写入 ~/.bashrc,再 source 一下生效。
四、HarmonyOS NEXT 开发环境变量配置(2026 鸿蒙开发者必看)
这一节是 2026 年最值得讲的内容,没有之一。HarmonyOS NEXT 已经全面去 AOSP 化,原生鸿蒙应用开发成为主流,HDC(HarmonyOS Device Connector)已经取代了一部分 ADB 的角色。说白了,鸿蒙生态的”调试基建”基本被 HDC 拿捏了。
4.1 下载 DevEco Studio
到华为开发者联盟官网下载 DevEco Studio(2026 年稳定版),安装路径同样建议纯英文:
C:\dev\DevecoStudio
4.2 配置 HarmonyOS SDK 环境变量
安装完 SDK 后,默认路径在:
- Windows:
C:\Users\你的用户名\AppData\Local\Huawei\Sdk - macOS:
~/Library/Huawei/Sdk
手动配置环境变量(新增系统变量):
| 变量名 | 变量值(示例) |
|---|---|
HUAWEI_SDK_HOME |
C:\Users\你的用户名\AppData\Local\Huawei\Sdk |
HDC_HOME |
%HUAWEI_SDK_HOME%\toolchains\hdc |
PATH(追加) |
%HDC_HOME% |
macOS / Linux 用户在 ~/.zshrc 或 ~/.bashrc 里加:
export HUAWEI_SDK_HOME=$HOME/Library/Huawei/Sdk
export HDC_HOME=$HUAWEI_SDK_HOME/toolchains/hdc
export PATH=$PATH:$HDC_HOME
保存后 source 一下,终端输入:
hdc version
看到版本输出即代表 HDC 通路打通。
4.3 HDC 常用命令速查
| 命令 | 作用 |
|---|---|
hdc list targets |
列出已连接设备 |
hdc shell bm install -p xxx.hap |
安装 HAP 包 |
hdc shell aa start -b 包名 -a Ability |
启动应用 |
hdc file send local remote |
推送文件到设备 |
hdc -t 设备序列号 shell |
进入指定设备 shell |
4.4 HarmonyOS NEXT 签名 / 调试证书配置(2025 年底以来绕不开的环节)
这一段是 2025 年底之后才在开发者社区”火”起来的——HarmonyOS NEXT 对 HAP 包签名要求更严格了,老 HAP 工程直接装不上,必须配套配置调试证书。
配置流程:
- 登录华为开发者联盟 → 管理中心 → 应用开发 → 调试证书
- 新建调试 Profile,上传你的 CSR(一般在 DevEco Studio 的 Build → Generate Key and CSR 里生成)
- 把生成的
.p7b证书文件下载下来,放到项目根目录的signingConfigs/下 - 在
build-profile.json5里配置signingConfig,填好证书路径、密钥别名、Store Password - 重新 sync 工程,再
hvigor assembleHap编译
五、电脑端开发环境:Node.js / Java / Python / Go 多语言配置
很多朋友配完手机端,又掉进了电脑端的坑——这节老九把主流语言都给你过一遍。
5.1 Node.js 环境配置
到 Node.js 官网 下载 LTS 版安装包,安装时勾选 “Add to PATH” 选项,Windows 安装器会自动帮你写环境变量。
手动配置(以 Windows 为例):
setx NODE_HOME "C:\dev\nodejs"
setx PATH "%PATH%;%NODE_HOME%"
验证:
node -v
npm -v
nvm-windows(Windows)或 nvm(macOS/Linux),方便在不同 Node 版本之间切换,做鸿蒙前端开发时这点特别有用。5.2 Java 环境配置(鸿蒙开发必装)
到 Oracle 官网 或 Adoptium 下载 JDK(建议 JDK 17,DevEco Studio 兼容性最好)。
| 变量名 | 变量值(示例) |
|---|---|
JAVA_HOME |
C:\dev\jdk-17 |
CLASSPATH |
.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar |
PATH(追加) |
%JAVA_HOME%\bin |
验证:
java -version
javac -version
5.3 Python 环境配置
到 Python 官网 下载安装,Windows 安装时务必勾选 “Add Python to PATH”。
验证:
python --version
pip --version
pyenv(macOS/Linux)或 pyenv-win(Windows)管理多版本,避免项目之间互相打架。5.4 Go 环境配置
到 Go 官网 下载安装包。
| 变量名 | 变量值(示例) |
|---|---|
GOROOT |
C:\dev\go |
GOPATH |
C:\dev\goproject |
PATH(追加) |
%GOROOT%\bin;%GOPATH%\bin |
验证:
go version
六、环境变量速查表(建议收藏)
下面这张表把开发者最常用的环境变量一次性整理清楚,建议直接收藏,遇到问题查一查就行。
| 变量名 | 作用 | 典型值(Windows) | 典型值(macOS / Linux) |
|---|---|---|---|
PATH |
系统全局命令搜索路径 | 追加各类 bin 目录 | 追加各类 bin 目录 |
ANDROID_HOME |
Android SDK 根目录 | C:\dev\android-sdk |
~/Library/Android/sdk |
HUAWEI_SDK_HOME |
华为 SDK 根目录 | C:\Users\xxx\AppData\Local\Huawei\Sdk |
~/Library/Huawei/Sdk |
HDC_HOME |
HDC 工具目录 | %HUAWEI_SDK_HOME%\toolchains\hdc |
$HUAWEI_SDK_HOME/toolchains/hdc |
JAVA_HOME |
JDK 安装根目录 | C:\dev\jdk-17 |
/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home |
CLASSPATH |
Java 类加载路径 | .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar |
同上 |
NODE_HOME |
Node.js 安装目录 | C:\dev\nodejs |
/usr/local/Cellar/node |
GOROOT |
Go 安装根目录 | C:\dev\go |
/usr/local/go |
GOPATH |
Go 工作区 | C:\dev\goproject |
~/go |
PYTHON_HOME |
Python 安装目录 | C:\dev\python311 |
/usr/local/Cellar/python@3.11 |
七、实测案例:一次完整的 HDC 安装 HAP 包流程
光讲命令不够,老九直接给你走一遍完整的实操流程,照着做就行。
场景: 开发者小张在 Windows 11 上,用 DevEco Studio 编译出一个 MyApp.hap,想装到 Mate 80 Pro Max 上自测。Mate 80 Pro Max 这块 6.9 英寸大屏(数据来自 腾讯新闻 Mate 80 Pro Max 评测)装完跑起来确实爽,就是分量不轻。
步骤:
- 手机端(Mate 80 Pro Max)
- 开启开发者选项(参照第二节)
- 打开 USB 调试 + HDC 调试
- USB 连电脑,弹出授权框点”始终允许”
- 电脑端(Windows 11)
- 打开 PowerShell,输入
hdc list targets,看到设备序列号前是device字样,说明连接成功 - 切换到 HAP 所在目录,执行:
hdc install MyApp.hap看到
install bundle successfully字样说明安装成功。 - 打开 PowerShell,输入
- 启动应用
hdc shell aa start -b com.example.myapp -a EntryAbility手机桌面如果弹出应用图标,整套流程就跑通了。
error: no devices/emulators found(设备没连上)和 INSTALL_FAILED_SIGNATURE_ERROR(签名不匹配)。前者换根 USB 线试试,后者回到第四节 4.4 重新生成调试证书。八、常见环境变量报错排查
8.1 command not found(命令找不到)
source 生效。解决:
- 检查
PATH里有没有追加工具的 bin 目录 - 修改完配置文件记得
source ~/.zshrc或重启终端 - Windows 用户记得关掉所有已打开的 cmd/PowerShell 窗口,新开一个