前端项目目录如何组织

背景

最近看了 antd pro 发现其项目的目录结构组织的不错。然后再按照自己的项目经验，对其项目的组织进行修改，现在总结下自己的想法。

正题

我们看下 antd pro 自己生成的目录结构

├── mock                     # 本地模拟数据
  ├── public
  │   └── favicon.ico          # Favicon
  ├── src
  │   ├── assets               # 本地静态资源
  │   ├── common               # 应用公用配置，如导航信息
  │   ├── components           # 业务通用组件
  │   ├── e2e                  # 集成测试用例
  │   ├── layouts              # 通用布局
  │   ├── models               # dva model
  │   ├── routes               # 业务页面入口和常用模板
  │   ├── services             # 后台接口服务
  │   ├── utils                # 工具库
  │   ├── g2.js                # 可视化图形配置
  │   ├── theme.js             # 主题配置
  │   ├── index.ejs            # HTML 入口模板
  │   ├── index.js             # 应用入口
  │   ├── index.less           # 全局样式
  │   └── router.js            # 路由入口
  ├── tests                    # 测试工具
  ├── README.md
  └── package.json

区分通用组件和业务组件

由于 antd pro 本身引用了 antd 的组件库，所以不存在自己写通用组件的步骤。但是有的时候我们自己项目会有自己写通用组件的需要。组件除了有通用组件，还会有业务组件。通用组件是粒度比较细且和业务无关的组件，譬如 Dropdown。而业务组件可能是你这个项目特有的，譬如工具栏，或者某种特殊的弹框。业务组件大多数情况是由（但不仅仅由）通用组件组成。业务组件是粒度比较粗的组件。所以这个时候我一般会把通用组件放在 components 目录下，而新建一个 widgets 目录放业务组件，这样分的比较清楚。不过通用组件和业务组件的划分边界并不是每次都能分的很清楚，有时是会相互转换的，如果实在觉得很难区分，那可以都放在 components 下。

领域对象

src／models 目录放的是 dva model，如果你用 redux，那么这里大致可能对应的是 state 的概念，如果用 mobx 这里隐约对应的是 store 的概念。在我看来这些都不是 model，只能叫做状态（state）相关。我个人理解的 model 应该指的是领域对象也就是领域驱动设计（Domain-Driven Design）中的 domain object，类似于 java bean 的概念。所以我会把放在 models 下面的东西用一个新的目录存放，通常叫 stores，而 models 下面会放领域对象（domain object）。拿 todo list 为例，我会抽象出一个 TodoItem 的领域对象，其定义：

class TodoItem {
  id = -1;
  text = '';
  done = false;

  constructor( rawData ) {
    if ( rawData ) {
      Object.assign( this, rawData );
    }
  }
}

export default TodoItem;

枚举

这个简单，通常项目都不会少了枚举值，这个时候我会单独新建一个 enums 的目录放项目所用到的所有枚举对象。当然，如果很少的话并入 common 目录也未尝不可。 这个时候 src 目录基本上会变成这样：

├── mock                     # 本地模拟数据
  ├── public
  │   └── favicon.ico          # Favicon
  ├── src
  │   ├── assets               # 本地静态资源
  │   ├── common               # 应用公用配置，如导航信息
  │   ├── enums                # 枚举
  │   ├── components           # 通用组件
  │   ├── widgets              # 业务组件
  │   ├── e2e                  # 集成测试用例
  │   ├── layouts              # 通用布局
  │   ├── stores               # 状态相关对象（dva model）
  │   ├── models               # domain object
  │   ├── routes               # 业务页面入口和常用模板
  │   ├── services             # 后台接口服务
  │   ├── utils                # 工具库
  │   ├── g2.js                # 可视化图形配置
  │   ├── theme.js             # 主题配置
  │   ├── index.ejs            # HTML 入口模板
  │   ├── index.js             # 应用入口
  │   ├── index.less           # 全局样式
  │   └── router.js            # 路由入口
  ├── tests                    # 测试工具
  ├── README.md
  └── package.json

精简

看上目录很多，这里我精简下，如果你的项目没有复杂的布局，没有可视化图形配置，没有复杂的路由且用了 react-router4，最后没有可配置主题那么基本的目录结构可以精简为：

├── mock                     # 本地模拟数据
  ├── public
  │   └── favicon.ico          # Favicon
  ├── src
  │   ├── assets               # 本地静态资源
  │   ├── common               # 应用公用配置，如导航信息
  │   ├── enums                # 枚举
  │   ├── components           # 通用组件
  │   ├── widgets              # 业务组件
  │   ├── stores               # 状态相关对象（dva model）
  │   ├── models               # domain object
  │   ├── routes               # 业务页面入口和常用模板
  │   ├── services             # 后台接口服务
  │   ├── utils                # 工具库
  │   └── index.js             # 应用入口
  ├── tests                    # 测试工具
  ├── README.md
  └── package.json

优化

如果项目前期设计做的好，抽象建模工作做的到位，其实你会发现，项目目录大致还可以分为两类：UI 相关和 UI 无关的。这个时候我会把 UI 相关的放到一个 app 的目录下，整个项目就会分成 MV（model，view） 的层次：

├── mock                     # 本地模拟数据
  ├── public
  │   └── favicon.ico          # Favicon
  ├── src
  │   ├── app
  │   │    ├── assets               # 本地静态资源
  │   │    ├── components           # 通用组件
  │   │    ├── widgets              # 业务组件
  │   │    ├── stores               # 状态相关对象（dva model）
  │   │    ├── routes               # 业务页面入口和常用模板
  │   │    └── index.js
  │   ├── common               # 应用公用配置，如导航信息
  │   ├── enums                # 枚举
  │   ├── models               # domain object
  │   ├── services             # 后台接口服务
  │   ├── utils                # 工具库
  │   └── index.js             # 应用入口
  ├── tests                    # 测试工具
  ├── README.md
  └── package.json

这么做的用意是当你的项目 UI 框架重构的时候可以只动 app 目录。从 redux 变到 mobx，也可以从 react 变成 angular。当然这层抽象不是必须的，只是我个人偏好，如果要重构通常也会整个项目重构。

总结

以上就是我根据 antd pro 修改的，我认为比较通用的项目目录结构（这里没有提到测试相关）。