脚手架vue-cli及webpack原理

举报
炑焽 发表于 2024/06/10 15:02:55 2024/06/10
【摘要】 Vue CLI能迅速创建和管理Vue.js项目，提升开发效率。而Webpack则负责资源打包，通过配置文件管理依赖、插件等，优化代码并分割资源，提高项目性能。Vue CLI与Webpack的完美结合，让开发者更专注于业务逻辑，轻松构建高效、稳定的Vue.js应用。

前言

Vue CLI是Vue.js项目的官方脚手架，基于Node.js与Webpack构建。安装Vue CLI前需确保Node.js已安装，随后通过npm全局安装。Vue CLI能迅速创建和管理Vue.js项目，提升开发效率。而Webpack则负责资源打包，通过配置文件管理依赖、插件等，优化代码并分割资源，提高项目性能。Vue CLI与Webpack的完美结合，让开发者更专注于业务逻辑，轻松构建高效、稳定的Vue.js应用。

一、Vue CLI脚手架

1、Vue单文件组件

Vue 单文件组件（又名*.vue文件，Single File Components缩写SFC）是 Vue.js 框架中的一种组件编写方式，它允许我们将一个组件的模板template、逻辑script和样式style封装在单个文件中。这种方式使得组件的代码更加清晰、易于管理和维护。

2、使用Vue CLI脚手架

Vue单文件组件使用的组件模版，逻辑和样式编写方式在浏览器中是不被认识的。所以我们需要使用Vue CLI提供的一套预定义的配置和插件系统，使得 Vue 组件能够被识别和正确构建。其中Vue CLI已经算是一个功能完备的 Vue.js 项目脚手架，它提供了一套标准化的项目结构和工具链，用于快速构建 Vue.js 项目。它的主要目标是帮助开发者更高效地创建、开发和维护 Vue.js 应用程序。

  • 需要首先在本地安装node.js

  • 安装vue cli脚手架

输入cmd打开命令行工具，输入命令

npm install -g @vue/cli@5.0.6

  • 桌面创建vue项目

vue create vue-study

  • Vue CLI 选项

选择默认vue3项目

Default([Vue 3] babel, eslint)

6cb05ba85991fda5c4038ad1aa0f4f2.png

  • 创建package.json

打开项目文件夹，输入cmd命令或者将项目放入vscod中，打开终端，先创建package.json文件

npm init -y

  • 运行项目

npm run serve

二、解析Vue CLI脚手架原理和webpack使用

1、使用webpack

Webpack 是一个模块打包工具，它可以将多个模块（如 JavaScript、CSS、图片等）打包成一个或多个 bundle，供浏览器使用。在 Vue CLI 或其他现代前端脚手架中，Webpack 通常被用作构建工具，负责处理项目中的资源，并优化输出。

  • 创建空文件夹，然后安装package.json
npm init -y
  • 安装webpack
npm install --save-dev-webpack
npm install --save-dev-webpack-cli
或者执行
npm i -D webpack webpack-cli
  • 创建webpack.config.js

配置文件webpack.config.js,通过安装的webpack-cli来调用，这个文件是Webpack的核心配置文件，它告诉Webpack如何处理项目中的模块、插件以及其他配置选项。

module.exports ={
    // entry打包的入口
    entry: {
        main: './src/main.js'
    },
    //output输出文件,__dirname是找当前文件根目录
    output:{
        path: __dirname + '/dist' // 输出的路径path
    },
    // 开发环境
    mode: 'development'
}
  • 在package.json中写入脚本命令"build": "webpack"调用配置文件
"scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "webpack"
  },
  • 创建文件夹src(开发所在区域)

并在其里面创建index.js和main.js文件。src 文件夹通常是用于存放项目的源代码。

  • index.js(项目的入口点)
let str='hello world'
export default str;
  • main.js(主模块)
import str from "./index.js";
console.log(str)
  • 执行npm run build命令生成打包dist文件
npm run build

image.png

  • 预览src输出的内容

在dist文件夹下新建index.html,输入!+回车写入基本的HTML文档结构，引入main.js打包模块，然后运行index.html文件，就可以看到控制台输出的内容了

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
    <script src="./main.js"></script>
</head>
<body>
</body>
</html>

image.png

2、使用Webpack的HtmlWebpackPlugin插件

  • 安装HtmlWebpackPlugin插件

