对于初学者来说，ArkTS工程目录的内容分为三个层级：核心必会、用时再查、暂时忽略。

第一层级：核心必会（天天都要用）

这部分是写代码的主战场，必须熟悉。

src > main > ets > pages

• 这是什么：写界面的地方。列如 Index.ets, Second.ets。
• 熟悉程度：超级高。要熟悉 ArkTS 的基本语法（@Entry, @Component, build()），以及如何用 Row、Column、Text、Button 来画界面。

src > main > resources

• 这是什么：放图片、写字符串（文字）、布局文件的地方。
• 熟悉程度：中等。需要知道图片该丢进 media 文件夹，文字提议写在 string.json 里（虽然直接写在代码里也能跑，但规范开发要用资源文件）。

页面跳转逻辑 (Router)

• 这是什么：代码里那个 router.pushUrl 和 router.back。
• 熟悉程度：理解原理即可。知道怎么从A页面跳到B页面，怎么传参。

第二层级：关键配置（偶尔用到，不懂会报错）

这部分不需要背，但一旦报错或者新建页面时，需要知道去哪里改。

main_pages.json (resources > base > profile)

• 重点：这是新手最大的坑。如果手动新建了一个 Test.ets 页面，必须来这里注册，否则跳转时会报错。
• 技巧：如果使用 DevEco Studio 的右键 New > Page 功能，工具会自动填好，不需要手动改。但如果是手动创建文件，就必须记得来这里加一行。

module.json5

• 重点：当应用需要权限（列如联网、用相机）时，需要来这里配置。
• 熟悉程度：知道它管权限和模块信息就行，具体字段用到时查文档。

oh-package.json5

1. 重点：用来管理第三方库的。如果后来要引入别人写好的工具包（列如网络请求库 axios），就要用到它。

第三层级：暂时忽略（工具自动生成/高级用法）

作为初学者，这部分文件即使完全不动，应用也能跑起来。

1. hvigorfile.ts：构建脚本，初学者几乎不用碰。
2. obfuscation-rules.txt：代码混淆规则，发布上架时才需要思考，目前不用管。
3. build-profile.json5：签名和构建配置。IDE（开发工具）的图形化界面一般能自动处理这些，不需要手动改代码。
4. AppScope：全局配置，一般项目创建初期设置一次 App 的名字和图标后，就很少再动了。

学习提议

1. 先动手写 UI：
   重点关注文中的 “构建第一个页面” 和 “构建第二个页面” 部分。反复练习怎么把 Text 放在 Column 里，怎么调整颜色和大小。这是获得成就感最快的方式。
2. 复制粘贴是常态：
   文中关于 onClick 里的那一长串路由跳转代码（let uiContext = …），初学时直接复制粘贴，改成页面路径（pages/Second）即可，不需要深究每一行代码的底层原理。
3. 利用工具：
   文中提到新建页面有两种方式。提议使用 右键 pages 文件夹 -> New -> Page 的方式。这样工具会自动帮你把 main_pages.json 配置好，少踩一个坑。

总结：把精力 90% 放在 .ets 文件的编写上（画界面、写逻辑），剩下的 10% 留给配置文件，遇到报错或者需要加权限的时候再去查文档即可。

#与鸿蒙共赴星光之约#