HarmonyOS 鸿蒙Next文件夹命名规范

HarmonyOS 鸿蒙Next文件夹命名规范

HarmonyOS Next中文件夹命名规范，建议全小写还是驼峰？#HarmonyOS最强问答官#

文件夹推荐哪种命名方式？

7 回复

尊敬的开发者您好，建议您参考项目模板内的命名规则，ets内目录使用全小写命名，其他文件夹使用小驼峰命名方式，见下图：
cke_138.png

更多关于HarmonyOS 鸿蒙Next文件夹命名规范的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


谢谢谢谢

一、官方推荐命名方式

  1. ets 目录内：文件夹统一使用 全小写 + 连字符分隔（kebab-case）

    • 示例：pages、common-widget、user-center、utils
    • 不推荐：驼峰（userCenter）、大写开头、下划线、中文

  2. ets 目录外（res、rawfile 等）：全小写

    • 示例：res/base/element/、rawfile/

  3. 文件 / 组件名：使用大驼峰 PascalCase

    • 示例：LoginPage.ets、UserCard.ets

二、推荐工程结构示例

src/main/
├── ets/
│   ├── pages/
│   │   ├── home/
│   │   ├── mine/
│   │   └── login-page/
│   ├── common/
│   │   ├── components/
│   │   └── utils/
│   └── app.ets
└── res/
    ├── base/
    └── rawfile/

谢谢谢谢

怎么方便怎么来，但是最好按照常规互联网软件命名规范来命名，

HarmonyOS 鸿蒙Next文件夹命名建议采用小写字母、数字和下划线组合，禁止空格及除下划线外的特殊字符。资源目录如entry/src/main/resources下的文件夹（如base、en_US）遵循系统预定义名称。工程模块目录如entry、library也使用小写英文字母。

在HarmonyOS Next开发中，文件夹命名推荐使用全小写字母加下划线（snake_case），而不是驼峰。
例如：common_utils、home_page。

这样做的原因有二：

  • 保持与ArkTS/JS模块导入和系统资源解析的兼容性，避免因大小写敏感导致构建或运行时异常。
  • 符合华为官方工程规范，目录名统一小写+下划线，方便团队协作及平台移植。

工程中常见的 pages、components 等单词语法上虽未用下划线，但本质仍属全小写。

回到顶部