NPM and Webpack 前端模块化 -- 手册【2021年3月20日 00:06:32 至 2021年3月24日 23:26:20】

前端文章汇总

https://www.jianshu.com/p/82fa0c99e019

一、NPM 包管理器

1、简介,什么是NPM
NPM全称Node Package Manager,是Node.js 的包管理工具,是全球最大的模块生态系统,里面所有的模块都是开源免费的;也是Node.js的包管理工具,相当于前端的Maven 。

#在命令提示符输入 npm -v 可查看当前npm版本
npm-v

二、使用npm管理项目

1、创建npm_pro文件夹后,初始化

#建立一个空文件夹,在命令提示符进入该文件夹  执行命令初始化
npm init
#按照提示输入相关信息,如果是用默认值则直接回车即可。
#name: 项目名称
#version: 项目版本号
#description: 项目描述
#keywords: {Array}关键词,便于用户搜索到我们的项目
#最后会生成package.json文件,这个是包的配置文件,相当于maven的pom.xml
#我们之后也可以根据需要进行修改。

#如果想直接生成 package.json 文件,那么可以使用命令
npm init -y

初始化后的配置文件简说:package.json


image.png

2、修改npm镜像
(1)NPM官方的管理的包都是从http://npmjs.com下载的,但是这个网站在国内速度很慢。
(2)这里推荐使用淘宝 NPM 镜像http://npm.taobao.org/,淘宝 NPM 镜像是一个完整 npmjs.com 镜像,同步频率目前为 10分钟一次,以保证尽量与官方服务同步。
(3)设置镜像地址:

#经过下面的配置,以后所有的 npm install 都会经过淘宝的镜像地址下载
npm config set registry https://registry.npm.taobao.org 
#查看npm配置信息
npm config list

3、npm install命令的使用
(1)基本命令

#使用 npm install 安装依赖包的最新版,
#模块安装的位置:项目目录 \node_modules
#同时package.json 文件中,依赖包会被添加到dependencies节点下,类似maven中的 <dependencies>
#默认参数:--save  简写  -S  将当前依赖保存在dependencies节点下
npm install jquery

(2)下载特定版本的依赖

#如果安装时想指定特定的版本
npm install jquery@2.1.x

(3)下载开发依赖

#devDependencies节点:开发时的依赖包,项目打包到生产环境的时候不包含的依赖        
#使用 -D参数将依赖添加到devDependencies节点
npm install --save-dev eslint
#或简写
npm i -D eslint

(4)根据依赖下载安装包

#npm管理的项目在备份和传输的时候一般不携带node_modules文件夹
#安装会自动在项目目录下添加 package-lock.json文件,这个文件帮助锁定安装包的版本
npm install #根据package.json中的配置下载依赖,初始化项目

4、其他命令

#更新包(更新到最新版本)
npm update 包名
#全局更新
npm update -g 包名
#卸载包
npm uninstall 包名
#全局卸载
npm uninstall -g 包名
#查看 jquery 版本
npm view jquery version

三、模块化

1、模块化产生的背景
(1)随着网站逐渐变成"互联网应用程序",嵌入网页的Javascript代码越来越庞大,越来越复杂。
(2)Javascript模块化编程,已经成为一个迫切的需求。理想情况下,开发者只需要实现核心的业务逻辑,其他都可以加载别人已经写好的模块。

2、模块化规范
(1)CommonJS模块化规范(基于ES6语法之前)
(2)ES6模块化规范(使用ES6语法)

四、模块化实操

1、导出和导入模块:ES6使用 export 和 import 来导出、导入模块。

(1)创建 modularization_pro文件夹,用 npm init - y命令初始化项目

(2)在 文件夹内创建 src/01.js 文件,相当于一个工具类,编写要被调用的方法

export default {
    trushTooth() {
        console.log('阿K在刷牙')
    },
    eatMeal() {
        console.log('阿K在吃饭')
    }
}

(3)在 文件夹内创建 src/02.js 文件,引入并调用 01.js 内的 Api

import testApi from "./01.js"; // 引入
testApi.trushTooth();// 调用
testApi.eatMeal();

(4)运行测试:node 02.js

(5)你会发现报错了:这时的程序无法运行的,因为ES6的模块化无法在Node.js中执行,需要用Babel编辑成ES5后再执行。


