初识webpack，搭建webpack4+typescript+scss入门项目

头像
婉婉
    阅读 5 分钟
    2

    为什要使用webPack

    随着大前端的来临，需要前端处理越来越多的事情，不仅局限页面的交互，项目的需求越来越多，更多的逻辑需要在前端完成，为了简化开发的复杂度，前端社区涌现出了很多好的实践方法。

    1. 模块化，一种将复杂系统分解为可管理模块的方式，简单来说就是解耦，简化开发，一个模块就是实现特定功能的文件，想要什么功能，就加载什么模块，完美的实现了代码重用。其中三大剑客便是Angular,React和Vue
    2. JavaScript的拓展的开发语言typescript，能够实现目前版本的JavaScript不能直接使用的特性，并且之后还能转换为浏览器可识别的javascript语言
    3. scss less等CSS预处理器

    这些改进确实大大的提高了我们的开发效率，但是利用它们开发的文件往往需要进行额外的处理才能让浏览器识别,而手动处理又是非常繁琐的，这就为webPack类的工具的出现提供了需求。

    webpack是什么

    webpack是一个模块打包工具，它可以将许多松散的模块按照依赖和规则打包成符合生产环境部署的前端资源。还可以将按需加载的模块进行代码分割，等到实际需要的时候再异步加载。

    webpack支持的模块

    1. ES2015 import语句
    2. CommonJS require()语句
    3. AMD define 和 require语句
    4. css/sass/less文件的 @import 语句
    5. 样式 (url(...)) 或 HTML文件(<img src=...>) 中的图片链接(image url)

    webPack的特点

    1. 丰富的插件，方便进行开发工作
    2. 大量的加载器，包括加载各种静态资源
    3. 代码分割，提供按需加载的能力
    4. 发布工具

    webpack的工作方式

    把项目当做一个整体，通过一个给定的主文件（如：index.js），从这个文件开始找到你的项目的所有依赖文件，使用loaders处理它们，最后打包为一个（或多个）浏览器可识别的JavaScript文件。

    clipboard.png

    开始项目搭建

    1.全局安装webpack

    npm install -g webpack

    2.创建练习文件夹

    mkdir  webpack_pratice

    3.创建package.json文件

    进入到webpack_pratice,创建package.json文件,在终端中使用npm init命令可以自动创建这个package.json文件

     npm init

    输入这个命令后，终端会问你一系列诸如项目名称，项目描述，作者等信息，不过不用担心，如果你不准备在npm中发布你的模块，这些问题的答案都不重要，回车默认即可。
    package.json是一个标准的npm说明文件，里面蕴含了丰富的信息，包括当前项目的依赖模块，自定义的脚本任务等等。

    4.安装项目需要模块

     npm install webpack webpack-cli  --save-dev
 npm install typescript ts-loader --save-dev     
 npm install style-loade  node-sass sass-loader css-loader --save-dev
 npm install extract-text-webpack-plugin@next   --save-dev   
 npm install html-webpack-plugin  --save-dev

    注意：extract-text-webpack-plugin 最新版本为 3.0.2，这个版本还没有适应 webpack 4 的版本，所以安装的时候需要extract-text-webpack-plugin@next

    5.构建项目结构

    • a.创建src目录，增加index.html main.ts common.scss main.scss

    index.html

    <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>webpack测试</title>
</head>
<body>
    <div class="test-block">
        Webpack
    </div>
</body>
</html>

    main.ts

    import './main.scss'

class TestMain {
    name: string;
    age: number;
    constructor ( name: string, age: number ) {
        this.name = name;
        this.age = age;
    };

    testFun() {
        console.log(this.name +　'---' + this.age)
    }
}


let testMain = new TestMain("Miss D", 18);
testMain.testFun();

    common.scss

    html,body{
  margin: 0;
  padding: 0;
  font-size: 25px;
  color: yellow;
}

    main.scss

    @import "common.scss";