HtmlWebpackPlugin插件主要作用是根据Webpack构建配置，自动生成一个或多个HTML文件，并将打包生成的JavaScript和CSS文件自动引入到这些HTML文件中。在以下链接中找到HtmlWebpackPlugin，点击想要使用的插件，会提示安装和引入过程

webpack官网HtmlWebpackPlugin

npm install --save-dev html-webpack-plugin
  • 在webpack.config.js文件中引入HtmlWebpackPlugin插件

template的作用主要是指定一个 HTML 文件作为模板，webpack 和 html-webpack-plugin 会使用这个模板来生成最终的 HTML 文件。

const HtmlWebpackPlugin = require("html-webpack-plugin");

module.exports ={
    // entry打包的入口
    entry: {
        main: './src/main.js'
    },
    //output输出文件,__dirname是找当前文件根目录
    output:{
        path: __dirname + '/dist', // 输出的路径path
        clean:true //清理打包的dist中不必要的文件
    },
    // 引入webpack插件
    plugins: [
        new HtmlWebpackPlugin({
            template: './public/index.html',
            title: 'webpack study'
        })
    ],
    // 开发环境
    mode: 'development'
}
  • 在项目中创建public文件夹，在其内部创建index.html

在index.html里写入如下代码，并删除dist文件重新执行npm run build命令,这是创建的dist文件夹下会自动存在index.html并引入了main.js模块

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>
</body>
</html>

3、vue.config.js与webpack.config.js的联系

  • vue.config.js

vue.config.js 是 Vue CLI 项目的配置文件，用于自定义 Vue CLI 项目的 webpack 配置和插件选项。

  • webpack.config.js

webpack.config.js 是 webpack 的主要配置文件，用于定义 webpack 构建的配置对象，包含 loader、插件等详细的配置。

4、webpack启动服务器运行环境

使用webpack-dev-server来搭建一个本地开发服务器。webpack-dev-server的主要功能包括自动监听工程文件的变动，并在文件变动时自动打包并刷新浏览器，从而提供实时重载的开发体验。

  • 安装webpack启动服务器
npm i -D webpack-dev-server
  • 在package.json中写入脚本命令"serve": "webpack-dev-server"调用配置文件
"scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "webpack",
    "serve": "webpack-dev-server"
  },
  • 启动webwebpack启动服务器

在启动webwebpack启动服务器后，修改文件内容是会刷新浏览器的,但这个操作与打包是不会改变成dist文件。在运行webwebpack启动服务器是不需要dist文件的，项目完成后才需要npm run build打包成dist文件夹

npm run serve
  • 打开本地开发服务器的URL地址
http://localhost:8081/

image.png

5、dist与src的映射:

在webpack.config.js中写入devtool: 'inline-source-map'，这是一个source maps映射文件，当你在浏览器的开发者工具中打开这些打包文件时，开发者工具会读取内嵌的source map信息，并显示原始的src目录下的源代码，而不是打包后的代码。

const HtmlWebpackPlugin = require("html-webpack-plugin");

module.exports ={
    // entry打包的入口
    entry: {
        main: './src/main.js'
    },
    //output输出文件,__dirname是找当前文件根目录
    output:{
        path: __dirname + '/dist', // 输出的路径path
        clean:true //清理打包的dist中不必要的文件
    },
    devtool: 'inline-source-map',
    // 引入webpack插件
    plugins: [
        new HtmlWebpackPlugin({
            template: './public/index.html',
            title: 'webpack study'
        })
    ],
    // 开发环境
    mode: 'development'
}

三、webpack处理样式模块和图片模块

Webpack支持使用各种 loader 来预处理不同类型的文件，包括样式模块和图片模块。这些 loader 可以将不同类型的文件转换为 JavaScript 模块，以便 Webpack 能够将其打包到最终的 bundle 中。

loader介绍

1、css-loader使用

Webpack 支持使用 loader 对文件进行预处理。你可以构建包括 JavaScript 在内的任何静态资源。并且可以使用 Node.js 轻松编写自己的 loader。

  • 安装css-loader

css-loader 加载 CSS 文件并解析 import 的 CSS 文件，最终返回 CSS 代码

npm i -D style-loader css-loader
  • 在webpack.config.js中配置模版modulecss处理规则