image.png
2、使用Babel转码

(1)简介:
ES6的某些高级语法在浏览器环境甚至是Node.js环境中无法执行。
Babel是一个广泛使用的转码器,可以将ES6代码转为ES5代码,从而在现有环境执行执行。
这意味着,你可以现在就用 ES6 编写程序,而不用担心现有环境是否支持。

(2)Babel提供babel-cli工具,用于命令行转码。它的安装命令如下:

#全局安装
npm install -g babel-cli
#查看是否安装成功
babel --version

(3)配置:.babelrc
Babel的配置文件全名是 .babelrc ,存放在项目的根目录下,该文件用来设置转码规则和插件,presets字段设定转码规则

{
    "presets": [
        "es2015"
    ],
    "plugins": []
}

(4)安装转码器:在modularization目录中安装

npm install -D babel-preset-es2015

(5)转码:先在根目录下创建 dist,用于接受转码后的 js

# 整个目录转码
# --out-dir 或 -d 参数指定输出目录
babel src -d dist
image.png

(6)运行 测试:node dist/02.js

image.png

五、Webpack

1、什么是Webpack

(1)Webpack 是一个前端资源加载/打包工具。它将根据模块的依赖关系进行静态分析,然后将这些模块按照指定的规则生成对应的静态资源。
(2)从图中我们可以看出,Webpack 可以将多种静态资源 js、css、less 转换成一个静态文件,减少了页面的请求。


image.png
2、Webpack安装

(1)全局安装:

npm install -g webpack webpack-cli #运行一条即可
或
npm install -g webpack        #你觉得很无聊,所以运行两条
npm install -g webpack-cli

(2)安装后查看版本号:webpack -v

(3)创建 webpack_pro文件夹,运行命令初始化:npm init -y

(4)根目录下 创建 src,src 下创建 01.js
这里使用的是CommonJS模块化方式,这种方式不支持ES6的语法,所以不需要Babel转码

exports.info = function (str) {
    document.write(str)// 浏览器显示
}

(5)src下创建 02.js

exports.add = function (a, b) {
    return a + b
}

(6)src下创建main.js:下面的写法 是 es5,在 babel 转码上是一致的,所以不需要转码

const a = require('./01.js')
const b = require('./02.js')
a.info('Hello world!' + b.add(100, 200))
3、Webpack 之 js 的打包项目

(1)创建配置文件:根目录下创建 webpack.config.js

const path = require("path") //Node.js内置模块
module.exports = {
    entry: './src/main.js', //配置入口文件
    output: {
        path: path.resolve(__dirname, './dist'), //输出路径,__dirname:当前文件所在路径
        filename: 'bundle.js'//输出文件
    }
}

以上配置解释:

1、读取当前项目目录下src文件夹中的main.js(入口文件)内容,分析资源依赖,把相关的js文件打包
2、打包后的文件放入当前目录的dist文件夹下
3、打包后的js文件名为bundle.js

(2)执行编译命令
<1>方案一:学习用

webpack --mode=development
#执行后查看bundle.js 里面包含了上面两个js文件的内容并进行了代码打包

方案二:工作用,也可以配置项目的npm运行命令,修改package.json文件(实际工作项目,都这么干,特别是一些稳定的开源项目),可以理解上面是手动,下面是自动

{
"scripts": {
//...,
"dev": "webpack --mode=development",
"prod": "webpack --mode=production"
 }
}

方案二配置后的使用:运行npm命令执行打包

npm run dev #开发打包
或
npm run prod #生产打包

(3)创建入口:webpack_prg根目录下创建index.html,引用bundle.js

<script src="dist/bundle.js"></script>

vscode 快捷键生成 html标签,!

image.png

(4)测试:浏览器中查看index.html

1、右击启动:


image.png

2、查看:


image.png
4、Webpack 之 css 的打包项目

1、安装插件:

  1. Webpack 本身只能处理 JavaScript 模块,如果要处理其他类型的文件,就需要使用 loader 进行转换。
  2. Loader 可以理解为是模块和资源的转换器。
  3. 首先我们需要安装相关Loader插件,css-loader 是将 css 装载到 javascript;style-loader 是让 javascript 认识css
npm install -D style-loader css-loader 

2、修改webpack.config.js