.test-block{
  width: 300px;
  height: 300px;
  margin: 0 auto;
  background: green;
}
    • b.创建dist文件夹
    • c.创建TypeScript的配置文件tsconfig.json
    {
  "compilerOptions": {
    "module": "commonjs",
    "target": "es5",
    "sourceMap": true
  },
  "exclude": [
    "node_modules"
  ]
}
    • d.创建webpack的配置文件webpack.config.js
    const path = require('path');
const htmlWebpackPlugin = require('html-webpack-plugin');
const ExtractTextPlugin = require('extract-text-webpack-plugin');

module.exports = {
    entry: './src/main.ts', //模块的入口
    output: { //输出配置
        filename: '[name].bundle.js',
        path: path.resolve(__dirname, 'dist')
    },
    module: { //资源模块的处理器
        rules: [
            {
                test: /\.tsx?$/,
                use: 'ts-loader',
                exclude: path.resolve(__dirname, 'node_modules'),
                include: path.resolve(__dirname, 'src'),
            },
            {
                test: /\.scss$/,
                use: ExtractTextPlugin.extract({
                    fallback: {
                        loader: "style-loader"
                    },
                    use: [
                        {
                            loader: "css-loader",
                        },
                        {
                            loader: "sass-loader"
                        }
                    ]
                })
            }]
    },
    plugins: [ //插件配置
        new ExtractTextPlugin({
            filename: "[name].min.css"
        }),
        new htmlWebpackPlugin({
            template: './src/index.html',
            inject: 'head'
        })
    ]
}
    • e.项目文件夹结构

    clipboard.png

    6.package.js配置build执行脚本

    {
  "name": "webpack-pratice",
  "version": "1.0.0",
  "description": "",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "webpack --config webpack.config.js"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "html-webpack-plugin": "^3.2.0",
    "css-loader": "^2.1.0",
    "extract-text-webpack-plugin": "^4.0.0-beta.0",
    "node-sass": "^4.11.0",
    "sass-loader": "^7.1.0",
    "style-loader": "^0.23.1",
    "ts-loader": "^5.3.3",
    "typescript": "^3.3.3333",
    "webpack": "^4.29.6",
    "webpack-cli": "^3.2.3"
  }
}

    7.执行打包命令

    npm run build

    打包结果

    clipboard.png

    7.运行index.html

    项目的scss样式和typescript文件，解析成浏览器能识别的css和javascript文件，且自动引入到index.html文件中。

    clipboard.png

    官方参考

    1. webpack官网 链接描述
    2. html-webpack-plugin插件 链接描述
    3. extract-text-webpack-plugin插件 链接描述

    踩坑

    如果使用webpack，style-loader出现的错误：

    ERROR in {project}/node_modules/style-loader/lib/addStyles.js
Module not found: Error: Can't resolve './urls' in '{project}\node_modules\style-loader\lib'

    解决方法： 直接修改{project}/node_modules/style-loader/lib/addStyles.js文件：
    把require(“./urls”)改为require(“./urls.js”)

    Microsoftwebpack4typescriptscssnode.js
    婉婉
    294 声望14 粉丝

    爱吃肉肉的小姐姐~

    « 上一篇
    javascript动态合并纵向单元格
    下一篇 »
    javascript事件基础知识

    引用和评论

    推荐阅读
    头像
    node系列：二、模块化

    婉婉赞 2阅读 1.5k

    头像
    如何选择和设计针对不同技术栈的教程指南

    前端视界赞 5阅读 665

    头像
    在JavaScript中从外部解决Promise：实际应用场景

    王大冶赞 4阅读 788评论 2

    头像
    解决lodash由于依赖错误导致无法启动的问题

    LYX6666赞 3阅读 835

    头像
    阿里云ECS服务器部署Node.js项目全过程详解

    kovli赞 1阅读 5.8k

    头像
    前端防篡改水印效果

    白水赞 2阅读 606

    头像
    web每日一题（不断更新中）

    夕水赞 2阅读 1.2k

    0 条评论
    得票最新