鸿蒙开发环境搭建-高频环境问题解决

1.Node版本问题

由于SDK的部分工具依赖Node.js运行时,推荐使用配套API版本的Node.js,保证工程的兼容性。 匹配关系见下表:

API Level Node.js支持范围
API Level≤9 14.x(≥14.19.1)、16.x
API Level>9 14.x(≥14.19.1)、16.x、18.x

问题演示:

安装 sdk 模块报错

解决方案:

NodeJS 调整至合适版本

2. 淘宝镜像配置问题

淘宝镜像没配,会导致下载安装不下来,建议都配一下

复制代码
npm config set registry https://registry.npm.taobao.org

3. SDK 没下载全

SDK不下载全,会导致无法预览、无法运行一系列问题,建议自查 SDK 安装情况

问题演示:

解决方案:

4. 下载SDK - Npm缓存问题

问题演示:

下载 SDK时,下载失败,提示"Install xxx dependencies failed"。

复制代码
Install task started: ArkTS 3.2.12.5
Downloading https://contentcenter-drcn.dbankcdn.com/pub_1/DevEcoSpace_1_900_9/e7/v3/z7DmEF73SkC4rF6uvkxSog/DPm3tQiQSDG-ImWEZqxELg.zip...
Unzipping /Users/liujingxu/Documents/harmonyOS/installPath/SDK/.temp/ets/3.2.12.5/install/DPm3tQiQSDG-ImWEZqxELg.zip...
Installing ArkTS dependencies...
Running 'npm install'...
npm ERR! code EACCES
npm ERR! syscall mkdir
npm ERR! path /Users/liujingxu/.npm/_cacache/content-v2/sha512/40/6d
npm ERR! errno -13
npm ERR! 
npm ERR! Your cache folder contains root-owned files, due to a bug in
npm ERR! previous versions of npm which has since been addressed.
npm ERR! 
npm ERR! To permanently fix this problem, please run:
npm ERR!   sudo chown -R 501:20 "/Users/liujingxu/.npm"
npm ERR! A complete log of this run can be found in:
npm ERR!     /Users/liujingxu/.npm/_logs/2023-12-12T02_42_14_304Z-debug-0.log
Install task failed: ArkTS 3.2.12.5.
Install ArkTS dependencies failed.
Cause: Unable to run npm install.
Solution: See https://developer.harmonyos.com/cn/docs/documentation/doc-guides/faq-development-environment-0000001168829643#section1311117111474  

解决方案:

进入到DevEco Studio安装目录下的tools\nodejs目录下打开命令行工具 执行如下命令,清理npm缓存

复制代码
npm cache clean -f

迎页点击Configure(或图标) > Settings > SDKs,勾选 SDK,点击Apply重新进行下载。

5. SDK 没装全的问题

问题说明:

sdk没装全,导致无法模拟期运行

解决方案:

6. 模拟器黑屏问题

问题演示:

解决方案:

删除模拟器、降内存

7. 预览器选项,突然加载出不来问题

问题演示:

解决方案:

重启编辑器即可

8. TS 如何在线学习的问题

学习TS,可以直接用在线网站测试学习

9. 中文插件配置问题

注意:是已安装的插件里面开启即可

10. 华为手机链接电脑后没有显示的问题

开发者模式、USB都检查下是否打开了,如果都打开了

办法1:必须把电脑中, Windows 的 设备安全性 > 内核隔离 > 内存完整性 选项 关闭 可参考以下方式找到 内存完整性 选项 https://www.mryunwei.com/339489.html 办法2:电脑上装个华为手机助手

11. 自动生成 map、js 文件文件导致无法运行问题

问题演示:

解决方案:

将自动生成的 js 和 map 文件删除即可

12. Hyper-V虚拟化, 优化模拟器【占用过大内存空间】的问题

环境要求:win10专业版

开启前:

开启后:

开启 Hyper-V 可以降低内存占用:

13. 模拟器盯在屏幕最前面

《DeskPins | 将窗口钉在面前》

14.预览器无法预览

15. 关于提示haxm无法安装的解决方法

没有Hyper-v

  1. 将下面标记区域【勾选】

2.进入环境变量 -> 用户变量->找到path并且点击->新建输入 C:\Windows\System32

本文是对鸿蒙开发中,环境搭建出现的一系列问题解决方案,更多鸿蒙开发问题技术可以主页查看更多

相关推荐
yaoxin5211231 分钟前
124. Java 泛型 - 有界类型参数
java·开发语言
liulilittle21 分钟前
深度剖析:OPENPPP2 libtcpip 实现原理与架构设计
开发语言·网络·c++·tcp/ip·智能路由器·tcp·通信
88号技师27 分钟前
2025年6月一区-田忌赛马优化算法Tianji’s horse racing optimization-附Matlab免费代码
开发语言·算法·matlab·优化算法
勤奋的知更鸟33 分钟前
Java 编程之模板方法模式
java·开发语言·模板方法模式
上单带刀不带妹1 小时前
手写 Vue 中虚拟 DOM 到真实 DOM 的完整过程
开发语言·前端·javascript·vue.js·前端框架
-凌凌漆-2 小时前
【Qt】QStringLiteral 介绍
开发语言·qt
程序员爱钓鱼2 小时前
Go语言项目工程化 — 常见开发工具与 CI/CD 支持
开发语言·后端·golang·gin
军训猫猫头3 小时前
1.如何对多个控件进行高效的绑定 C#例子 WPF例子
开发语言·算法·c#·.net
zhanshuo3 小时前
鸿蒙应用调试与测试实战全指南:高效定位问题,性能优化必备技巧+实用代码示例
harmonyos
真的想上岸啊3 小时前
学习C++、QT---18(C++ 记事本项目的stylesheet)
开发语言·c++·学习