妈妈再也不用担心我不会webpack了2

4,942 阅读10分钟

前言

之前写了一篇妈妈再也不用担心我不会webpack了,这次继续对其进行补充。本文依旧是遵循直观易懂的规则进行书写。希望对大家有帮助。如果不太熟悉webpack可以先看看之前的文章妈妈再也不用担心我不会webpack了。下面我们由浅入深来介绍webpack的使用

一些你不知道是什么意思的东西(题外话)

import path = require('path');

  • path.join
  • path.resolve
  • __dirname

path其实是node中的一个模块,下面我们就将一下这几个常见的东西。

path.join

path.join其实是对路径进行拼接。

const path = require('path');

let str1 = path.join('./path/./', './upload', '/file', '123.jpg');
console.log(str1); // path/upload/file/123.jpg

let str2 = path.join('path', 'upload', 'file', '123.jpg');
console.log(str2); // path/upload/file/123.jpg

使用了它之后就得到了一个拼接好的路径

path.resolve

它是绝对路径的操作

let myPath = path.resolve('path1', 'path2', 'a');
console.log(myPath); // E:/workspace/NodeJS/path1/path2/a

它的结果是绝对路径,不懂绝对路径和相对路径的同学去查下相关知识哦。
这部分到这就结束了,下面可能涉及到这几个东西的使用。

__dirname

使用__dirname变量获取当前模块文件所在目录的完整绝对路径
因为下面可能会碰到这几个东西,所以我们稍微简单提了一下。题外话到此结束,我们现在进入正题。

resolve配置

resolve.extensions

我们在编辑器上开发项目代码,但这个傻怂编辑器IDE功能并不是很强,每次import进来的文件都没有后缀名。如果你使用的是脚手架工具,你可能会发现一个有趣的地方,就是当我们引入js、jsx或者vue文件的时候,我们不需要加后缀就可以使用了。但是你写了一些less或者sass引入到文件中,也没有添加后缀,编译直接报错。这个其实就是resolve的问题。

resolve: {
    // Add '.ts' and '.tsx' as resolvable extensions.
    extensions: [".ts", ".tsx", ".js", ".json"]
}

对resolve进行配置能设置模块如何被解析。
这里的extensions就是后缀的使用,我这里默认是ts/tsx/js/json,这些文件在import时,不添加后缀是可以的,只需要在数组中添加你想要省略的后缀名就可以达到同样的效果。比如下面这种

extensions: ['.web.js', '.mjs', '.js', '.json', '.web.jsx', '.jsx', '.less']

现在就算编辑器不给你添加后缀,你也不需要再加上后缀了,是不是省了很多事。

resolve.alias

这里是创建 import 或 require 的别名,来确保模块引入变得更简单

resolve: {
    alias: {
      Utilities: path.resolve(__dirname, 'src/utilities/'),
      Temp: path.resolve(__dirname, 'src/templates/')
    }
}

之前你引入src/template里面的1文件可能是这样

import 1 from '../src/template/1';

现在你可以这样写了

import 1 from 'Temp/1';

这里的路径还是具体看你的文件路径。不要照抄照搬哦。
这两项是我个人觉得使用频率比较多的,其他情况请去官方文档查看下。

全局变量的使用

使用全局变量进行url的替换

现在项目还是在开发阶段,你可能通过下面的接口获取信息

http://www.xxx.com/test/v3 + 具体接口

这个接口是放在测试服务器上的,但项目一旦上线要使用线上服务器

http://www.xxx.com/api/v4 + 具体接口

你于是冒出了一个很傻X的想法,本地开发或者测试时使用上面的接口,等到上线的时候再将它改掉。鬼鬼,咱不能这么秀。我给你提供一个好方法。

使用DefinePlugin插件来创建全局变量来解决这个问题

DefinePlugin允许你创建一个在编译时可以配置的全局常量,我们下面创建一个名为url的全局变量,如果你是将开发和生产环境的webpack配置文件分开,你可以这样写

开发环境
plugins: [
    new webpack.DefinePlugin({
        url: JSON.stringify('http://www.xxx.com/test/v3')
    })
]
生产环境
plugins: [
    new webpack.DefinePlugin({
        url: JSON.stringify('http://www.xxx.com/api/v4')
    })
]

如果你只有一个webpack配置文件,你也可以写成这样

