软件开发行业前端部前端工程师组件封装手册.docxVIP

软件开发行业前端部前端工程师组件封装手册

第1章基础规范与架构设计

1.1组件命名与版本控制规则

命名规范遵循BEM命名法，将组件名由component改为component-name，并添加前缀以区分层级，例如`ui-button`应称为`__ui-button__`或`button`，同时必须在文件路径中加上前缀`__`，如`__ui-button__`，确保路径唯一且无冲突。版本号采用语义化版本控制（SemVer）标准，遵循`MAJOR.MINOR.PATCH`格式，其中MAJOR代表大版本升级（如破坏性重构），MINOR代表小版本升级（如新增功能），PATCH代表补丁更新（如修复Bug），版本号需严格对应Git提交哈希值，例如`v1.2.3`。

在`package.json`或`tsconfig.json`配置文件中明确声明依赖项版本，例如`react18.2.0`和`typescript5.3.0`，并规定所有第三方库必须使用`^`前缀锁定精确版本，禁止使用``或无版本号的依赖，以防引入不稳定代码。组件内部应通过`defineComponent`或`defineComponent`函数声明类型定义，明确`props`接口、`emits`事件流及`children`类型，例如