首页 > 教程攻略 > ai教程 >Windows 下 HarmonyOS 开发工具安装（DevEco Studio 3.1 + SDK 配置详解）

Windows 下 HarmonyOS 开发工具安装（DevEco Studio 3.1 + SDK 配置详解）

来源：互联网时间：2026-06-22 10:26:07

虽然鸿蒙生态已经逐步成熟，开发工具链也越来越友好，但初次配置环境时，还是有不少同学会在安装 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 FilesHuaweiDevEco Studio，如果你想把工具装到其他盘，可以点 Browse 修改，建议放在一个不会轻易动到的目录。修改后点 Next 继续。

配置选项这一步，有两个勾选项目：

Create Desktop Shortcut
：创建桌面快捷方式，方便后续启动。
Update PATH variable (restart needed)
：如果有这个选项，建议勾上。这样你可以在命令行里直接运行 devecostudio 命令，对后续调试有帮助。

勾完后点 Next，接着会让你确认开始菜单文件夹，保持默认的“DevEco Studio”即可，点 Install 开始安装。

等待进度条走完，看到 Finish 按钮就表示安装完毕，可以先不急着点，我们先记着这一步，后面马上要进行首次启动配置。

双击桌面上新出现的 DevEco Studio 图标，第一次启动会弹出导入设置的窗口。如果你之前没有使用过其他版本的 DevEco Studio，选择“Do not import settings / 不导入”，点 OK。

接着会看到隐私协议界面，勾选同意后点 Next。这一步之后，就会进入 SDK 配置环节——这是最容易出问题的地方，千万注意。

SDK Setup 页面里有两个设置要点：

SDK Location
：SDK 的安装路径。强烈建议不要放在 C 盘，因为 SDK 比较大，而且以后还会下载不同版本的 API 和模拟器镜像。建议设在空间充裕的盘，比如 D:HuaweiSdk。
选择 SDK 版本
：默认勾选的版本通常能满足基本开发需求，初学者保持默认即可。如果你有特定需求（比如需要支持 API 9 的旧设备），可以额外勾选。

设置完后点 Next / Finish，工具会开始联网下载 SDK 组件。这一步需要时间，具体取决于你的网速和 SDK 大小，稍等片刻即可。下载完成后点 Finish，你就会看到 DevEco Studio 的欢迎主界面——到这里，工具安装和 SDK 配置就算完成了。