plugins: [
    new webpack.DefinePlugin({
        url: process.env.NODE_ENV === 'production' ?
            JSON.stringify('http://www.xxx.com/api/v4') :
            JSON.stringify('http://www.xxx.com/test/v3')
    })
    // 这里其实涉及到一个问题,就是你在生产环境的时候必须增加命令修改process.
    // env.NODE_ENV = production,否则上面的代码是不生效的
    // 在package.json的scripts对象中可以使用,使用方法见我上一篇webpack的文章
]

由于这个变量必须包含字符串引号,所以你要么使用'"你的变量内容"', 或者使用 JSON.stringify('你的变量内容')这种形式。
现在你在项目中的接口url就可以写成这样了

`${url}/接口信息` // es6的字符串模板应该都懂吧?

你console.log(url)也是可以的哦,现在我们就解决了这个恶心的问题。
但是还有更恶心的问题等着我们,哈哈。真滴烦!!!
如果你的项目是脚手架搭建,往往会有eslint,eslint不进行设置是没办法使用这个全局变量的,找到eslint配置文件,添加如下代码

"globals": {
    "go": true
}

多入口文件打包

为什么要设置多文件入口打包

在很多情况下,我们都是用当下流行的框架进行web开发,比如vue、react。在开发一段时间过后,测试ok,我们准备build项目了,但是打包之后文件是4.5MB,这玩意对pc或者移动来说都不是一个很好的体验。如果我们不去管它,那每次我们改版或其他的一些情况,用户都需要去重新加载4.5mb的文件,哪怕你只是修改了一行代码。

多入口实现第三方库文件的单独打包

使用多入口文件配合插件解决此问题

entry: {
    vendor: ['react', 'react-dom'],
    app: "./src/index.tsx"
}

这里我们设置了两个入口,一个是app,就是我们传统使用的入口文件。而vendor使用的是一个数组,我们把react和react-dom单独提取出来进行打包。这些库我们基本上是不会改动源代码的,如果我们把它们单独打包出来,即便我们修改了项目的代码,react和react-dom的代码都不需要变,这时浏览器都直接读取vendor文件的缓存就可以了,减少了每次加载资源的体积,增强了用户体验。

配合插件CommonsChunkPlugin使用

只是增加入口文件是不管用的,我们需要使用插件把vendor文件从app文件中剥离出来

plugins: [
    new webpack.optimize.CommonsChunkPlugin('vendor')
]

现在我们已经把vendor和app文件分割了。这里只是举了一个简单的栗子,小伙伴可以根据自己的需求自己进行配置。

我们也可以把公共组件进行一个单独的打包,这里不再赘述,感兴趣的小伙伴可以自己试验哦。

html-webpack-plugin

之前的文章其实已经介绍过这个插件了,但这次我们稍微具体的说一下。我们使用脚手架生成的index.html其实你是找不到script标签引入js文件的,可能你也想这样做,自己动手引入真的麻烦。html-webpack-plugin来帮你

plugins: [
    // Generates an `index.html` file with the <script> injected.
    new HtmlWebpackPlugin({
      inject: true, // 这个配置项为true表示自动把打包出来的文件通过自动生成script标签添加到html中
      template: index.html, // 模板文件,其实如果没有特殊要求,可以考虑就是用原本的html文件,不再单独创建模板。
      minify: { // 压缩的配置,感兴趣的同学意义自己查下意思
        removeComments: true,
        collapseWhitespace: true,
        removeRedundantAttributes: true,
        useShortDoctype: true,
        removeEmptyAttributes: true,
        removeStyleLinkTypeAttributes: true,
        keepClosingSlash: true,
        minifyJS: true,
        minifyCSS: true,
        minifyURLs: true,
      },
    })
]

你的模板html文件是这样

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8" />
    <title>Hello React!</title>
</head>
<body>
<div id="example"></div>

<!-- Main -->
</body>
</html>

通过使用上面的html-webpack-plugin配置它就变成了这样

<!DOCTYPE html><html><head><meta charset="UTF-8"/><title>Hello React!</title></head><body><div id="example"></div><script type="text/javascript" src="vendor.19786c9df38012fdca96.js"></script><script type="text/javascript" src="app.19786c9df38012fdca96.js"></script></body></html>

这样其实就是和你用脚手架搭建的一毛一样了。

讲一些项目中会出现的问题--devServer的使用

我们在使用webpack时,常常会用到webpack-dev-server。它给我们提供了一个server,使我们的项目能跑server上。

historyApiFallback

现在项目在本地正常运行,你看了下地址栏

localhost:8080/#

