鸿蒙应用开发需先安装deveco studio:从华为官网下载对应系统安装包,校验sha256哈希值;安装时避开中文/空格路径,windows勾选添加path,macos绕过gatekeeper;首次启动选择不导入设置,自动下载harmonyos sdk、node.js(v18.x)和模拟器,并切换为华为镜像加速;最后通过file→new→project能显示arkts模板即表示环境配置成功。

想开发鸿蒙应用却卡在第一步?没有DevEco Studio,连新建项目都点不进去,所有代码、调试、模拟器功能全成空谈。
下载DevEco Studio安装包
打开浏览器,访问华为官方开发者网站 https://developer.huawei.com/consumer/cn/deveco/studio/,认准“Download”按钮旁的“Windows”或“macOS”标识,点击下载对应系统的安装包。
Windows用户下载后得到一个 【deveco-studio-*.exe】 文件;macOS用户下载的是 【deveco-studio-*.dmg】 镜像文件——别点开.dmg里的.pkg安装器,直接拖拽应用图标到“应用程序”文件夹才是正确路径。
下载完成前务必核对页面底部提供的SHA256校验值,用PowerShell执行 Get-FileHash -Algorithm SHA256 .\deveco-studio-xxx.exe,确保输出哈希与官网一致,否则安装过程可能中途崩溃或启动失败。
安装IDE并设置基础路径
双击.exe文件(Windows)或打开.dmg后拖拽(macOS),进入安装向导。
安装路径必须避开含中文、空格或特殊符号的目录,例如不要选 C:\我的软件\DevEco 或 /Users/张三/Downloads——这类路径会导致后续SDK组件下载失败或Gradle构建报错。
Windows用户请勾选“创建桌面快捷方式”和“Add DevEco Studio to PATH”,后者能让命令行工具识别hvigor等构建命令;macOS用户安装完成后需右键“DevEco Studio.app”→“显示简介”→勾选“仍要打开”,绕过Gatekeeper拦截。
首次启动并自动配置SDK
启动DevEco Studio,出现“Import DevEco Studio Settings”弹窗时,【务必选择Do not import settings】,否则旧版IntelliJ配置可能覆盖鸿蒙专用插件设置,导致ArkTS语法高亮失效。
进入欢迎页后,软件会自动检测本地环境:若未装Node.js或HarmonyOS SDK,将弹出组件选择界面。
勾选以下三项并确认:
- HarmonyOS SDK(核心编译与API支持)
- Node.js(v18.x LTS,用于OHPM包管理与前端构建)
- HarmonyOS Emulator(模拟器运行依赖OpenGL 3.0+,显卡驱动需为最新版)
国内用户在下一步前,点击右下角“Change Repository” → 选择“Huawei Mirror”,可将SDK下载速度从10KB/s提升至2MB/s以上。
验证环境是否就绪
等待下载与解压完成(通常15–25分钟),关闭所有弹窗,点击顶部菜单栏 File → New → Project。
在模板列表中能看到“Application”和“Atomic Service”分类,且右侧预览区实时渲染出ArkTS代码片段——说明SDK已加载成功,Java JDK 11、Node.js、模拟器平台全部就位。
此时点击“Next”,填写项目名与包名,进入工程创建流程,开发环境即宣告可用。











