虽然鸿蒙生态已经逐步成熟,开发工具链也越来越友好,但初次配置环境时,还是有不少同学会在安装 DevEco Studio 这一步卡住。特别是 3.1 版本配合 SDK 的配置,如果步骤顺序不对,很容易出现路径错误或组件缺失的问题。下面把整个流程拆开来讲,保证每一步都清晰可操作。

一、准备工作
先把安装包准备好。如果你的电脑上没有 DevEco Studio 3.1.0.501 的安装文件,可以从华&为开发者官网或其他靠谱渠道获取。记住,安装包名称通常是 deveco-studio-3.1.0.501.exe,下载后放在桌面上或一个固定文件夹里,方便查找。
有几个前置条件需要留意一下:
- 操作系统推荐 Windows 10 21H2 或 Windows 11,系统越新兼容性越好。
- Ja va 环境方面,DevEco Studio 新版通常自带 JBR(JetBrains Runtime),不一定非要独立安装 JDK。如果不确定,可以先不装 JDK,直接走下一步。
- 磁盘空间要充足。除了安装工具本身,后面还要下载 SDK 和模拟器镜像,C 盘或目标盘至少预留 5GB 空闲空间,否则后续下载容易报错。
- 最后,强烈建议用管理员身份运行安装程序:右键点击安装包,选择“以管理员身份运行”,避免权限不足导致安装失败。
二、安装步骤
双击刚才准备的安装包,弹窗提示“用户账户控制”,点“是”或“Yes”继续。进入欢迎界面后,直接点 Next 进入下一步。
安装路径默认是 C:\Program Files\Huawei\DevEco Studio,如果你想把工具装到其他盘,可以点 Browse 修改,建议放在一个不会轻易动到的目录。修改后点 Next 继续。
配置选项这一步,有两个勾选项目:
- Create Desktop Shortcut:创建桌面快捷方式,方便后续启动。
- Update PATH variable (restart needed):如果有这个选项,建议勾上。这样你可以在命令行里直接运行
devecostudio命令,对后续调试有帮助。
勾完后点 Next,接着会让你确认开始菜单文件夹,保持默认的“DevEco Studio”即可,点 Install 开始安装。
等待进度条走完,看到 Finish 按钮就表示安装完毕,可以先不急着点,我们先记着这一步,后面马上要进行首次启动配置。
三、首次启动与 SDK 配置(关键)
双击桌面上新出现的 DevEco Studio 图标,第一次启动会弹出导入设置的窗口。如果你之前没有使用过其他版本的 DevEco Studio,选择“Do not import settings / 不导入”,点 OK。
接着会看到隐私协议界面,勾选同意后点 Next。这一步之后,就会进入 SDK 配置环节——这是最容易出问题的地方,千万注意。
SDK Setup 页面里有两个设置要点:
- SDK Location:SDK 的安装路径。强烈建议不要放在 C 盘,因为 SDK 比较大,而且以后还会下载不同版本的 API 和模拟器镜像。建议设在空间充裕的盘,比如
D:\Huawei\Sdk。 - 选择 SDK 版本:默认勾选的版本通常能满足基本开发需求,初学者保持默认即可。如果你有特定需求(比如需要支持 API 9 的旧设备),可以额外勾选。
设置完后点 Next / Finish,工具会开始联网下载 SDK 组件。这一步需要时间,具体取决于你的网速和 SDK 大小,稍等片刻即可。下载完成后点 Finish,你就会看到 DevEco Studio 的欢迎主界面——到这里,工具安装和 SDK 配置就算完成了。
四、验证安装是否成功
打开欢迎页面,看看能不能正常显示“New Project”“Open Project”等选项。如果能看到,基本上就没问题。
更稳妥的验证方式:点击菜单栏的 Configure → Settings → SDK Manager,确认 HarmonyOS SDK 列表里能看到已安装的版本。如果列表为空,可能是 SDK 下载过程中断了,可以手动重新下载。
到这一步,整个安装流程就走完了。接下来你就可以新建一个 ArkTS 或 JS 项目,开始写鸿蒙应用了。如果后面遇到模拟器或签名的问题,再单独聊。
