webpack全家桶+react全家桶项目实战（集成蚂蚁金服ant design）【1】-- 项目准备

原文链接

项目开始前，我们先聊一聊关于项目的一些说明。该项目起始于2017年初，当时公司主要技术栈为gulp+angular，鉴于react的火热的生态，在公司决定研发bss管理系统时选用react开发，目的也是为react native打下基础，以解决后期公司大前端技术栈的逐步成熟。（当时没有选择vue开发的主要原因是weex生态还不够特别成熟），既然决定换新，项目的构建也跟着一起换，从gulp转向火热的webpack，持续大半年的更新迭代，我们将构建模块逐步从项目中抽离出来，把构建模块作为npm包单独管理，完成和项目代码解耦，于是就有了后面我们要说的wci-build构建模块包和wci-cli项目脚手架。

我们要做什么

技术栈

项目采用前后端分离的形式，后端选用Maven+SpringClould全家桶开发，前端选用webpack+react全家桶开发，前后端全部采用包管理工具完全解决项目依赖管理的难题，版本管理采用git，前后端通过json交互，swgger管理接口文档，接口全部遵循restful规范。由于本文面向社区开放，故本文中不涉及公司业务层的代码，本文全部代码均为最新编写，我们以一个旅游管理系统的三个模块为大家演示项目（登陆登出、用户模块、景点模块）。为了快速开展，本文涉及的后端代码直接采用Java的SSM框架搭建，源码也将为大家奉上。朋友们也可以使用mock模拟接口数据。后期我们在演示nodejs+espress时将接口代码全部转为node形式。

准备

因本文不是讲解基础，故大家在敲代码前，还需要具备一定的前端基础，部分如下

1. html、css、javascript基础知识
2. es6基础知识
3. react基础知识
4. 了解什么是webpack、babel、redux、react-router、nodejs、npm
5. 熟悉蚂蚁金服ant design
6. 熟悉less基本使用

解决什么问题

本项目集成了最新的react16、react-router4、redux，同时可以选择性集成antd|antd mobile，在解决繁琐的架构配置工作外，还解决了以下问题

通用问题

1. 支持开发效率更高的ES6编写代码。
2. 拆分开发、测试、生产环境，完成从开发到上线的所有工作。
3. 开发环境包含热替换，本地IP、端口可配置，接口可配置，微服务模块可配置
4. 测试环境包含代码压缩、合并、css抽离、公共组件抽离、代码添加hash、测试版本后缀
5. 生产环境包含代码压缩、合并、css抽离、公共组件抽离、代码添加hash、生产版本后缀（和测试代码完全一样，只缺少测试版本号）
6. 支持自定义添加webpack loader

其他问题

1. 目前大型项目后端多采用微服务架构，API接口在开发、测试、生产环境下来回切换，需要频繁修改代码。解决方案：通过配置文件的方式统一配置项目模块接口
2. 项目模块在分拆开发的过程中css命名冲突，导致代码维护性较差。解决方案：构建工具预加载css时自动化添加hash，使css代码模块化
3. 不同开发人员，不同的代码习惯造成项目代码难以维护。解决方案：在代码编写、构建、版本管理三个方向加入代码规范校验（airbnb规范）
4. 在同时开发多个系统的时候，构建业务模块在不同的项目都存在，当需要修改配置或者优化构建方案的时候，需要修改多个项目的配置。解决方案：抽离构建模块，采用npm形式依赖。

还有什么问题要解决

虽然经过大半年迭代，但我们还需要在实际项目开发中支持更多的个性化需求

1. cdn自动化
2. 更加完善的持续集成
3. 单元测试，包括代码，交互测试
4. mock数据，实现前后端真正0接触
5. ...

希望

大家在开发过程中遇到任何问题，希望可以给我们留言，我们会不断优化项目。未来，我们还会加入mobx、rxjs、immutablejs、GraphQL等，也希望在和大家的探讨中，持续进步。

项目准备

本项目基础环境必须依赖nodejs和npm,未安装的朋友可以去官网自行安装，安装教程这里不详细说明，安装完成后使用如下命令，查看是否安装成功。

node -v
npm -v

初始化项目

本项目我们使用wci-cli脚手架初始化项目

• 全局安装wci-cli

npm install -g wci-cli

• 创建项目
  wci-cli 脚手架可以创建三种项目，分别是1.纯净的react项目 2.包含antd的react项目 3.包含antd-mobile的react项目，命令如下

wci new myapp

执行命令后，命令行会提示是否需要安装antd以及选择antd类型，即可完成项目初始化，如下

image

项目目录

myapp
├── app // 项目业务代码
│   ├── assets // 静态文件目录（图片、字体等）
│   ├── script // js代码目录
│   │   ├── actions // redux action目录
│   │   ├── componets // react 无状态组件目录
│   │   ├── containers // react 业务代码
│   │   ├── reducers // redux reducer目录
│   │   ├── util // 工具包目录
│   │   │   ├── theme.js // antd自定义样式文件
│   │   ├── Home.js // 首页
│   │   ├── home.less // 首页样式
│   ├── styles // 全局样式目录
│   ├── index.js // 项目入口文件
│   ├── index.tpl.html // 项目html模版
├── node_modules // 依赖包目录
├── .babelrc // babel配置文件
├── .eslintrc // eslint代码校验配置文件
├── .gitignore
├── package.json
├── README.md
├── wci.json // wci项目配置文件（主要配置一些开发、测试、生产环境的信息）
└── webpack.js // webpack自定义配置文件

执行如下命令，运行开发环境

cd myapp
npm run start

image

image

如上图，我们的项目已经跑起来了...

• 测试、发布
  因我们需要保证测试代码和生产代码必须保持一致，所有在实际项目中，我们可以运行如下命令构建代码

npm run test // 测试环境打包
npm run dist // 生产环境打包

测试代码

image

生产代码

image

到这里，我们已经完成项目前期开发的所有准备工作，接下来，我们一起开始撸代码吧

项目结束后，我会为大家奉上两篇彩蛋，分别是 1. 一步步搭建webpack前端构建工具并抽成npm单独模块 2. 一步步构建自己的npm开发包并且以一个真实例子演示（开发一个命令行生成文件夹结构的小工具）

未完待续 更新于2018-02-25