一、安装前准备

1. 系统要求（Windows/macOS）

• Windows：Win10/11 64 位，内存≥16GB，SSD≥100GB 可用，分辨率≥1280×800Huawei Developer。
• macOS：12+，内存≥16GB，SSD≥100GB 可用Huawei Developer。
• 关键禁忌：安装路径绝不能有中文、空格、特殊符号（如D:\开发\DevEco不行，D:\DevEco_Studio可行）。

2. 下载 DevEco Studio

1. 访问华为开发者联盟：https://developer.harmonyos.com/cn/develop/deveco-studio。
2. 登录华为账号，选择稳定版（Stable），下载对应系统安装包（Windows 为.exe，macOS 为.dmg）。
3. 校验安装包完整性（官网提供校验码），避免安装包损坏Huawei Developer。

二、Windows 系统安装步骤

1. 管理员身份运行：右键.exe→以管理员身份运行（避免权限不足报错）。

2. 同意协议→下一步。

3. 选择安装路径：默认C:\Program Files，建议自定义到非系统盘（如D:\DevEco_Studio），路径纯英文无空格→下一步Huawei Developer。

4. 组件勾选：默认勾选 DevEco Studio→下一步。

5. 开始安装：等待 5–10 分钟（过程中勿断电 / 关闭窗口）Huawei Developer。

6. 完成安装：勾选 “启动 DevEco Studio”→FinishHuawei Developer。

三、首次启动与环境配置（核心）

1. 初始化设置

• 启动后选择Do not import settings→OK→Agree 条款。
• 登录华为账号（用于后续模拟器、真机调试、签名）。

2. SDK 与工具配置（自动 + 手动）

1. 自动配置：首次启动自动下载 HarmonyOS SDK、Node.js、模拟器（约 5GB，需稳定 WiFi）Huawei Developer。
   • 若卡在 30%/89%：点击设置→切换为华为国内 SDK 仓库→重启 IDE 重试。
2. 手动确认 / 安装：
   • 打开 File→Settings→Appearance & Behavior→System Settings→OpenHarmony SDK。

勾选所需 SDK 版本（如 HarmonyOS 5.0）→Apply→等待安装完成→OK。

3. 模拟器安装（可选，用于无真机调试）

1. 打开 Tools→Device Manager→Emulator→Create Device。
2. 选择设备类型（如 Phone）→选择系统镜像（推荐 HarmonyOS 5.0）→Next。
3. 设置设备名称、内存（≥4GB）→Finish→等待模拟器创建完成（首次启动约 5 分钟）

四、常见问题解决

1. 安装失败 / 卡顿：
   • 权限不足：管理员身份运行安装程序。
   • 路径错误：重装并选择纯英文无空格路径。
   • 网络问题：切换稳定 WiFi，关闭 VPN / 代理，重试 SDK 下载。
2. 启动闪退：
   • 内存不足：关闭后台程序，确保可用内存≥8GBHuawei Developer。
   • 显卡驱动：更新显卡驱动至最新版本Huawei Developer。
3. 模拟器启动失败：
   • 开启虚拟化：BIOS 中开启 CPU 虚拟化（Intel VT-x/AMD-V）。
   • 重新创建：删除现有模拟器，重新选择镜像创建。

五、macOS 安装简要步骤

1. 双击.dmg→将 DevEco Studio 拖拽至Applications文件夹。
2. 首次启动：右键→打开（绕过 macOS 未知开发者限制）。
3. 后续 SDK 配置、模拟器安装同 Windows 步骤。

六、验证安装成功

1. 新建项目：File→New→New Project→选择 Empty Ability→Next→命名项目（纯英文）→Finish。
2. 运行项目：点击右上角运行按钮→选择模拟器 / 真机→等待编译完成→应用成功启动即安装完成。