use: [‘style-loader’, ‘css-loader’]：这是一个数组，指定了处理这些文件时要使用的 loader。Webpack 会按照数组中的逆序（从右到左）来应用这些 loader。其中这个css-loade会读取 CSS 文件内容，并将其转换为 CommonJS 模块。这样，Webpack 就可以处理 CSS 文件，就像处理 JavaScript 文件一样。而这个style-loader会将 CSS 插入到 HTML 文档的style标签中。它依赖于 css-loader，因为它从 css-loader 接收 CSS 内容，并将其注入到页面中。

const HtmlWebpackPlugin = require("html-webpack-plugin");
module.exports ={
    // entry打包的入口
    entry: {
        main: './src/main.js'
    },
    //output输出文件,__dirname是找当前文件根目录
    output:{
        path: __dirname + '/dist', // 输出的路径path
        clean:true //清理打包的dist中不必要的文件
    },
    devtool: 'inline-source-map',
    module: {
        rules: [
            {
                test: /\.css$/i, //匹配所有以 .css 结尾的文件
                use: ['style-loader','css-loader']
            }
        ]
    },
    // 引入webpack插件
    plugins: [
        new HtmlWebpackPlugin({
            template: './public/index.html',
            title: 'webpack study'
        })
    ],
    // 开发环境
    mode: 'development'
}
  • 在src文件夹下新建一个assets文件夹

assets 文件夹通常用于存放项目中不直接通过源代码引用的静态资源文件。在文件夹中新建.css文件，如common.css

body{
    background: pink;
}
  • 在src中的main.js文件中引入common.css文件
import str from "./index.js";
import './assets/common.css'
console.log(str)
  • 执行npm run serve启动webwebpack启动服务器

打开本地开发服务器的URL地址，将会看到css文件内容成功被引入进来，页面背景将会显示为粉色。

npm run serve

2、webpack处理图片模块

  • 安装file-loader 和 url-loader

file-loader和url-loader可以将图片文件转换为模块

npm i -D file-loader url-loader
  • 在webpack.config.js中配置模版module图片处理规则
module: {
        rules: [
            {
                test: /\.css$/i, //匹配所有以 .css 结尾的文件
                use: ['style-loader','css-loader']
            },
            {
                test: /\.(png|jpe?g|gif|svg)$/i,
                use: [
                    {
                        loader: 'url-loader',
                        options: {
                            limit: 8192, // 小于 8kb 的图片转为 base64 格式  
                            name: '[name].[hash:7].[ext]', // 输出的文件名格式  
                            outputPath: 'images', // 输出到 dist/images 目录下  
                        },
                    },
                ],
            }
        ],
    },
  • 在public文件夹下使用img标签
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>
    <img src="" alt="">
</body>
</html>

  • 在assets文件夹下存放一张图片（我存放的是一张logo.jpeg）

  • 在src下的main.js文件中导入的图片资源

import str from "./index.js";
import './assets/common.css'
import logo from './assets/logo.jpeg'
let img=document.querySelector('img')
img.src=logo
console.log(str)
  • 执行npm run serve启动webwebpack启动服务器

打开本地开发服务器的URL地址，将会图片和css文件内容成功被引入。

3、新的webpack方式处理图片模块

随着webpack的升级，特别是从webpack 5.0开始，处理图片资源的方式变得更加简洁和高效。webpack 5.0内置了对图片资源处理的支持，这使得开发者无需再额外安装如file-loader或url-loader等加载器来处理图片。

  • 配置asset/resource模块

将webpack.config.js中配置模版替换成asset/resource模块，通过配置asset/resource模块类型来处理图片资源。webpack会自动将图片文件输出到输出目录，并在代码中生成对应的URL。

module: {
        rules: [
            {
                test: /\.css$/i, //匹配所有以 .css 结尾的文件
                use: ['style-loader','css-loader']
            },
            {
                test: /\.(png|jpe?g|gif|svg)$/i,
                type: 'asset/resource'
            }
        ],
    },
  • 执行npm run serve启动webwebpack启动服务器

打开本地开发服务器的URL地址，将会图片和css文件内容成功被引入。

4、sass-loader（简称Scss）使用

  • 安装Scss插件
npm i -D sass
npm i -D sass-loader
npm i -D vue-style-loader
  • webpack.config.js中配置sass-loader规则

