DevEco Studio 开发环境搭建与首个 HarmonyOS 工程创建指南

发布时间:2026/8/3 16:12:27
DevEco Studio 开发环境搭建与首个 HarmonyOS 工程创建指南 引言在进行 HarmonyOS 应用开发之前首先需要完成开发环境的搭建。DevEco Studio 是专为 HarmonyOS 应用及元服务打造的一站式集成开发环境集成了代码编辑、编译构建、UI 实时预览、代码调试、性能调优等核心能力。本节课将从零开始介绍 DevEco Studio 的安装、配置及第一个 HarmonyOS 工程的创建流程。核心内容DevEco Studio 运行环境要求在安装 DevEco Studio 之前需要确保电脑满足对应的运行环境配置要求以保证 IDE 正常稳定运行。Windows 环境要求配置项要求操作系统Windows 10 64位、Windows 11 64位内存16GB 及以上硬盘100GB 及以上分辨率1280 × 800 像素及以上macOS 环境要求配置项要求操作系统macOSX8611/12/13/14/15、macOSARM12/13/14/15内存8GB 及以上硬盘100GB 及以上分辨率1280 × 800 像素及以上本节课以Windows 11环境为例进行演示。DevEco Studio 下载与安装下载进入鸿蒙开发者官网找到 DevEco Studio 下载页面根据自身开发环境选择对应版本下载。当前最新版本为DevEco Studio 6.1.1 Release。以 Windows 环境为例选择 64 位 Windows 安装包点击超链接下载得到.exe安装文件。安装步骤双击下载好的.exe安装包启动安装向导点击下一步。选择安装目录可使用默认路径也可点击浏览自定义路径选好后点击下一步。配置安装选项勾选创建 DevEco Studio 桌面快捷方式。勾选将命令文件夹添加到 Path此项必须勾选方便后续直接使用 HDC 等命令行工具配置完成后需重启电脑生效。选择开始菜单文件夹保持默认即可点击安装开始安装。安装完成后勾选运行 DevEco Studio点击完成关闭安装向导并直接启动 IDE。创建第一个 HarmonyOS 工程DevEco Studio 启动后会进入欢迎页面在此可创建第一个 HarmonyOS 工程。创建步骤新建工程在欢迎页点击Create Project开始创建新工程。选择模板在Create Project对话框中左侧选择Application应用然后选择Empty Ability模板点击Next进入配置页面。工程配置Project Name工程名由大小写字母、数字和下划线组成必须以字母开头长度 1~200 个字符。示例命名为Hello World。Bundle Name包名软件包唯一标识需保证全局唯一。Save Location存储路径工程本地存储路径路径不能包含中文字符。Compatible SDK兼容 SDK工程兼容的最低 SDK 版本示例选择6.0.2。Module Name模块名默认为entry应用入口模块模块是应用的功能划分单位。Device Type设备类型选择工程支持的设备类型根据应用场景自定义选择。配置完成后点击FinishIDE 自动生成示例代码和相关资源。DevEco Studio 基础配置完成工程创建后DevEco Studio 还提供了多种个性化配置功能可根据个人偏好灵活设置。启用新 UI从 HarmonyOS 6.0.0 Beta1 版本开始IDE 提供了全新 UI 设计简化了工具布局和窗口显示效果。启用步骤依次点击File→Settings→Appearance Behavior→New UI勾选Enable new UI点击Apply应用更改在弹出的提示框中点击Restart重启 IDE。若需要固定显示菜单栏可在设置中勾选Show main menu in a separate toolbar。代理配置个人网络一般情况下不需要设置DevEco Studio 开发依赖网络一般个人或家庭网络无需配置若使用企业受限网络则需要配置代理。IDE 提供三类代理配置代理类型用途Proxy 代理IDE 全局网络代理负责 SDK 安装、依赖包下载等核心功能。遇到资源下载失败时优先配置此项。NPM 代理专为 Node.js 生态设计解决受限网络下无法从 NPM 官方仓库下载依赖的问题。OHPM 代理针对 OpenHarmony 专属包管理工具 OHPM 配置保证鸿蒙特有依赖能正常下载。Proxy 代理配置步骤依次点击Main Menu→Settings→Appearance Behavior→System Settings→HTTP Proxy。选择Manual proxy configuration勾选HTTP。填写代理服务器信息Host name代理服务器主机名或 IP 地址。Port number代理服务器端口号。No proxy for不需要通过代理访问的 URL/IP 地址多个地址之间用英文逗号分隔。Proxy authentication若代理需要认证填写Login用户名和Password密码否则跳过。点击Check connection输入测试网址检测连通性提示connection successful说明配置成功。点击OK保存配置。主题设置依次点击Main Menu→Settings→Appearance Behavior→Appearance在下拉菜单中选择需要的主题深色/浅色点击OK即可生效。语言设置DevEco Studio 默认使用英文界面。切换为中文的步骤依次点击Main Menu→Settings→Appearance Behavior→System Settings→Language选择中文点击Apply然后点击Restart重启 IDE 即可完成切换。总结本节课重点内容回顾DevEco Studio 安装需根据操作系统类型选择合适的版本下载安装安装时需勾选将命令文件夹添加到 Path以便使用命令行工具。HarmonyOS 工程创建通过Create Project选择Application和Empty Ability模板配置工程名、包名、存储路径、兼容 SDK、模块名和设备类型等参数。基础配置支持启用全新 UI、配置代理Proxy/NPM/OHPM、自定义主题颜色和切换界面语言。