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

虽然鸿蒙生态已经逐步成熟，开发工具链也越来越友好，但初次配置环境时，还是有不少同学会在安装 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 按钮就表示安装完毕，可以先不急着点，我们先记着这一步，后面马上要进行首次启动配置。

三、首次启动与 SDK 配置（关键）

双击桌面上新出现的 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 配置就算完成了。

四、验证安装是否成功

打开欢迎页面，看看能不能正常显示“New Project”“Open Project”等选项。如果能看到，基本上就没问题。

更稳妥的验证方式：点击菜单栏的 Configure → Settings → SDK Manager，确认 HarmonyOS SDK 列表里能看到已安装的版本。如果列表为空，可能是 SDK 下载过程中断了，可以手动重新下载。

到这一步，整个安装流程就走完了。接下来你就可以新建一个 ArkTS 或 JS 项目，开始写鸿蒙应用了。如果后面遇到模拟器或签名的问题，再单独聊。