《2026鸿蒙NEXT纯血开发与AI辅助》第三章：DevEco Studio 整体功能使用详解以及 - 文章 - 开发者社区

《2026鸿蒙NEXT纯血开发与AI辅助》第三章：DevEco Studio 整体功能使用详解以及各个助手以及核心使用方法-卓伊凡

本章我们要深刻认识鸿蒙deveco编译器，以及每个功能，每个界面对应表达的意思，理解我们整体编译器的运行，可在各大平台查看卓伊凡对应专栏视频会更加清晰，文档是根据视频来详细书写和记录的。

首先我们打开我们安装的编译器就提示这个：

This project has no targetSdkVersion field configured. Configure it to ensure app compatibility.

这个警告是告诉你，你的鸿蒙项目还没有配置 targetSdkVersion 字段。配置这个字段不仅是为了消除烦人的提示，更是为了让你的应用明确适配的目标系统版本，从而保证其稳定性和兼容性。

🛠️ 配置步骤

你只需要在项目的 build-profile.json5 文件中，为 targetSdkVersion 字段指定一个版本号即可。具体操作如下：

找到配置文件：在项目根目录下，找到 build-profile.json5 文件并打开。
添加配置项：在 app -> products 对象中，添加 targetSdkVersion 字段。
填写版本号：填入一个有效的SDK版本号，例如 "5.0.0(12)"。
同步项目：修改完成后，点击编辑界面右上角的 Sync Now 或 Sync Project 按钮，让配置生效。

一个配置示例（具体版本号请根据你的项目需要填写）：

{
  "app": {
    "signingConfigs": [],
    "products": [
      {
        "name": "default",
        "signingConfig": "default",
        "compatibleSdkVersion": "5.0.1(13)",
        "targetSdkVersion": "5.0.1(13)", // 在这里添加配置
        "runtimeOS": "HarmonyOS"
      }
    ]
  }
}

🤔 版本号该怎么选？

这里有三个关键的SDK版本参数，理解它们能帮你做出更好的选择：

版本参数	作用	配置建议
compatibleSdkVersion	最低兼容版本：应用能安装运行的最低API版本。	为了覆盖更多设备，建议设置一个相对较低的稳定版本，例如 `5.0.1(13)`。
targetSdkVersion	目标适配版本：应用主要优化和测试的API版本，系统会以此为基准启用最新的行为特性。	这是本次需要配置的核心项。建议设置为与你的DevEco Studio SDK相同或更高的版本，以体验最新特性。
compileSdkVersion	编译SDK版本：编译时使用的SDK版本。在新版工具中通常不再需要手动配置，会默认使用IDE自带的SDK版本。	保持默认，无需手动填写。

一个实用的配置策略：你可以将 compatibleSdkVersion 设置得低一些（如 API 12 或 13）以扩大用户群，同时将 targetSdkVersion 设置得高一些（如 API 18 或 19）以享受新系统的优化和特性，这样能做到“向下兼容，向上优化”。

💡 特别提醒

版本号格式：配置的版本号必须遵循 "主版本.次版本.修订版本(API版本)" 的字符串格式，例如 "5.0.1(13)"。
三者关系：这三个版本号必须满足 compatibleSdkVersion ≤ targetSdkVersion ≤ compileSdkVersion 的关系，否则会编译报错。
API兼容性处理：如果你在代码中使用了较高版本（如高于 compatibleSdkVersion）的API，需要在代码中做好运行时的版本判断，避免在低版本系统上出错。

简单来说，在 build-profile.json5 里为 targetSdkVersion 补上一个合适的版本号，同步一下项目，这个警告就解决了。

一、DevEco Studio 到底是干什么的

你可以把 DevEco Studio 理解成一个“开发总控台”。你写 ArkTS 代码是在这里，创建页面是在这里，配置应用信息是在这里，预览 UI 是在这里，连真机、打日志、调试断点、生成 HAP/HAR/HSP、做签名打包，也都在这里完成。官方文档里把它的能力明确拆成了环境准备、工程管理、代码编辑、界面预览、编译构建、运行调试等模块，这也正对应了你在界面上看到的几个主要功能区。(华为开发者)

所以你在写教程时，可以先给读者一个结论：

DevEco Studio 不是只负责“写代码”，而是负责从“创建工程”到“把应用跑起来”的全流程。 (华为开发者)

二、首次打开 DevEco Studio，会看到什么

