【鸿蒙开发者必备工具】Windows 11 安装 DevEco Studio 完整指南

📝适合人群：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)”链接开始下载

⚠️重要提示：

• 下载前需要登录华为开发者联盟账号（需要实名认证）
• 如果没有账号，请先注册并完成实名认证
• 下载文件大小约 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. ⚠️ 如果出现安全提示，点击“运行”或“是”

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

📌 步骤 2：欢迎界面

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

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

📌 步骤 3：选择安装位置

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

2. 你可以：

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

💡小提示：

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

📌 步骤 4：选择安装选项（重要）

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

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

💡小提示：

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

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

保持默认设置即可，直接点击“安装（I）”按钮开始安装。

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

📌 步骤 6：等待安装完成

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

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

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

2. 🔄 点击“完成（F）”按钮，电脑会自动重启

⚠️重要提示：

• 如果之前勾选了“更新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”按钮同意协议

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

📌 选择 UI 主题（可选）

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

💡小提示：

• 新版 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…”打开设置界面

💡小提示：也可以通过“File”→“Settings”（或按Ctrl + Alt + S）打开设置。

📌 步骤 2：打开 SDK 设置

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

💡小提示：

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

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

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

💡小提示：

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

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

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

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

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

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

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

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

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

💡小提示：

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

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

🔍 第五步：检查开发环境

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

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

3. ✅ 检查以下项目：
   • 操作系统：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. 📖学习资源推荐：

   • HarmonyOS 开发者文档
   • OpenHarmony 官方文档
   • DevEco Studio 使用指南

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 了！