vue-cli webpack配置分析 - chenBright - SegmentFault 思否

最新推荐文章于 2024-07-23 15:45:06 发布

前端收割机

最新推荐文章于 2024-07-23 15:45:06 发布

阅读量918

点赞数 12

分类专栏： 2024年前端程序员文章标签： vue.js webpack segmentfault

本文链接：https://blog.csdn.net/m0_60452141/article/details/136851442

版权

2024年前端程序员专栏收录该内容

8 篇文章 0 订阅

订阅专栏

// 使用 connect-history-api-fallback 匹配资源

// 如果不匹配就可以重定向到指定地址

// https://github.com/bripkens/connect-history-api-fallback

app.use(require(‘connect-history-api-fallback’)())

// 将暂存到内存中的 webpack 编译后的文件挂在到 express 服务上

app.use(devMiddleware)

// 将 Hot-reload 挂在到 express 服务上

app.use(hotMiddleware)

// 拼接 static 文件夹的静态资源路径

var staticPath = path.posix.join(config.dev.assetsPublicPath, config.dev.assetsSubDirectory)

// 静态文件服务

app.use(staticPath, express.static(‘./static’))

var uri = ‘http://localhost:’ + port

// 编译成功后打印网址信息

devMiddleware.waitUntilValid(function () {

console.log('> Listening at ’ + uri + ‘\n’)

})

module.exports = app.listen(port, function (err) {

if (err) {

console.log(err)

return

}

// 如果配置了自动打开浏览器，且不是测试环境，则自动打开浏览器并跳到我们的开发地址

if (autoOpenBrowser && process.env.NODE_ENV !== ‘testing’) {

opn(uri)

}

})

webpack.dev.conf.js

dev-server.js中使用了webpack.dev.conf.js文件，该文件是开发环境中webpack的配置入口。

// 工具函数集合

var utils = require(‘./utils’)

var webpack = require(‘webpack’)

// 配置文件

var config = require(‘…/config’)

// webpack 配置合并插件

var merge = require(‘webpack-merge’)

// webpac基本配置

var baseWebpackConfig = require(‘./webpack.base.conf’)

// 自动生成 html 并且注入到 .html 文件中的插件

// https://github.com/ampedandwired/html-webpack-plugin

var HtmlWebpackPlugin = require(‘html-webpack-plugin’)

// webpack错误信息提示插件

// https://github.com/geowarin/friendly-errors-webpack-plugin

var FriendlyErrorsPlugin = require(‘friendly-errors-webpack-plugin’)

// 将 Hol-reload 热重载的客户端代码添加到 webpack.base.conf 的对应 entry 中，一起打包

Object.keys(baseWebpackConfig.entry).forEach(function(name) {

baseWebpackConfig.entry[name] = [‘./build/dev-client’].concat(baseWebpackConfig.entry[name])

})

module.exports = merge(baseWebpackConfig, {

module: {

// styleLoaders

rules: utils.styleLoaders({ sourceMap: config.dev.cssSourceMap })

// 最新的配置为 cheap-module-eval-source-map，虽然 cheap-module-eval-source-map更快，但它的定位不准确

// 所以，换成 eval-source-map

devtool: ‘#eval-source-map’,

plugins: [

// definePlugin 接收字符串插入到代码当中, 所以你需要的话可以写上 JS 的字符串

// 此处，插入适当的环境

// https://webpack.js.org/plugins/define-plugin/

new webpack.DefinePlugin({

‘process.env’: config.dev.env

}),

// HotModule 插件在页面进行变更的时候只会重绘对应的页面模块，不会重绘整个 html 文件

// https://github.com/glenjamin/webpack-hot-middleware#installation–usage

new webpack.HotModuleReplacementPlugin(),

new webpack.NoEmitOnErrorsPlugin(),

// 将 index.html 作为入口，注入 html 代码后生成 index.html文件

// https://github.com/ampedandwired/html-webpack-plugin

new HtmlWebpackPlugin({

filename: ‘index.html’,

inject: true

}),

// webpack错误信息提示插件

new FriendlyErrorsPlugin()

]

})

webpack.base.conf.js

在webpack.dev.conf.js中出现webpack.base.conf.js，这个文件是开发环境和生产环境，甚至测试环境，这些环境的公共webpack配置。可以说，这个文件相当重要。

// node自带的文件路径工具

var path = require(‘path’)

// 工具函数集合

var utils = require(‘./utils’)

// 配置文件

var config = require(‘…/config’)

// 工具函数集合

var vueLoaderConfig = require(‘./vue-loader.conf’)

/**

获得绝对路径
@method resolve
@param {String} dir 相对于本文件的路径
@return {String} 绝对路径

function resolve(dir) {

return path.join(__dirname, ‘…’, dir)

}

module.exports = {

entry: {

app: ‘./src/main.js’

output: {

// 编译输出的静态资源根路径

path: config.build.assetsRoot,

// 编译输出的文件名

filename: ‘[name].js’,

// 正式发布环境下编译输出的上线路径的根路径

publicPath: process.env.NODE_ENV === ‘production’ ?

config.build.assetsPublicPath : config.dev.assetsPublicPath

resolve: {

// 自动补全的扩展名

extensions: [‘.js’, ‘.vue’, ‘.json’],

// 路径别名

alias: {

// 例如 import Vue from ‘vue’，会自动到 'vue/dist/vue.common.js’中寻找

‘vue$’: ‘vue/dist/vue.esm.js’,

‘@’: resolve(‘src’),

}

module: {

rules: [{

// 审查 js 和 vue 文件

// https://github.com/MoOx/eslint-loader

test: /.(js|vue)$/,

loader: ‘eslint-loader’,

// 表示预先处理

enforce: “pre”,

include: [resolve(‘src’), resolve(‘test’)],

options: {

formatter: require(‘eslint-friendly-formatter’)

}

{

// 处理 vue文件

// https://github.com/vuejs/vue-loader

test: /.vue$/,

loader: ‘vue-loader’,

options: vueLoaderConfig

{

// 编译 js

// https://github.com/babel/babel-loader

test: /.js$/,

loader: ‘babel-loader’,

include: [resolve(‘src’), resolve(‘test’)]

{

// 处理图片文件

// https://github.com/webpack-contrib/url-loader

test: /.(png|jpe?g|gif|svg)(?.*)?$/,

loader: ‘url-loader’,

query: {

limit: 10000,

}

{

// 处理字体文件

test: /.(woff2?|eot|ttf|otf)(?.*)?$/,

loader: ‘url-loader’,

query: {

limit: 10000,

}

]

}

config/index.js

该文件在很多文件中都用到，是主要的配置文件，包含静态文件的路径、是否开启sourceMap等。其中，分为两个部分dev（开发环境的配置）和build（生产环境的配置）。

// 详情见文档：https://vuejs-templates.github.io/webpack/env.html

var path = require(‘path’)

module.exports = {

// production 生产环境

build: {

// 构建环境

env: require(‘./prod.env’),

// 构建输出的index.html文件

index: path.resolve(__dirname, ‘…/dist/index.html’),

// 构建输出的静态资源路径

assetsRoot: path.resolve(__dirname, ‘…/dist’),

// 构建输出的二级目录

assetsSubDirectory: ‘static’,

// 构建发布的根目录，可配置为资源服务器域名或 CDN 域名

assetsPublicPath: ‘/’,

// 是否开启 cssSourceMap

productionSourceMap: true,

// Gzip off by default as many popular static hosts such as

// Surge or Netlify already gzip all static assets for you.

// Before setting to true, make sure to:

// npm install --save-dev compression-webpack-plugin

// 默认关闭 gzip，因为很多流行的静态资源主机，例如 Surge、Netlify，已经为所有静态资源开启gzip

productionGzip: false,

// 需要使用 gzip 压缩的文件扩展名

productionGzipExtensions: [‘js’, ‘css’],

// Run the build command with an extra argument to

// View the bundle analyzer report after build finishes:

// npm run build --report

// Set to true or false to always turn it on or off

// 运行“build”命令行时，加上一个参数，可以在构建完成后参看包分析报告

// true为开启，false为关闭

bundleAnalyzerReport: process.env.npm_config_report

// dev 开发环境

dev: {

// 构建环境

env: require(‘./dev.env’),

// 端口号

port: 3333,

// 是否自动打开浏览器

autoOpenBrowser: true,

assetsSubDirectory: ‘static’,

// 编译发布的根目录，可配置为资源服务器域名或 CDN 域名

assetsPublicPath: ‘/’,

// proxyTable 代理的接口（可跨域）

// 使用方法：https://vuejs-templates.github.io/webpack/proxy.html

proxyTable: {},

// CSS Sourcemaps off by default because relative paths are “buggy”

// with this option, according to the CSS-Loader README

// (https://github.com/webpack/css-loader#sourcemaps)

// In our experience, they generally work as expected,

// just be aware of this issue when enabling this option.

// 默认情况下，关闭 CSS Sourcemaps，因为使用相对路径会报错。

// CSS-Loader README：https://github.com/webpack/css-loader#sourcemaps

cssSourceMap: false

}

utils.js

utils.js也是一个被使用频率的文件，这个文件包含了三个工具函数：

生成静态资源的路径
生成 ExtractTextPlugin对象或loader字符串
生成 style-loader的配置

// node自带的文件路径工具

var path = require(‘path’)

// 配置文件

var config = require(‘…/config’)

// 提取css的插件

// https://github.com/webpack-contrib/extract-text-webpack-plugin

var ExtractTextPlugin = require(‘extract-text-webpack-plugin’)

/**

生成静态资源的路径
@method assertsPath
@param {String} _path 相对于静态资源文件夹的文件路径
@return {String} 静态资源完整路径

exports.assetsPath = function (_path) {

var assetsSubDirectory = process.env.NODE_ENV === ‘production’

? config.build.assetsSubDirectory

config.dev.assetsSubDirectory

// path.posix.join与path.join一样，不过总是以 posix 兼容的方式交互

return path.posix.join(assetsSubDirectory, _path)

}

/**

生成处理css的loaders配置
@method cssLoaders
@param {Object} options 生成配置
```
                       option = {
```

                         // 是否开启 sourceMap

                         sourceMap: true,

                         // 是否提取css

```
                         extract: true
```
```
                       }
```
@return {Object} 处理css的loaders配置对象

exports.cssLoaders = function (options) {

options = options || {}

var cssLoader = {

loader: ‘css-loader’,

options: {

minimize: process.env.NODE_ENV === ‘production’,

sourceMap: options.sourceMap

}

/**

生成 ExtractTextPlugin对象或loader字符串
@method generateLoaders
@param {Array} loaders loader名称数组
@return {String|Object} ExtractTextPlugin对象或loader字符串

function generateLoaders (loader, loaderOptions) {

var loaders = [cssLoader]

if (loader) {

loaders.push({

// 例如，sass?indentedSyntax

// 在?号前加上“-loader”

loader: loader + ‘-loader’,

options: Object.assign({}, loaderOptions, {

sourceMap: options.sourceMap

})

}

// extract为true时，提取css

// 生产环境中，默认为true

if (options.extract) {

return ExtractTextPlugin.extract({

use: loaders,

fallback: ‘vue-style-loader’

})

} else {

return [‘vue-style-loader’].concat(loaders)

}

// http://vuejs.github.io/vue-loader/en/configurations/extract-css.html

return {

css: generateLoaders(),

postcss: generateLoaders(),

less: generateLoaders(‘less’),

sass: generateLoaders(‘sass’, { indentedSyntax: true }),

scss: generateLoaders(‘sass’),

stylus: generateLoaders(‘stylus’),

styl: generateLoaders(‘stylus’)

}

/**

生成 style-loader的配置
style-loader文档：https://github.com/webpack/style-loader
@method styleLoaders

小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级前端工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！
因此收集整理了一份《2024年Web前端开发全套学习资料》送给大家，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频

如果你觉得这些内容对你有帮助，可以添加下面V无偿领取！（备注：前端）

最后

开源分享：【大厂前端面试题解析+核心总结学习笔记+真实项目实战+最新讲解视频】

❤️ 谢谢支持，喜欢的话别忘了关注、点赞哦。

-loader文档：https://github.com/webpack/style-loader

@method styleLoaders

小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

[外链图片转存中…(img-e5YEkB9d-1710844280448)]
[外链图片转存中…(img-AIVoY5iK-1710844280449)]
[外链图片转存中…(img-I5lLqn1N-1710844280450)]
[外链图片转存中…(img-1OjYKFFy-1710844280450)]

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频

如果你觉得这些内容对你有帮助，可以添加下面V无偿领取！（备注：前端）
[外链图片转存中…(img-gLTOi7Wx-1710844280451)]

最后

开源分享：【大厂前端面试题解析+核心总结学习笔记+真实项目实战+最新讲解视频】

❤️ 谢谢支持，喜欢的话别忘了关注、点赞哦。

前端收割机

关注

12
点赞
踩
25

收藏

觉得还不错? 一键收藏
0
评论
vue-cli webpack配置分析 - chenBright - SegmentFault 思否

开源分享：【大厂前端面试题解析+核心总结学习笔记+真实项目实战+最新讲解视频】-loader文档：https://github.com/webpack/style-loader小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。深知大多数初中级前端工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！
复制链接

扫一扫

专栏目录