第一次打开或者没有工程时，最先进入的一般是欢迎页。这里最核心的入口通常就是：

Create Project：新建工程
Open：打开已有工程
Get from Version Control：从代码仓库拉项目
有时还会看到最近打开的工程列表，方便你直接继续上次开发。官方创建工程文档也明确说明，首次打开时可以直接点 Create Project，如果已经在 IDE 内，则通过 File > New > Create Project 创建新工程。

这一页你在教程里可以把它描述成：

欢迎页就是项目入口页，决定你是新建、打开，还是继续已有项目。

三、进入工程后，整个界面可以分成 6 大区域

1）顶部菜单栏

最上面那一排通常是标准 IDE 菜单，常见包括：

File：新建、打开、关闭工程，项目同步，设置
Edit：撤销、重做、复制粘贴、查找替换
View：显示或隐藏各类窗口
Navigate：类、文件、符号跳转
Code：格式化、优化导包、代码生成、快速修复
Run：运行、调试、编辑运行配置
Build：构建、重建、打包
Tools：开发辅助工具
Help：帮助、日志、版本信息

虽然不同版本菜单排序可能略有细微差异，但 DevEco 基于 IntelliJ 平台，所以这套顶层菜单逻辑是很稳定的。(华为开发者)

你可以把这一块理解为：

菜单栏是“总命令中心”，所有功能都能从这里找到。

2）顶部工具栏

菜单下面通常还有一排快捷工具栏。这里往往放的是开发中最常点的按钮，比如：

同步工程
运行
调试
选择运行设备
选择运行配置
Build 模式相关入口
搜索入口

在日常开发中，真正高频点的不是菜单，而是这一排按钮。尤其是设备选择 + 运行按钮 + 调试按钮，几乎贯穿整个开发流程。运行和调试配置可以在 Run > Edit Configurations 里细化设置。(华为开发者)

3）左侧 Project 工程区

这是新手最先要看懂的区域。左侧 Project 面板，本质上是“你的工程文件树”。Stage 模型下，官方文档给出的典型结构会包含：

AppScope

- app.json5：应用全局配置
- resources：公共资源

entry（或你自定义的模块名）

- src/main/ets：ArkTS 页面与业务代码
- src/main/resources：模块资源
- module.json5：模块配置

工程级/模块级的 build-profile.json5
hvigorfile.ts
oh-package.json5 等配置文件。(华为开发者)

这里最重要的几个文件，你写教程时一定要讲清：

app.json5 是应用级配置，包含应用的全局信息和设备相关配置；
module.json5 是模块级配置；
build-profile.json5 是构建配置；
src/main/ets 是你平时写 ArkTS 页面和逻辑最核心的地方。(华为开发者)

你可以把左侧 Project 区定义成：

它不是单纯的文件夹，而是整个 HarmonyOS 工程的骨架图。

4）中间编辑区

中间最大的一块，就是代码编辑器。你点开 .ets、.ts、.json5、.cpp、.h 之类文件，内容都会在这里打开。这里承担几件核心事情：

写 ArkTS / TS / C++ / 配置文件
代码高亮
报错提示
自动补全
跳转定义
查找引用
快速修复

官方文档明确提到，编辑器支持实时代码检查与快速修复：当语法不符合规范，或出现语义、语法错误时，会在代码中高亮错误或警告，并支持将鼠标移到错误位置查看说明，再进行 Quick Fix。(华为开发者)

所以中间区域你可以这样解释：

编辑区就是“真正写代码和看代码”的主战场。

5）右侧预览/分析辅助区

在 ArkUI 开发里，这一块非常重要。DevEco Studio 提供了 Previewer 做界面预览，还支持 Inspector 双向预览，也支持 ArkUI Inspector 做真机 UI 分析。官方资料显示，Previewer 可用于 ArkTS/JS 界面预览，但使用前要求电脑 OpenGL 3.2 或更高；同时要注意，预览状态下不会执行完整的 Ability 生命周期，所以它更适合看 UI，而不是替代真机运行。(华为开发者)

另外，官方还提供：

Inspector 双向预览：代码和预览界面联动，方便定位组件。(华为开发者)
ArkUI Inspector：在 DevEco Studio 上查看真机 UI 显示效果，并通过多次操作后的界面状态分析问题。(华为开发者)

这一块你可以这样教读者：

Previewer 是“看界面像不像”，ArkUI Inspector 是“查界面为什么不对”。

6）底部运行输出区

