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

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

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

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

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

🛠️ 配置步骤

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

1. 找到配置文件：在项目根目录下，找到 build-profile.json5 文件并打开。
2. 添加配置项：在 app -> products 对象中，添加 targetSdkVersion 字段。
3. 填写版本号：填入一个有效的SDK版本号，例如 "5.0.0(12)"。
4. 同步项目：修改完成后，点击编辑界面右上角的 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、日志输出区，负责查看编译结果、运行状态和问题定位；顶部菜单与工具栏则负责创建工程、同步依赖、构建打包、运行调试与签名配置。整个开发流程本质上就是：创建工程、认识目录、编写页面、预览界面、同步依赖、选择设备、运行调试、查看日志并持续修改。