leader说#是什么鬼?必须去掉,你见过谁的网址带#?
这个#其实是hash路由进行路由跳转的依托。它是可以去掉的。react4是使用BroswerRouter替换HashRouter即可,vue的话同学去查一下即可。去掉#之后我们使用的就是h5的history模式进行路由跳转了。

你以为这样就行了么?

但是老板又有新要求了,我们的页面不是放在根目录下。网址是这样www.xxx.com/xxx,这个时候你要想页面放在服务器上能正常使用就需要在index.html添加base标签。
你信心满满的进行试验,发现,我擦,报错了,连页面都找不到了。


这个原因是因为现在在这个路径下我们是找不到资源文件,会报404的问题,这个时候我们必须要设置

devServer: {
    historyApiFallback: true
  }

这个东西就是告诉webpack-dev-server,再找不到文件的时候默认指向index.html,底层的东西我并没有去深入查询,感兴趣的同学可以去查下。

有些情况下,我们可能会起不止一个服务,这个时候端口往往就会冲突,添加port属性,修改下端口即可解决冲突问题。

devServer: {
    historyApiFallback: true,
    port: 1234
  }

现在,地址就变成了localhost: 1234了。
devServer其实还有很多配置项,感兴趣的同学可以去官网查看

webpack的热替换问题

热替换俗称HMR,即只更新你修改的局部内容,而不刷新整个页面,大大提高开发效率。这个只能在开发时使用哦,下面简单说一下用法。后面直接说react和vue的使用。

 const webpack = require('webpack');

  module.exports = {
    entry: {
      app: './src/index.js'
    },
    devServer: {
     hot: true
    },
    plugins: [
     new webpack.HotModuleReplacementPlugin()
    ]

下面是index.js文件需要的配置(这里觉得比较鸡肋,因为如果你不把js全写在一起,你就要每个文件都要添加这个东东。)

+ if (module.hot) {
+   module.hot.accept('./app.js', function() {
+     console.log('Accepting the updated printMe module!');
+     printMe();
+   })
+ }

module.hot.accept 接受两个参数,第一个参数是修改的文件,第二个是会掉函数。这里只要app.js修改,就会触发回调。

我们大多数情况下是使用react或者vue的,在这种情况下,你使用webpack的HMR是不起作用的。因为它无法保存这些框架的状态。
react和vue给我们提供了解决方案

  • react-hot-loader
  • vue-loader

    同学们可以在npm中搜索这两个东西的用法,都有对应的使用。

此部分webpack配置要去npm找到对应的loader看,很简单。我主要讲我当时很困惑的一点。
我主要讲一下react的,就是在使用路由和redux的情况下,我们的index.js文件应该怎么写。

import React from 'react';
import ReactDOM from 'react-dom';
import './index.css';
import { AppContainer} from 'react-hot-loader'
import registerServiceWorker from './registerServiceWorker';
import { createStore, applyMiddleware, compose } from 'redux';
import thunk from 'redux-thunk';
import reducers from "./reducer";
import "./index.css";
import App from "./App";
import './style/style';

// redux的配置,可以忽略
const store = createStore(reducers, compose(
    applyMiddleware(thunk),
    window.devToolsExtension ? window.devToolsExtension() : ()=>{}
));

registerServiceWorker();

使用AppContainer包裹根组件即可

const render = Component => {
  ReactDOM.render(
      <AppContainer>
          <Component store={store}/> 
      </AppContainer>,
      document.getElementById('root')
  )
};
render(App);
// App作为内容的根组件,redux和router全部放在里面,只要有内容修改,就调用render函数
if (module.hot) {
    module.hot.accept('./App', () => { render(App) })
}

App文件

import React, { Component } from 'react';
import logo from './logo.svg';
import './App.css';
import { BrowserRouter, Switch, Route } from 'react-router-dom';
import { Provider } from 'react-redux';

import Second from "./second";
import Third from "./Third";
import Header from "./header";
import First from "./first";
class App extends Component {
  render() {
    return (
      <Provider store={this.props.store}>
          <BrowserRouter className="App">
              <div>
                  <Header />
                  <Switch>
                      <Route exact path="/" component={First}/>
                      <Route path="/second" component={Second}/>
                      <Route path="/third" component={Third}/>
                  </Switch>
              </div>
          </BrowserRouter>
      </Provider>
    );
  }
}

export default App;

我告你,现在你开发,根本不需要页面刷新,超爽的。修改哪里,哪里变化。谢谢大家