Vue项目中的文件/文件夹命名规范

最新推荐文章于 2024-08-23 23:41:58 发布

清澈的爱只为中国

最新推荐文章于 2024-08-23 23:41:58 发布

阅读量7.8k

点赞数 1

文章标签： vue

本文链接：https://blog.csdn.net/weixin_44811606/article/details/123662844

版权

文件或文件夹的命名遵循以下原则：

index.js 或者 index.vue，统一使用小写字母开头的(kebab-case)命名规范
属于组件或类的，统一使用大写字母开头的(PascalCase)命名规范
其他非组件或类的，统一使用小写字母开头的(kebab-case)命名规范

1.为什么

文件夹命名： `camelCase` VS `kebab-case`

展开node_modules中的项目依赖，会发现，几乎所有的项目文件夹命名都是 kebab-case命名的，使用kebab-case命名的文件夹比camelCase命名的文件夹看起来更清晰

组件命名：`kebab-case` VS `PascalCase`

vue的官方的风格指南中关于组件文件名的推荐：

单文件组件文件的大小写

单文件组件的文件名应该要么始终是单词大写开头 (PascalCase)，要么始终是横线连接 (kebab-case)。
单词大写开头对于代码编辑器的自动补全最为友好，因为这使得我们在 JS(X) 和模板中引用组件的方式尽可能的一致。然而，混用文件命名方式有的时候会导致大小写不敏感的文件系统的问题，这也是横线连接命名同样完全可取的原因。

2. 文件夹命名规范

属于components文件夹下的子文件夹，使用大写字母开头的PascalBase风格

全局通用的组件放在 /src/components下
其他业务页面中的组件，放在各自页面下的 ./components文件夹下
每个components文件夹下最多只有一层文件夹，且文件夹名称为组件的名称，文件夹下必须有index.vue或
index.js，其他.vue文件统一大写开头（Pascal case），components下的子文件夹名称统一大写开头（PascalCase）

其他文件夹统一使用kebab-case的风格

全局公共组件：`/src/components`示例

- [components]
  - [Breadcrumb]
    - index.vue
  - [Hamburger]
    - index.vue
  - [SvgIcon]
    - index.vue

业务页面内部封装的组件：以 `/src/views/layout/components`示例

-[src]
  - [views]
    - [layout]
      - [components]
        - [Sidebar]
          - index.vue
          - Item.vue
          - SidebarItem.vue
        - AppMain.vue
        - index.js
        - Navbar.vue`

index.js 中导出组件方式如下：

export { default as AppMain } from './AppMain'
export { default as Navbar } from './Navbar'
export { default as Sidebar } from './Sidebar'

看index.js中最后一行代码，不难发现，为什么components下的子文件夹要使用PascalCase命名：
export { default as Sidebar } from './sidebar' // 使用kebab-case命名的文件夹
export { default as Sidebar } from './Sidebar' // 使用 PascalCase命名的文件夹
对于组件的导出/导入，我们一般都是使用大写字母开头的PascalCase风格，
以区别于.vue组件内部的其他camelCase声明的变量，
[Sidebar]作为**【侧边栏组件】**的一个整体被导出，文件夹的命名也采用PascalCase，
有利于index.js中export时的前后统一，避免很多情况下不注意区分大小写