在实际开发中,一般会有两套项目方案:

  • 一套是开发期间的项目,包含了测试文件、测试数据、开发工具、测试工具等相关配置,有利于项目的开发和测试,但是这些文件仅用于开发,发布项目时候需要剔除;
  • 另一套是部署期间的项目,剔除了那些客户用不到的测试数据测试工具和文件,比较纯净,减少了项目发布后的体积,有利于安装和部署!

一、开发环境配置

1.安装

  1. npm init -y //项目初始化
  2. npm install webpack@4.27.1 -d
  3. npm install webpack-cli -d 提供一些基本命令(比如webpack命令)
  4. npm install webpack-dev-server -d
  5. npm i html-webpack-plugin@3.2.0 --save-dev
  6. npm install react react-dom -S
  7. npm i babel-core@6.26.3 babel-loader@7.1.5 babel-plugin-transform-runtime --save-dev
  8. npm i babel-preset-env babel-preset-stage-0 --save-dev
  9. npm i babel-preset-react -D
  10. npm install style-loader css-loader -D
  11. npm i less-loader less //less加载器
  12. npm i sass-loader node-sass --save-dev //sass加载器
  13. npm i url-loader file-loader --save-dev

2.webpack.config.js

  1. const path = require('path')
  2. // 导入自动生成HTMl文件的插件
  3. var htmlWebpackPlugin = require('html-webpack-plugin');
  4. module.exports = {
  5. entry: path.join(__dirname, './src/main.js'),
  6. output: {
  7. path: path.join(__dirname, './dist'),
  8. filename: 'bundle.js'
  9. },
  10. plugins: [
  11. // 添加plugins节点配置插件
  12. new htmlWebpackPlugin({
  13. template:path.resolve(__dirname, 'src/index.html'),//模板路径
  14. filename:'index.html'//自动生成的HTML文件的名称
  15. })
  16. ],
  17. module: { // 用来配置第三方loader模块的
  18. rules: [ // 文件的匹配规则
  19. { test: /\.css$/, use: ['style-loader', 'css-loader'] },//处理css文件的规则
  20. { test: /\.less$/, use: ['style-loader', 'css-loader?modules&localIdentName=[path][name]-[local]-[hash:5]', 'less-loader'] },
  21. { test: /\.scss$/, use: ['style-loader', 'css-loader?modules&localIdentName=[path][name]-[local]-[hash:5]', 'sass-loader'] },
  22. { test: /\.(png|jpg|gif|bmp|jpeg)$/, use: 'url-loader?limit=1024&name=[hash:8]-[name].[ext]' },
  23. { test: /\.(ttf|eot|svg|woff|woff2)$/, use: 'url-loader' }, // 处理 字体文件的 loader
  24. //配置 babel 的 loader规则的时候,必须 把 node_modules 目录,通过 exclude 选项排除掉
  25. { test: /\.js|jsx$/, use: 'babel-loader', exclude: /node_modules/ }
  26. ]
  27. },
  28. resolve: {
  29. extensions: ['.js', '.jsx', '.json'], // 表示,这几个文件的后缀名,可以省略不写
  30. alias: {
  31. '@': path.join(__dirname, './src')
  32. }
  33. }
  34. }

3.项目入口文件 main.js

  1. // 1. 导入包
  2. import React from 'react'
  3. import ReactDOM from 'react-dom'
  4. import './css/index.css'
  5. function Hello(props) {
  6. // props.name = 'zs' 不论是 Vue 还是 React,组件中的 props 永远都是只读的;不能被重新赋值;
  7. console.log(props)
  8. return <div><div className="box"></div>这是 Hello 组件 --- {props.name} --- {props.age} --- {props.gender}</div>
  9. }
  10. const dog = {
  11. name: '大黄',
  12. age: 3,
  13. gender: '雄'
  14. }
  15. ReactDOM.render(<div>
  16. {/* 使用{...obj}属性扩散传递数据 */}
  17. <Hello {...dog}></Hello>
  18. </div>, document.getElementById('app'))

4.index.html

  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="UTF-8">
  5. <title>Title</title>
  6. </head>
  7. <body>
  8. <div id="app"></div>
  9. </body>
  10. </html>

5.css/index.css

  1. div{
  2. border: 1px solid red;
  3. }
  4. .box{
  5. width: 300px;
  6. height: 500px;
  7. background: url("../images/1.jpg");
  8. }

6.package.json

  1. "scripts": {
  2. "test": "echo \"Error: no test specified\" && exit 1",
  3. "dev": "webpack-dev-server --open --port 3000 --contentBase src --hot"
  4. }

