📝 适合人群:HarmonyOS 应用开发者、OpenHarmony 开发者、初学者
⏱️ 预计时间:30-60 分钟(包含 SDK 下载)
🎯 学习目标:成功在 Windows 11 上安装并配置 DevEco Studio


📖 什么是 DevEco Studio?

DevEco Studio 是华为官方提供的一站式集成开发环境(IDE),专门用于开发 HarmonyOS 和 OpenHarmony 应用,它可以帮助你:

  • 应用开发:开发 HarmonyOS/OpenHarmony 应用和原子化服务
  • 代码编写:智能代码补全、语法高亮、实时错误检查
  • 可视化预览:实时预览界面效果,所见即所得
  • 模拟器调试:内置模拟器,无需真机即可测试应用
  • 真机调试:支持连接真实设备进行调试
  • 项目管理:完整的项目管理和构建工具

💡 小提示:DevEco Studio 基于 IntelliJ IDEA 开发,如果你使用过 Android Studio,会感觉非常熟悉!


🖥️ 测试环境

本文档基于以下环境进行测试,不同配置的电脑安装过程基本相同:

  • 💻 设备规格
    • 处理器:13th Gen Intel® Core™ i5-13500H (3.19 GHz)
    • 内存:16.0 GB
    • 系统类型:64 位操作系统, 基于 x64 的处理器
  • 🪟 Windows规格
    • 版本:Windows 11 家庭版
    • 版本号:25H2
    • 操作系统版本:26200.7462

⚠️ 注意

  • DevEco Studio 支持 Windows 7 及以上版本(64 位)
  • 建议内存至少 8 GB,推荐 16 GB 或以上
  • 需要至少 10 GB 的可用磁盘空间(包含 SDK)

📋 安装前准备

在开始安装之前,请确保:

  • 已注册华为开发者账号:需要实名认证的华为开发者联盟账号
  • 网络连接正常:下载和安装过程需要稳定的网络连接
  • 磁盘空间充足:至少准备 10 GB 可用空间
  • 管理员权限:安装过程可能需要管理员权限

💡 小提示:如果没有华为开发者账号,可以访问 华为开发者联盟 免费注册。


📥 第一步:下载 DevEco Studio

方法一:官网下载(推荐)

  1. 🌐 打开浏览器(Chrome、Edge、Firefox 等),访问 华为开发者联盟官网
  2. 🧭 点击页面顶部菜单栏的 “开发”“下载”“所有工具”“DevEco Studio” 进入下载页面
  3. 💻 根据你的操作系统切换选项卡(Windows/Mac x86/Mac ARM),找到 Windows 版本
  4. 👆 点击页面上的 “DevEco Studio for Windows 6.0.1.251(2.6GB)” 链接开始下载

image-20251219142910688

⚠️ 重要提示

  • 下载前需要登录华为开发者联盟账号(需要实名认证)
  • 如果没有账号,请先注册并完成实名认证
  • 下载文件大小约 2.6 GB,根据网络速度可能需要 10-30 分钟
  • 下载的文件名类似 devecostudio-windows-6.0.1.251.zip

💡 小提示

  • 如果下载速度慢,可以尝试使用下载工具(如 IDM、迅雷等)
  • 下载完成后,建议校验文件完整性(如果提供了 MD5 值)

🔧 第二步:安装 DevEco Studio

安装过程大约需要 5-10 分钟,请耐心跟随以下步骤:

📌 步骤 1:解压并启动安装程序

  1. 📦 找到下载好的 devecostudio-windows-6.0.1.251.zip 文件(通常在 “下载” 文件夹中)

  2. 📂 右键点击压缩包,选择 “解压到当前文件夹” 或使用解压软件解压

  3. 👆 解压完成后,双击 deveco-studio-6.0.1.251.exe 安装程序

  4. ⚠️ 如果出现安全提示,点击 “运行”“是”

image-20251219143523200

⚠️ 注意:如果系统提示需要管理员权限,请右键选择 “以管理员身份运行”


📌 步骤 2:欢迎界面

  1. 👋 安装向导会显示欢迎界面
  2. 👆 点击 “下一步(N)” 按钮继续

image-20251219143729206

💡 小提示:这是标准的安装向导流程,按照提示操作即可。