const path = require("path"); //Node.js内置模块
module.exports = {
    //...,
    output: {
        //其他配置
    },
    module: {
        rules: [
            {
                test: /\.css$/,    //打包规则应用到以css结尾的文件上
                use: ['style-loader', 'css-loader']
            }
        ]
    }
}

3、在src文件夹创建style.css

body {
    background: pink;
}

4、修改main.js:在第一行引入style.css

require('./style.css')

5、测试编译命令:npm run dev

6、打开 index.html 看看(只有右击上面的快捷键)

六、vue-element-admin

1、简介

vue-element-admin是基于element-ui 的一套后台管理系统集成方案。
GitHub地址:https://github.com/PanJiaChen/vue-element-admin
项目在线预览:https://panjiachen.gitee.io/vue-element-admin

2、安装
# 解压压缩包
# 进入目录
cd vue-element-admin-master
# 安装依赖
npm install
# 启动。执行后,浏览器自动弹出并访问http://localhost:9527/
npm run dev

若是安装出现问题


image.png

解决方案:

npm i -g node-sass --sass_binary_site=https://npm.taobao.org/mirrors/node-sass/

七、vue-admin-template

1、简介
  1. vueAdmin-template是基于vue-element-admin的一套后台管理系统基础模板(最少精简版),可作为模板进行二次开发。
  2. GitHub地址:https://github.com/PanJiaChen/vue-admin-template
  3. 建议:你可以在 vue-admin-template 的基础上进行二次开发,把 vue-element-admin当做工具箱,想要什么功能或者组件就去 vue-element-admin 那里复制过来。
2、安装
# 解压压缩包
# 进入目录
cd vue-admin-template-master
# 安装依赖
npm install
# 启动。执行后,浏览器自动弹出并访问http://localhost:9528/
npm run dev

八、前端登录问题

默认情况下,前端项目已经实现了登录功能,后端连接到远程Mock平台的模拟数据接口进行登录,而Mock平台地址无效,导致前端的登录功能无法执行


image.png

九、玩前端开源框架须知

1、目录结构

vue-element-admin-master(拥有完整的功能的插件)


image.png
2、关键文件

vue-admin-template-master(源码相对简单,我们的后台管理系统基于这个版本)
(1)1 package.js

1、npm项目的核心配置文件,包含项目信息,项目依赖,项目启动相关脚本
2、启动项目的命令: npm run dev
3、dev脚本:webpack-dev-server --inline --progress --config build/webpack.dev.conf.js
4、webpack-dev-server:一个小型的基于Node.js的http服务器,可以运行前端项目
--inline:一种启动模式
--progress:显示启动进度
--config build/webpack.dev.conf.js:指定webpack配置文件所在位置


image.png

(2)build/webpack.dev.conf.js

1、webpack配置文件,包含项目在开发环境打包和运行的相关配置
2、webpack.dev.conf.js 中引用了 webpack.base.conf.js
3、webpack.base.conf.js 中定义了项目打包的入口文件


image.png

image.png

4、在HtmlWebpackPlugin配置html模板,生成的js就会自动插入到模板中,如下面的配置。
因此生成的js文件会被自动插入到名为index.html的页面中


image.png

(3)index.html:项目默认的html页面


image.png

image.png

(4)src/main.js
项目js入口文件,项目的所有前端功能都在这个文件中引入和定义,并初始化全局的Vue对象


image.png

(5)config/dev.env.js:定义全局常量值


image.png

image.png

因此,在项目中的任意位置可以直接使用 process.env.BASE_API 常量表示后端接口的主机地址

(6)src/utils/request.js
引入axios模块,定义全局的axios实例,并导出模块


image.png

(7)src/api/login.js:引用request模块,调用远程api


image.png
Q1,遇到的问题一:win10:无法加载文件 C:\Users\LENOVO\AppData\Roaming\npm\babel-node.ps1,因为在此 系统上禁止运行脚本

(1)win+R打开运行,powerShell,管理员终端
(2)在管理员终端内 运行 set-ExecutionPolicy RemoteSigned,再选择 Y 即可

参考文档

https://blog.csdn.net/zhizhengguan/article/details/103291251
https://blog.csdn.net/fankse/article/details/109776520

本文章由javascript技术分享原创和收集

发表评论 (审核通过后显示评论):