底部面板一般是最容易被新手忽略，但其实最关键的一块。这里通常会承载：

Build：编译构建输出
Run：运行输出
Debug：调试状态
Problems：问题列表
Log / Logcat / HiLog 相关输出
Terminal：命令终端

当项目构建失败时，你真正该看的地方不是猜，而是底部 Build 输出；当应用运行异常时，该看日志；当断点调试时，该看 Debug 面板。华为文档里还专门提到，DevEco Studio 对日志有持续增强，例如结构化展示和过滤能力，并且对于长日志、日志导出等也有专门 FAQ。(华为开发者)

这块可以概括成一句：

底部面板是“结果区”，代码有没有问题，运行有没有报错，几乎都在这里给答案。

四、从“创建工程”到“跑起来”，标准操作链路是什么

如果你是给新人讲 DevEco 的完整使用，最标准的一套流程是这样的。

第一步：创建工程

在欢迎页点击 Create Project，或者在已打开 IDE 中点 File > New > Create Project。然后选择合适模板，比如 ArkTS 应用工程模板。官方“Building Your First HarmonyOS Application (ArkTS)”就是按这个流程开始的。

第二步：理解工程结构

工程创建好以后，先不要急着写代码，先让读者认识：

哪个是 AppScope
哪个是模块，比如 entry
页面代码在哪个目录
资源文件在哪个目录
应用配置和模块配置分别在哪。(华为开发者)

这一步非常关键，因为很多新手不是不会写代码，而是根本不知道文件该放哪、配置该改哪。

第三步：写页面与业务代码

点开 src/main/ets 下的页面文件，在中间编辑区写 ArkTS 界面。写的时候，编辑器会自动高亮、检查和提示错误；如果有问题，可以使用快速修复。(华为开发者)

第四步：实时预览界面

想先看界面，不一定要每次都跑真机。可以使用 Previewer 直接预览 UI，但要记住它更偏向“看布局效果”，不是完整运行环境。OpenGL 版本不足、引用能力不完整、某些生命周期不触发，都会影响预览体验。(华为开发者)

第五步：同步依赖与工程

很多人以为装完依赖要自己到处敲命令，其实 DevEco Studio 本身就会在多个场景自动安装依赖：打开工程时、点击 File > Sync and Refresh Project 时，以及点击 Build > Build Hap(s)/App(s) 或 Build > Rebuild Project 时，都会自动 install 依赖。(华为开发者)

所以教程里要明确告诉读者：

看到依赖没生效，先 Sync；构建前如果工程刚改完配置，也先 Sync。

第六步：选择设备并运行

上方工具栏一般会有设备选择区。你可以选择：

预览器
模拟器
真机设备

然后点 Run 运行应用。要调试就点 Debug。如果涉及 Native 或混合开发，可以在 Run > Edit Configurations > Debugger 里设置调试类型。官方支持的调试类型包括 Dual (ArkTS/JS + Native) 、Native 等。(华为开发者)

第七步：看底部日志和构建输出

项目跑不起来时，先看底部 Build；页面有异常时，看日志；布局不对时，用 Inspector。这个顺序非常重要，因为它决定了你是靠猜，还是靠工程化方式排错。(华为开发者)

五、界面上的每一块，平时最常做什么

可以把 DevEco Studio 的日常使用总结成下面这套“视线流”：

你先看左边，因为左边决定你要打开哪个文件；
你主要盯中间，因为中间是代码和配置主区域；
你偶尔看右边，因为右边负责预览和界面分析；
你最终看下边，因为下边告诉你结果对不对。

这其实就是绝大多数开发者在 IDE 里的真实视线路线。工程结构认清以后，开发的核心节奏就是：

左侧找文件 → 中间改代码 → 右侧看预览 → 底部看结果。

总结

DevEco Studio 是 HarmonyOS 应用开发的总控平台。左侧是工程结构区，负责管理 AppScope、entry 模块、资源和配置文件；中间是代码编辑区，负责 ArkTS、配置文件和其他源码的编写；右侧是 Previewer 与 Inspector，负责 UI 预览和界面分析；底部是 Build、Run、Debug、日志输出区，负责查看编译结果、运行状态和问题定位；顶部菜单与工具栏则负责创建工程、同步依赖、构建打包、运行调试与签名配置。整个开发流程本质上就是：创建工程、认识目录、编写页面、预览界面、同步依赖、选择设备、运行调试、查看日志并持续修改。