React v16 与 Webpack v4 的多特性模板项目

题注：欢迎加入阿里南京前端团队，欢迎关注阿里南京技术专刊了解更多讯息。

React & Webpack Boilerplate V4

React & Webpack Boilerplate V4 是笔者前端经常使用模板集锦项目 fe-boilerplate 的一部分，尽量地使用无异议的工具，提供直观且简洁明了的方式；相较于 create-react-app，具备更好的可配置性与适应性，适合于中长期项目。支持最新的 Webpack 4 & React 16.3 版本，若是须要引入 TypeScript 支持，能够借鉴 react/webpack-ts 这个模板。

为了保证项目的纯粹性，将本来 React Router，Redux，MobX 等常见的技术框架的使用迁移到了 fe-boilerplate 的其余模板项目中。也能够查阅 Webpack CheatSheet，或者 React CheatSheet、现代 Web 开发基础与工程实践 了解更多 Web 开发实践的知识。

配置与使用

下载或者克隆 fe-boilerplate，而且进入 react/webpack 子目录：

# 安装依赖
$ cnpm install

# 仅启动 Web 开发服务器
$ npm run dev

# 启动 Web 开发服务器与 Mock 服务器
$ npm start

# 启动 Storybook 服务，在进行组件开发时使用
$ npm run storybook

# 编译为可发布的包体
$ npm run build

# 使用 *.umd.* 配置文件，编译为库
$ npm run build:lib

# 执行 ESLint
$ npm run lint

# 执行包体分析
$ npm run analyze
复制代码

若是咱们是进行的多页面应用开发，那么能够在 webpack.config.base.js 文件中添加更多的 Entry 与 HtmlWebpackPlugin 配置。

技术栈

• 样式

  • 支持使用 CSS Modules/SCSS/Less 等 CSS 模块化解决方案，对于潜在的类名过长致使的冗余包体等问题能够参考 babel-plugin-jsx-nested-classname。
  • 示例代码使用了 styled-components 做为 CSS-in-JS 库。
  • 使用 PostCSS 做为 CSS 代码的后置 Polyfill 以及语法转换支持，详见 postcss.config.js 中的配置。

• 约束

  • 使用 Prettier 做为代码格式化工具。
  • 强烈建议使用 ESLint 进行代码风格控制，能够使用 vscode-eslint 插件以得到更好的开发体验；ESLint 规则推荐使用 eslint-config-airbnb。
  • 能够使用 vscode-import-formatter 等格式化工具处理代码的细节风格，譬如引用顺序等问题。

• 测试

  • 使用 Jest 做为 Test Runner 以及单元测试框架。
  • 使用 Enzyme 做为 React 组件的测试框架。

• 计算

  • 使用 workerize-loader 提供便捷的 Web Worker 计算支撑，能够参考 DOM CheatSheet 获取更多内容。

开发态特性

• 热加载
  • 使用内建的 Webpack DevServer 做为开发服务器。
  • 使用 React Hot Loader V4 提供 React 组件热加载的能力。
• 构建优化
  • 使用 DllPlugin 做为开发环境下公共代码提取工具以优化编译速度生产环境。
  • 能够考虑使用 HappyPack, parallel-webpack 等工具提高 Webpack 的并行处理能力。

发布态特性

• 代码分割，Webpack 4 移除了 CommonChunksPlugin，替换以 optimization 与 splitChunks 配置项，详细配置参考 webpack.config.prod.js。
• PWA 特性，使用 offline-plugin 添加便捷的 PWA 支持。
• 服务端渲染，详见 ssr/server。
• 代码优化，使用 Prepack & prepack-webpack-plugin 进行代码优化。