📌 步骤 3:选择安装位置

  1. 📂 安装向导会显示默认安装路径(通常是 C:\Program Files\Huawei\DevEco Studio

  2. 你可以:

    • 使用默认路径:直接点击 “下一步(N)”推荐新手
    • 🔄 自定义路径:点击 “浏览(B)” 按钮选择其他位置

image-20251219143941720

💡 小提示

  • 建议使用默认路径,避免后续配置问题
  • 如果 C 盘空间不足,可以选择其他盘符(如 D 盘)
  • 确保选择的路径有足够的磁盘空间(至少 5 GB)

📌 步骤 4:选择安装选项(重要)

强烈推荐勾选以下所有选项

  • “创建桌面快捷方式”:在桌面创建 DevEco Studio 图标(推荐,方便快速启动)
  • “更新PATH变量”:将 DevEco Studio 添加到系统环境变量(强烈推荐,方便在命令行使用)
  • “更新上下文菜单”:右键文件/文件夹时可以选择用 DevEco Studio 打开(强烈推荐,非常方便)

image-20251219144158501

💡 小提示

  • 勾选 “更新PATH变量” 后,你可以在命令行使用 DevEco Studio 相关命令
  • 勾选 “更新上下文菜单” 后,你可以右键任何文件夹,选择用 DevEco Studio 打开项目
  • 这些选项都可以在安装后手动配置,但安装时勾选更方便

📌 步骤 5:选择开始菜单文件夹

保持默认设置即可,直接点击 “安装(I)” 按钮开始安装。

image-20251219144346405

💡 小提示:开始菜单文件夹名称不影响使用,保持默认即可。


📌 步骤 6:等待安装完成

  1. ⏳ 安装过程会自动进行,你会看到安装进度条
  2. ⏱️ 通常需要 5-10 分钟,请耐心等待
  3. ✅ 安装完成后,会显示完成界面

📌 步骤 7:完成安装并重启

  1. ✅ 看到 “安装完成” 提示后,强烈建议选择 “是,立即重新启动”

  2. 🔄 点击 “完成(F)” 按钮,电脑会自动重启

image-20251219153010635

⚠️ 重要提示

  • 如果之前勾选了 “更新PATH变量”必须重启电脑才能使环境变量生效
  • 重启后,PATH 变量才会正确配置,命令行功能才能正常使用
  • 如果选择稍后重启,记得手动重启电脑

🎉 恭喜! DevEco Studio 已经成功安装到你的电脑上了!

✅ 第三步:启动 DevEco Studio

方法一:通过桌面快捷方式启动(推荐)

  1. 🖥️ 在桌面上找到 “DevEco Studio” 图标
  2. 👆 双击打开
  3. ⏳ 首次启动可能需要 1-2 分钟,请耐心等待

方法二:通过开始菜单启动

  1. 🔍 按 Win 键打开开始菜单
  2. 输入 DevEco Studio
  3. 👆 点击打开

📌 首次启动:同意许可协议

  1. 📄 首次启动会弹出许可协议界面 “Please read and accept these terms and conditions.”
  2. 📖 仔细阅读许可协议(可选,但建议了解)
  3. ✅ 点击 “Agree” 按钮同意协议

image-20251219153517215

💡 小提示:DevEco Studio 是华为官方提供的免费开发工具,可以放心使用。


📌 选择 UI 主题(可选)

  1. 🎨 进入欢迎界面后,会提示 “Meet the New UI”
  2. 你可以:
    • 使用新版 UI:点击 “Enable and Restart” 启用新版 UI 并重启 IDE(推荐,界面更现代)
    • ⏸️ 稍后选择:点击 “x” 跳过,稍后可以在设置中更改

image-20251219153728537

💡 小提示

  • 新版 UI 界面更简洁现代,推荐使用
  • 如果选择启用新版 UI,IDE 会自动重启
  • 如果选择跳过,稍后可以在 “File”“Settings”“Appearance & Behavior”“New UI” 中启用

📦 第四步:下载 OpenHarmony SDK

SDK(Software Development Kit) 是开发 HarmonyOS/OpenHarmony 应用所必需的工具包,包含 API、模拟器、工具等。首次使用 DevEco Studio 必须下载 SDK。

⚠️ 重要提示

  • SDK 下载需要稳定的网络连接
  • SDK 文件较大(约 2-5 GB),下载可能需要 20-60 分钟
  • 确保有足够的磁盘空间(至少 5 GB)

📌 步骤 1:打开设置界面

  1. 🎯 在 DevEco Studio 欢迎界面,点击左侧菜单栏的 “Customize” 按钮
  2. ⚙️ 点击 “Keymap”“Configure…” 打开设置界面

image-20251219174727295

💡 小提示:也可以通过 “File”“Settings”(或按 Ctrl + Alt + S)打开设置。


📌 步骤 2:打开 SDK 设置

  1. 📂 在设置页面左侧,找到并点击 “OpenHarmony SDK” 菜单
  2. ✏️ 点击 “Edit” 按钮选择 OpenHarmony SDK 的存储路径

image-20251219174901352

💡 小提示

  • SDK 默认存储在 C:\Users\你的用户名\AppData\Local\Huawei\Sdk
  • 如果 C 盘空间不足,建议选择其他盘符(如 D 盘)

📌 步骤 3:设置 SDK 存储路径

  1. 📁 在 “Location” 路径下设置 SDK 存储路径
  2. ✅ 路径设置完成后,点击 “OK” 按钮
  3. ✅ 路径会更新显示在 Location 下,点击 “Next” 按钮开始下载

image-20251219175133496

💡 小提示

  • 选择一个空间充足的磁盘位置
  • 路径中不要包含中文字符,避免潜在问题
  • 建议使用默认路径,除非空间不足

📌 步骤 4:查看 SDK 配置信息

  1. 📋 在弹出的 SDK 配置信息界面,仔细查看当前 SDK 配置信息
  2. ✅ 确认无误后,点击 “Next” 按钮继续

image-20251219175333254

💡 小提示:这里会显示将要下载的 SDK 版本和组件,保持默认即可。


📌 步骤 5:同意 SDK 许可协议

  1. 📄 在弹出的接受协议界面,仔细阅读许可协议
  2. ✅ 勾选 “Accept” 表示同意协议
  3. 👆 点击 “Next” 按钮开始下载 SDK

image-20251219175502029

⚠️ 注意:必须同意协议才能继续下载 SDK。


📌 步骤 6:等待 SDK 下载完成

  1. ⏳ SDK 下载会自动开始,你会看到下载进度条
  2. ⏱️ 下载时间取决于网络速度,通常需要 20-60 分钟
  3. ☕ 这是休息的好时机,可以喝杯咖啡或做其他事情
  4. ✅ 下载完成后,点击 “Finish” 按钮关闭窗口

image-20251219180404305

image-20251219180449201

💡 小提示

  • 下载过程中不要关闭 DevEco Studio
  • 如果下载中断,可以重新进入设置继续下载
  • 下载完成后,SDK 就可以使用了

🎉 恭喜! OpenHarmony SDK 已经成功下载并配置完成!


🔍 第五步:检查开发环境

安装完成后,建议检查开发环境配置是否完整:

  1. 🔍 在 DevEco Studio 欢迎界面,点击左侧菜单栏的 “Diagnose” 按钮
  2. 📊 打开环境检测界面,查看当前环境配置是否完整

image-20251219180637526

  1. ✅ 检查以下项目:
    • 操作系统:Windows 10/11(64-bit)
    • 内存:8GB或更高
    • 网络是否正确连接
    • ohpm是否可以正常访问
    • Git工具是否安装

💡 小提示

  • 如果所有项目都显示 ✅,说明环境配置完整
  • 如果有 ❌ 或 ⚠️ 标记,按照提示修复即可
  • 大多数情况下,环境会自动配置正确

✅ 第六步:验证安装

安装完成后,我们可以通过以下方式验证 DevEco Studio 是否安装成功:

方法一:通过桌面快捷方式启动

  1. 🖥️ 在桌面上找到 “DevEco Studio” 图标
  2. 👆 双击打开
  3. ✅ 如果看到 DevEco Studio 的欢迎界面,说明安装成功!

方法二:通过开始菜单启动

  1. 🔍 按 Win 键打开开始菜单
  2. 输入 DevEco Studio
  3. 👆 点击打开
  4. ✅ 如果看到 DevEco Studio 的欢迎界面,说明安装成功!

方法三:创建测试项目

  1. 🆕 在欢迎界面点击 “Create Project” 创建新项目
  2. 📱 选择一个项目模板(如 “Empty Ability”
  3. ✅ 如果项目创建成功,说明安装和配置都正确!

🎨 第七步:首次使用指南

1. 熟悉界面布局

DevEco Studio 的界面主要分为以下几个区域:

  • 📁 项目结构:左侧显示项目文件和目录结构
  • 📝 代码编辑区:中间是编写代码的主要区域
  • 🔍 工具窗口:底部和右侧显示日志、终端、预览等
  • 🎯 工具栏:顶部包含运行、调试、构建等按钮

2. 基本设置

调整字体大小
  1. 点击 “File”“Settings”(或按 Ctrl + Alt + S
  2. 搜索 font
  3. 调整 “Editor”“Font”“Size” 的值(默认是 12,可以改为 14 或更大)
启用自动保存
  1. 在设置中搜索 save
  2. “Editor”“General”“Synchronization”“Save files automatically” 设置为 If application is idle for 15 sec
选择主题
  1. 在设置中搜索 theme
  2. 选择 “Appearance & Behavior”“Appearance”“Theme”
  3. 选择一个你喜欢的主题(推荐 “Darcula”“IntelliJ Light”

3. 创建第一个项目

  1. 🆕 在欢迎界面点击 “Create Project”
  2. 📱 选择项目类型(如 “Empty Ability”
  3. 📝 填写项目信息:
    • Project name:项目名称
    • Project type:项目类型
    • Compile SDK:编译 SDK 版本
    • Language:开发语言(ArkTS/JS)
  4. ✅ 点击 “Finish” 创建项目

🎯 下一步该做什么?

现在 DevEco Studio 已经安装并配置完成,你可以:

  1. 📚 学习 HarmonyOS 开发

    • 学习 ArkTS 或 JavaScript 语言
    • 了解 HarmonyOS 应用架构
    • 学习组件和布局的使用
  2. 📖 学习资源推荐

  3. 🎓 实践项目

    • 创建你的第一个 Hello World 应用
    • 学习使用预览器查看界面效果
    • 学习使用模拟器运行应用
  4. 🔌 探索功能

    • 学习使用代码补全和智能提示
    • 学习使用调试功能
    • 学习使用 Git 版本控制

❓ 常见问题(FAQ)

Q1: 安装时提示"需要管理员权限"怎么办?

A: 右键点击安装程序,选择 “以管理员身份运行”


Q2: 下载 SDK 时速度很慢或中断怎么办?

A: 可能的原因:

  1. 网络连接不稳定
  2. 服务器负载高

解决方法

  • 检查网络连接
  • 尝试在网络较好的时段下载
  • 如果中断,可以重新进入设置继续下载(支持断点续传)

Q3: 安装完成后,找不到 DevEco Studio 在哪里?

A: 可以通过以下方式找到:

  • 桌面快捷方式(如果创建了)
  • 开始菜单搜索 DevEco Studio
  • 文件资源管理器地址栏输入 deveco(如果添加了 PATH)

Q4: 如何卸载 DevEco Studio?

A:

  1. 打开 “设置”“应用”“应用和功能”
  2. 搜索 “DevEco Studio”
  3. 点击 “卸载”

⚠️ 注意:卸载 DevEco Studio 不会自动删除 SDK,如果需要删除 SDK,需要手动删除 SDK 文件夹。


Q5: 如何更新 DevEco Studio 到最新版本?

A: DevEco Studio 会自动检查更新,你可以:

  • 点击 “Help”“Check for Updates”
  • 或者访问 华为开发者联盟 下载最新版本覆盖安装

Q6: SDK 下载失败怎么办?

A: 可能的原因:

  1. 网络连接问题
  2. 磁盘空间不足
  3. 防火墙阻止

解决方法

  • 检查网络连接
  • 确保有足够的磁盘空间(至少 5 GB)
  • 检查防火墙设置
  • 尝试重新下载

Q7: 环境检测显示某些项目未配置怎么办?

A:

  1. 查看具体的错误信息
  2. 按照提示修复问题
  3. 大多数情况下,点击 “Fix” 按钮可以自动修复
  4. 如果无法自动修复,可以手动配置或重新安装相关组件

Q8: 如何更改 SDK 存储路径?

A:

  1. 打开 “File”“Settings”“OpenHarmony SDK”
  2. 点击 “Edit” 按钮
  3. 选择新的存储路径
  4. 点击 “OK” 保存

⚠️ 注意:更改 SDK 路径后,需要重新下载 SDK。


Q9: 创建项目时提示 SDK 未配置怎么办?

A:

  1. 确保已经完成 SDK 下载(参考第四步)
  2. 检查 SDK 路径是否正确
  3. 如果 SDK 路径错误,可以在设置中重新配置
  4. 如果问题仍然存在,尝试重新下载 SDK

Q10: DevEco Studio 启动很慢怎么办?

A: 可以尝试:

  1. 关闭不需要的插件
  2. 增加内存分配:“Help”“Edit Custom VM Options”,调整内存参数
  3. 关闭实时预览功能(如果不需要)
  4. 如果内存不足,考虑升级电脑内存

🎉 总结

恭喜你完成了 DevEco Studio 的安装和基本配置!现在你已经可以:

  • ✅ 使用 DevEco Studio 开发 HarmonyOS/OpenHarmony 应用
  • ✅ 下载和管理 SDK
  • ✅ 创建和管理项目
  • ✅ 开始你的 HarmonyOS 开发之旅

记住:实践是最好的老师,多动手操作,多尝试不同的功能,很快你就能熟练掌握 DevEco Studio 了!

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