7.项目根目录 .babelrc

  1. {
  2. "presets": ["env", "stage-0", "react"],
  3. "plugins": ["transform-runtime"]
  4. }

二、生产环境配置文件

2-1 创建生产环境的配置文件

为了满足我们的发布策略,需要新建一个配置文件,命名为webpack.publish.config.js,将webpack.config.js的配置拷贝过去,剔除一些开发配置项即可:

  • devServer节点和热更新插件删掉:

    1. devServer: {
    2. hot: true,
    3. open: true,
    4. port: 4321
    5. }
    6. new webpack.HotModuleReplacementPlugin()
  1. 修改url-loader,将图片放入统一的images文件夹之下(图片路径写在css文件中才会被打包,如果直接写在行内样式里面,不会被打包):

    1. { test: /\.(png|jpg|gif)$/, use: 'url-loader?limit=5000&name=images/[hash:8]-[name].[ext]' }
  2. package.json中的script节点下新增dev命令,通过--config指定webpack启动时要读取的配置文件:

    1. "pub": "webpack --config webpack.publish.config.js"

    2-2 每次重新构建时候删除dist目录

  3. 运行npm i clean-webpack-plugin --save-dev

  4. 在头部引入这个插件:

    1. const {CleanWebpackPlugin } = require('clean-webpack-plugin');
  5. plugins节点下使用这个插件:

    1. new CleanWebpackPlugin ()

    2-3 分离第三方包

  6. 和plugins节点平级添加下面配置:

    1. optimization: {
    2. splitChunks: {
    3. cacheGroups: {
    4. //自己写的代码打包 一个文件
    5. commons: {
    6. name: "commons",
    7. chunks: "initial",
    8. //在分割之前,这个代码块最小应该被引用的次数
    9. minChunks: 1,
    10. //形成一个新代码块最小的体积
    11. minSize: 0
    12. },
    13. //node_modules代码打包 一个文件
    14. vendor: {
    15. chunks: "all",
    16. test: /[\\/]node_modules[\\/]/,
    17. name: "vendor",
    18. minChunks: 1,
    19. //入口最大的并行请求数
    20. maxInitialRequests: 5,
    21. // //形成一个新代码块最小的体积
    22. minSize: 0,
    23. //缓存组打包的先后优先级
    24. priority: 100
    25. }
    26. }
    27. }
    28. },
  7. html-webpack-plugin在生成index.html文件的时候,会自动将抽离的第三方包引入进去!

1553329256785.png

2-4 优化压缩HTML文件

plugins节点下的htmlWebpackPlugin插件中,添加minify子节点:

  1. new htmlWebpackPlugin({
  2. template: path.join(__dirname, './src/index.html'),
  3. filename: 'index.html',
  4. //压缩合并html页面
  5. minify: {
  6. collapseWhitespace: true, // 合并多余的空格
  7. removeComments: true, // 移除注释
  8. removeAttributeQuotes: true // 移除 属性上的双引号
  9. }
  10. }),

其他优化项请参考:html-minifier - github1553150762968.png