分别在module中配置SCSS或SASS规则，其中SCSS/SASS文件不是处理资源文件，它们会在Webpack的模块处理管道中自动运行。所以不需要再引入插件、

const HtmlWebpackPlugin = require("html-webpack-plugin");
const { VueLoaderPlugin }=require('vue-loader')

module.exports ={
    // entry打包的入口
    entry: {
        main: './src/main.js'
    },
    //output输出文件,__dirname是找当前文件根目录
    output:{
        path: __dirname + '/dist', // 输出的路径path
        clean:true //清理打包的dist中不必要的文件
    },
    devtool: 'inline-source-map',
    module: {
        rules: [
            {
                test: /\.css$/i, //匹配所有以 .css 结尾的文件
                use: ['style-loader','css-loader']
            },
            {
                test: /\.(png|jpe?g|gif|svg)$/i,
                type: 'asset/resource'
            },
            {
                test: /\.vue$/i,
                use: ['vue-loader']
            },
            // 如果需要处理SCSS或SASS，可以添加如下规则  
            {
                test: /\.scss$/,
                use: [
                    'vue-style-loader',
                    'css-loader',
                    'sass-loader'
                ]
            },
        ],
    },
    // 引入webpack插件
    plugins: [
        new HtmlWebpackPlugin({
            template: './public/index.html',
            title: 'webpack study'
        }),
        new VueLoaderPlugin()
    ],
    // 开发环境
    mode: 'development'
}

5、在Home.vue中使用scss语法

  • 使用scss语法一：嵌套

SCSS允许你使用嵌套来简化CSS代码的书写，这样可以更加清晰地表达元素之间的层次关系。

<template>
    <div class="wrapper">
      <div class="box">box</div>
    </div>
</template>
<script>
export default {
    name:'Home',
    data(){
       return {}
    }
}
</script>
<style scoped lang="scss">
.wrapper{
    background: orange;
    .box{
        background: pink;
    }
}
</style>
  • 使用scss语法二：纯CSS的嵌套等效写法
<template>
    <div class="wrapper">
      <div class="wrapper__box1">hello world</div>
      <div class="wrapper__box2">world hello</div>
      <div class="wrapper__box2 wrapper__box2-active">welcome vue</div>
    </div>
</template>
<script>
export default {
    name:'Home',
    data(){
       return {}
    }
}
</script>
<style scoped lang="scss">
.wrapper{
    background: orange;
    &__box1{
        background: green;
    }
    &__box2{
        background: red;
        &-active{
            background: aqua;
        }
    }
}
</style>
  • 使用scss语法三：变量

在SCSS中，你可以使用变量来存储常用的CSS属性值，并在后续的代码中调用这些变量。变量名以美元符号$开头，后面跟变量名，变量名可以包含字母、数字、下划线、横线（连接符），并且变量名与值之间用冒号:分隔。变量必须先定义后使用。

<template>
    <div class="wrapper">
      <div class="wrapper__box">hello world</div>
    </div>
</template>
export default {
    name:'Home',
    data(){
       return {}
    }
}
</script>
<style scoped lang="scss">
$primary-color: #007bff;
.wrapper{
    background: orange;
    &__box{
        background: $primary-color;
    }
}
</style>
  • 使用scss语法四：混合

混合允许你定义一组CSS属性，并在后续的代码中调用这个混合

<template>
    <div class="wrapper">
      <div class="wrapper__box">hello world</div>
    </div>
</template>
<script>
export default {
    name:'Home',
    data(){
       return {}
    }
}
</script>
<style scoped lang="scss">
@mixin error-style {
  background: #007bff;
}
.wrapper{
    background: orange;
    &__box{
        @include error-style;
    }
}
</style>

四、webpack处理单文件组件及loader转换

1、Vue CLI创建的项目

  • 安装Vue.js框架
npm install --save-dev vue
  • 安装Vue 3单文件组件(SFC)的编译器

安装Vue 3单文件组件(SFC)的编译器，将.vue文件编译成JavaScript和CSS代码的功能。

npm install --save-dev @vue/compiler-sfc
  • 安装vue-loader

处理Vue单文件组件,将多种静态资源（如JavaScript、CSS、图片等）转换为浏览器可以使用的格式。

npm install --save-dev vue-loader
  • 在webpack.config.js配置中引入vue-loader并进行预处理
