webpack和webpack-dev-server安装配置(遇到各种问题的解决方法)

时间:2021-10-20 12:36:28

跟着Webpack傻瓜式指南(一)这个教程在安装webpack和webpack-dev-server的时候遇到很多问题,查了很多终于一一找到解决办法。



主要参考了这三篇博文:

  moudule.js:338 throw err; Error: Cannot find module 'webpack/lib/node/NodeTemplatePlugin'

  创建Webpack简单项目遇见的那些事儿

  webpack-dev-server 使用方法,看完还不会的来找我~



看到网上很多人也遇到同样这些问题,特写这篇博文,简要总结安装过程并穿插问题解决办法,希望能给大家带来一些帮助。

安装配置步骤:

1. 装好node和npm

2. 全局安装webpack

npm install -g webpack

3. 建立项目,进入项目根目录

  • a. 新建一个package.json的文件在项目根目录下

    npm init
  • b. 添加webpack.config.js配置文件
  • c. 添加app文件夹,内含2个js文件

    sub.js
//我们这里使用CommonJS的风格
function generateText() {
  var element = document.createElement('h2');
  element.innerHTML = "Hello h2 world";
  return element;
}
module.exports = generateText;

index.js

var sub = require('./sub');
var app = document.createElement('div');
app.innerHTML = '<h1>Hello World</h1>';
app.appendChild(sub());
document.body.appendChild(app);

4. 配置Webpack

  • a. 安装html-webpack-plugin,快速生成HTML

    npm install html-webpack-plugin --save-dev

    可在项目根目录下安装(不加-g,在项目根目录出现node_modules文件夹,内含html-web-pack-plugin及其依赖包),也可全局安装(加-g 必须sudo)

  • b. 写webpack.config.js配置文件中的内容

var path = require('path');
var HtmlwebpackPlugin = require('html-webpack-plugin');
//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);
var APP_PATH = path.resolve(ROOT_PATH, 'app');
var BUILD_PATH = path.resolve(ROOT_PATH, 'build'); module.exports = {
//项目的文件夹 可以直接用文件夹名称 默认会找index.js 也可以确定是哪个文件名字
entry: APP_PATH,
//输出的文件名 合并以后的js会命名为bundle.js
output: {
path: BUILD_PATH,
filename: 'bundle.js'//将app文件夹中的两个js文件合并成build目录下的bundle.js文件
},
//添加我们的插件 会自动生成一个html文件
plugins: [
new HtmlwebpackPlugin({
title: 'Hello World app'
})//在build目录下自动生成index.html,指定其title
],
};

5. 在项目根目录运行webpack

webpack

  • a. Error: Cannot find module 'webpack/../../.....'
    • 解决1:在本项目中安装webpack:

      npm install webpack
    • 解决2:修改环境变量
      • touch ~/.bash_profile
      • vim ~/.bash_profile
      • 修改打开的.bash_profile文件:
export NODE_PATH="/usr/local/lib/node_modules"
    - 使修改生效 

source ~/.bash_profile

  • b. 若命令为webpack --watch,动态监听文件的改变并实时打包,输出新bundle.js文件;但不能做到hot replace,即每次webpack编译之后,还需手动刷新浏览器

6. 配置webpack-dev-server:

  • a. webpack-dev-server简介:

    • 是一个小型node.js express服务器
    • 新建一个开发服务器,可以serve我们pack以后的代码,并且当代码更新的时候自动刷新浏览器
    • 启动webpack-dev-server后,你在目标文件夹中是看不到编译后的文件的,实时编译后的文件都保存到了内存当中。
    • 两种自动刷新方式:
      • iframe mode

        在网页中嵌入了一个 iframe ,将我们自己的应用注入到这个 iframe 当中去,因此每次你修改的文件后,都是这个 iframe 进行了 reload

        命令行:webpack-dev-server,无需--inline

        浏览器访问:http://localhost:8080/webpack-dev-server/index.html
      • inline mode

        命令行:webpack-dev-server --inline

        浏览器访问:http://localhost:8080
  • b. 安装webpack-dev-server

    npm install webpack-dev-server --save-dev

    可在项目根目录下安装(不加-g,在项目根目录出现node_modules文件夹,内含webpack-dev-server及其依赖包),也可全局安装(加-g 必须sudo)

  • c. 在webpack.config.js中添加配置

var webpack=require('webpack');
module.exports = {
……
devServer: {
historyApiFallback: true,
inline: true,//注意:不写hot: true,否则浏览器无法自动更新;也不要写colors:true,progress:true等,webpack2.x已不支持这些
},
plugins:[
……
new webpack.HotModuleReplacementPlugin()
]
……
};
  • d. 在package.json里配置运行的命令(npm支持自定义一些命令)
"scripts":
{
  "start": "webpack-dev-server --inline"//注意:不写--hot,否则浏览器无法自动更新
},
  • e. 运行server
    • npm start
      • Error: .........(此处省略一堆错误)
      • 解决:在本项目中安装webpack:(不加-g,在项目根目录出现node_modules文件夹,内含webpack及其依赖包)

        npm install webpack
    • 浏览器打开http://localhost:8080/

      成功运行,且修改app中的js代码,浏览器会自动刷新!成功!