2-5 抽取bundle.js中的CSS到指定文件

  1. 运行npm install extract-text-webpack-plugin@next安装抽取CSS文件的插件。
  2. 在配置文件中导入插件:

    1. const ExtractTextPlugin = require("extract-text-webpack-plugin");
  3. 修改CSS和Sass的loader如下:

    1. {
    2. test: /\.css$/, use: ExtractTextPlugin.extract({
    3. fallback: "style-loader",
    4. use: ["css-loader"],
    5. publicPath: '../' // 设置css背景图片的路径
    6. })
    7. },
    8. {
    9. test: /\.scss$/, use: ExtractTextPlugin.extract({
    10. fallback: "style-loader",
    11. use: [
    12. {
    13. loader: 'css-loader',
    14. options: {
    15. modules: {
    16. localIdentName: '[path][name]__[local]--[hash:base64:5]'
    17. }
    18. }
    19. },
    20. {
    21. loader: 'sass-loader',
    22. }
    23. ],
    24. publicPath: '../' // 设置css背景图片的路径
    25. })
    26. },
    27. {
    28. test: /\.less$/, use: ExtractTextPlugin.extract({
    29. fallback: "style-loader",
    30. use: [
    31. {
    32. loader: 'css-loader',
    33. options: {
    34. modules: {
    35. localIdentName: '[path][name]__[local]--[hash:base64:5]'
    36. }
    37. }
    38. },
    39. {
    40. loader: 'less-loader',
    41. }
    42. ],
    43. publicPath: '../' // 设置css背景图片的路径
    44. })
    45. },
  4. 在plugins节点下新增插件:

    1. new ExtractTextPlugin("css/styles.css"), // 抽取CSS文件的插件

    2-6 压缩抽取出来的CSS文件

    参考文档

  5. 运行npm i optimize-css-assets-webpack-plugin --save-dev安装插件到开发依赖。

  6. 在配置文件头部导入插件:

    1. var OptimizeCssAssetsPlugin = require('optimize-css-assets-webpack-plugin');
  7. 在plugins节点下新增插件:

    1. new OptimizeCssAssetsPlugin() // 压缩CSS文件的插件

    2-7 生产环境配置文件总结

    ```javascript

    新建webpack.pub.config.js

const path = require(“path”)

const htmlWebpackPlugin = require(‘html-webpack-plugin’); const {CleanWebpackPlugin } = require(‘clean-webpack-plugin’); const ExtractTextPlugin = require(“extract-text-webpack-plugin”); const OptimizeCssAssetsPlugin = require(‘optimize-css-assets-webpack-plugin’);

module.exports = { //生产环境 mode:”production”, entry: path.join(dirname, ‘./src/main.js’), output: { path: path.join(dirname, ‘./dist’), filename: ‘bundle.js’ }, plugins: [ // 添加plugins节点配置插件 new htmlWebpackPlugin({ template:path.resolve(dirname, ‘src/index.html’),//模板路径 filename:’index.html’,//自动生成的HTML文件的名称 //压缩合并html页面 minify: { collapseWhitespace: true, // 合并多余的空格 removeComments: true, // 移除注释 removeAttributeQuotes: true // 移除属性上的双引号 } }), //每次发布项目的时候自动清除之前的dist目录 new CleanWebpackPlugin (), new ExtractTextPlugin(“css/styles.css”), new OptimizeCssAssetsPlugin() // 压缩CSS文件的插件 ], module: { rules: [ { test: /.(ttf|eot|svg|woff|woff2)$/, use: ‘url-loader’ }, { test: /.js|jsx$/, use: ‘babel-loader’, exclude: /node_modules/ }, { test: /.css$/, use: ExtractTextPlugin.extract({ fallback: “style-loader”, use: [“css-loader”], publicPath: ‘../‘ // 设置css背景图片的路径 }) }, { test: /.scss$/, use: ExtractTextPlugin.extract({ fallback: “style-loader”, use: [ { loader: ‘css-loader’, options: { modules: { localIdentName: ‘[path][name][local]—[hash:base64:5]’ } } }, { loader: ‘sass-loader’, } ], publicPath: ‘../‘ // 设置css背景图片的路径 }) }, { test: /.less$/, use: ExtractTextPlugin.extract({ fallback: “style-loader”, use: [ { loader: ‘css-loader’, options: { modules: { localIdentName: ‘[path][name]__[local]—[hash:base64:5]’ } } }, { loader: ‘less-loader’, } ], publicPath: ‘../‘ // 设置css背景图片的路径 }) },

  1. //name=images/[hash:8]-[name].[ext] 发布项目的时候把图片都放到images文件夹下面去
  2. { test: /\.(png|jpg|gif|bmp|jpeg)$/, use: 'url-loader?limit=1024&name=images/[hash:8]-[name].[ext]' },
  3. ]
  4. },
  5. resolve: {
  6. extensions: ['.js', '.jsx', '.json'], // 表示这几个文件的后缀名,可以省略不写
  7. alias: {
  8. '@': path.join(__dirname, './src')
  9. }
  10. },
  11. optimization: {
  12. //分割代码块
  13. splitChunks: {
  14. cacheGroups: {
  15. //自己写的代码打包 一个文件
  16. commons: {
  17. name: "commons",
  18. chunks: "initial",
  19. //在分割之前,这个代码块最小应该被引用的次数
  20. minChunks: 1,
  21. //形成一个新代码块最小的体积
  22. minSize: 0
  23. },
  24. //node_modules代码打包 一个文件
  25. vendor: {
  26. chunks: "all",
  27. test: /[\\/]node_modules[\\/]/,
  28. name: "vendor",
  29. minChunks: 1,
  30. //入口最大的并行请求数
  31. maxInitialRequests: 5,
  32. // //形成一个新代码块最小的体积
  33. minSize: 0,
  34. //缓存组打包的先后优先级
  35. priority: 100
  36. }
  37. }
  38. }
  39. },

}

package.json中新增

“scripts”: { “test”: “echo \”Error: no test specified\” && exit 1”, “dev”: “webpack-dev-server —open —port 3000 —contentBase src —hot”, “pub”: “webpack —config webpack.publish.config.js” } ```