鸿蒙新手入门-环境准备问题解析

Node.js版本与API配套关系

由于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

ArkTS/JS SDK安装失败处理指导

问题现象

下载ArkTS/JS SDK时，下载失败，提示“Install ArkTS dependencies failed”或“Install JS dependencies failed”。

解决措施

ArkTS/JS SDK下载失败，一般情况下，主要是由于npm代理配置问题，或未清理npm缓存信息导致，可按照如下方法进行处理。

1. 检查网络是否受限，如果需要通过代理才能访问网络，可根据NPM代理配置指导，配置代理服务器信息。如果网络不受限，可跳过该步骤。

2. 请进入到Nodejs的配置目录（默认为C:\Users${userName}\nodejs）下打开命令行工具，执行如下命令，清理npm缓存。

   npm cache clean -f
   

3. 在DevEco Studio欢迎页面， 点击Customize > Configure… > SDK（若已打开工程，可通过工具栏Tools > SDK Manager，进入SDK管理页面），勾选ArkTS/JS SDK，点击Apply重新进行下载。

导入Sample时，提示连接Gitee超时

问题现象

导入Sample时，导入失败，提示“Failed to connect to gitee.com port 443: Time out”连接超时。

解决措施

该问题一般是由于网络受限导致，请检查网络连接状态。如果网络受限，需要通过代理服务器访问网络，请执行以下操作，配置git代理信息。

1. 进入Git安装目录（默认为C:\Program Files\Git），双击运行“git-cmd.exe”文件。

2. 在打开的命令行窗口中，执行以下命令配置代理服务器信息（将proxyUsername、ProxyPassword、proxyserver和port按照实际代理服务器进行修改）。

   说明

   如果password中存在特殊字符，如@、#、*等符号，可能导致配置不生效，建议将特殊字符替换为ASCII码，并在ASCII码前加百分号%。常用符号替换为ASCII码对照表如下：

   • !：%21
   • @：%40
   • #：%23
   • $：%24
   • &：%26
   • *：%2A

   git config --global http.proxy http://proxyUsername:proxyPassword@proxy.server.com:port
   

3. 执行完成后，请重新尝试导入Sample。

导入Sample时，提示SSL证书校验错误

问题现象

导入Sample时，导入失败，提示“SSL certificate problem: unable to get local issuer certificate”证书校验错误。