const HtmlWebpackPlugin = require("html-webpack-plugin");
const { VueLoaderPlugin }=require('vue-loader')

module.exports ={
    // entry打包的入口
    entry: {
        main: './src/main.js'
    },
    //output输出文件,__dirname是找当前文件根目录
    output:{
        path: __dirname + '/dist', // 输出的路径path
        clean:true //清理打包的dist中不必要的文件
    },
    devtool: 'inline-source-map',
    module: {
        rules: [
            {
                test: /\.css$/i, //匹配所有以 .css 结尾的文件
                use: ['style-loader','css-loader']
            },
            {
                test: /\.(png|jpe?g|gif|svg)$/i,
                type: 'asset/resource'
            },
            {
                test: /\.vue$/i,
                use: ['vue-loader']
            }
        ],
    },
    // 引入webpack插件
    plugins: [
        new HtmlWebpackPlugin({
            template: './public/index.html',
            title: 'webpack study'
        }),
        new VueLoaderPlugin()
    ],
    // 开发环境
    mode: 'development'
}
  • 在src文件夹下创建Home.vue
<template>
    <div class="wrapper" @click="handleClick">{{ message }}</div>
</template>
<script>
export default {
    name:'Home',
    data(){
       return {
        message: 'hello world'
       }
    },
    methods:{
        handleClick(){
            this.message='world hello'
        }
    }
}
</script>
<style scoped>
.wrapper{
    background: orange;
}
</style>
  • 修改public/index.html文件

在public/index.html文件中写入一个div标签，并为其指定一个唯一的id，例如app

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>
    <div id="app"></div>
</body>
</html>
  • 修改src/main.js,引入单文件Home.vue
import { createApp } from 'vue'
import Home from './Home.vue'
createApp(Home).mount('#app')
  • 执行npm run serve启动webwebpack启动服务器

打开本地开发服务器的URL地址，将会看到Vue单文件组件成功被引入

五、安装vue和Chrome插件

1、Chrome安装Vue插件vue-devtools

Vue.js devtools是一个Chrome浏览器插件，主要用于调试和检查Vue.js应用。它提供了一个清晰、可视化的组件树和状态树，使开发人员能够更好地了解应用程序的状态和结构。通过这个功能，开发人员可以更好地管理应用程序的状态和数据，并轻松了解整个应用程序的工作流程。

  • 访问Chrome应用商店

Chrome应用商店

直接在Chrome应用商店中搜索“Vue.js devtools”，这是由Vue.js官方发布的调试工具

  • 安装插件

在搜索结果中找到Vue.js devtools，然后点击“添加至Chrome”按钮进行安装。

  • 启用插件

安装完成后，打开您的Vue项目，打开Chrome浏览器的开发者工具（通常按F12键）会显示一个新的Vue标签，这表明vue-devtools已经成功安装并启用了。

  • 使用插件

点击某个组件，还可以看到该组件对应的真实DOM，传入的props、data等详细信息。

image.png

2、安装VSCode里的vue常用插件

  • Vue Language Features (Volar)

是一个专为Vue、Vitepress和petite-vue构建的语言支持扩展的插件，这个插件实现了原生TypeScript语言服务级别的性能。同时还能使开发者能够在VS Code编辑器中更流畅、更高效地编写Vue代码，通过智能代码提示、错误检查等功能，极大地提升了开发体验。

image.png

  • Vue VSCode Snippets

通过预定义一系列的快捷码，帮助开发者在编写Vue代码时，能够更快速、更高效地生成常见的模板代码结构。

image.png

【版权声明】本文为华为云社区用户原创内容，转载时必须标注文章的来源（华为云社区）、文章链接、文章作者等基本信息， 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容，欢迎发送邮件进行举报，并提供相关证据，一经查实，本社区将立刻删除涉嫌侵权内容，举报邮箱： cloudbbs@huaweicloud.com
JavaScript Vue webpack
  • 点赞
  • 收藏
  • 关注作者

评论（0）

0/1000
抱歉，系统识别当前为高风险访问，暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称，即可参与社区互动！

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

确认 取消

加入云驻计划，成为创作者

  • 华为云周边好礼
  • 免费体验产品
  • 特殊身份标识
  • 线下官方门票
  • 内部专家零距离
  • 与10000+优质创作者共同成长
立即加入