第3篇：项目结构详解：entry、Ability、module.json5 到底谁是谁

📚 鸿蒙入门专栏 · 第 3 篇 / 共 10 篇

上一篇：环境搭建：DevEco Studio 安装 + 第一个 Hello World ｜下一篇：ArkTS 语法速通：不会 TS 也能看懂

一、整体结构：先看大骨架

二、三个必须搞懂的概念

[1. UIAbility ------ 应用的「门面」](#1. UIAbility —— 应用的「门面」)

[2. pages ------ 页面](#2. pages —— 页面)

[3. module.json5 ------ 模块的「户口本」](#3. module.json5 —— 模块的「户口本」)

三、改一改，验证你懂了

四、下一篇预告

上篇我们跑通了 Hello World。这篇带你把项目「拆开看」，搞懂每个文件夹是干嘛的。看完这篇，看到任何鸿蒙项目你都不会迷路。

一、整体结构：先看大骨架

一个新建的 Empty Ability 项目长这样（简化版）：

复制代码

MyFirstApp/
├── AppScope/                    # 应用全局配置
│   └── app.json5                # 应用名、图标、版本号
├── entry/                       # 主模块（你的代码 90% 在这里）
│   └── src/main/
│       ├── ets/                 # ArkTS 源码目录
│       │   ├── entryability/
│       │   │   └── EntryAbility.ets   # 应用入口
│       │   └── pages/
│       │       └── Index.ets          # 第一个页面（Hello World 就在这）
│       ├── resources/           # 资源：图片、字符串、颜色
│       └── module.json5         # 模块配置（重要！）
└── build-profile.json5          # 构建配置

二、三个必须搞懂的概念

1. UIAbility ------ 应用的「门面」

EntryAbility.ets 是应用入口，管理应用生命周期（启动、前台、后台）。小白阶段：知道它是入口就行，不用改它。

2. pages ------ 页面

每个 .ets 文件在 pages 目录下就是一个页面。页面写好之后，必须在 module.json5 里注册才能用：

复制代码

// entry/src/main/resources/base/profile/main_pages.json
{
  "src": [
    "pages/Index"        // 每新建一个页面，这里要加一行
  ]
}

3. module.json5 ------ 模块的「户口本」

复制代码

{
  "module": {
    "name": "entry",
    "abilities": [...],
    "requestPermissions": [
      // 以后申请网络、相机权限都写在这里（第 9 篇会用到）
    ]
  }
}

⚠️ 90% 的「权限报错」「页面找不到」问题，根源都在 module.json5 和 main_pages.json 配置。报错先来查这两个文件。

三、改一改，验证你懂了

打开 pages/Index.ets，把 Text('Hello World') 里的字改成「我的第一个鸿蒙 App」，点运行，模拟器上的字变了------恭喜，你已经会改页面了。

四、下一篇预告

项目能跑了，但代码里的 let、function、@Entry 都是啥意思？下一篇用一篇文章把 ArkTS 语法给你讲明白。

如果这篇对你有帮助，点赞 + 收藏 + 关注 三连支持一下，后续教程更新不迷路。

有报错解决不了？评论区贴出报错信息 + 代码，看到都会回。