vue-config.js配置 vue-cli3.0及简单使用配置

最新推荐文章于 2024-07-22 13:50:45 发布

liu__software

最新推荐文章于 2024-07-22 13:50:45 发布

阅读量741

点赞数

分类专栏： vue 文章标签： vue

原文链接：https://www.jianshu.com/p/11616f1d4a92

版权

vue 专栏收录该内容

143 篇文章 12 订阅

订阅专栏

本文配置是根据官网写的。vue-cli配置参考

module.exports={
    //部署应用包时的基本url。
    //baseUrl:"/",//从 Vue CLI 3.3 起已弃用
    publicPath:"/"，
    //默认情况下，Vue CLI 会假设你的应用是被部署在一个域名的根路径上，例如 https://www.my-app.com/。
    //如果应用被部署在一个子路径上，你就需要用这个选项指定这个子路径。例如，如果你的应用被部署在 https://www.my-app.com/my-app/，则设置 publicPath 为 /my-app/。
    //这个值也可以被设置为空字符串 ('') 或是相对路径 ('./')，这样所有的资源都会被链接为相对路径，这样打出来的包可以被部署在任意路径，也可以用在类似 Cordova hybrid 应用的文件系统中。
    //也可以使用三元运算符配置开发和正式环境上不同的路径

    outputDir:"dist",//打包后生成的生产环境构建文件的目录，dist是默认值。默认情况下每次打包都会清空上次打包文件（构建时传入 --no-clean 可关闭该行为）。
    //官方提示:始终使用outputDir，而不要修改 webpack 的 output.path。
    assetsDir:"",//放置生成的静态资源 (js、css、img、fonts) 的 (相对于 outputDir 的) 目录
    indexPath:"index.html",//指定生成的 index.html 的输出路径 (相对于 outputDir)。也可以是一个绝对路径。
    filenameHashing:true,//默认情况下，生成的静态资源在它们的文件名中包含了 hash 以便更好的控制缓存。然而，这也要求 index 的 HTML 是被 Vue CLI 自动生成的。如果你无法使用 Vue CLI 生成的 index HTML，你可以通过将这个选项设为 false 来关闭文件名哈希。
    
    //默认是undefined，配置类型是Object，这也是多页面应用的所需要配置的（具体方式，请先找度娘）
    pages:{
        index:{
          // page 的入口
          entry: 'src/index/main.js',
          // 模板来源
          template: 'public/index.html',
          // 在 dist/index.html 的输出
          filename: 'index.html',
          // 当使用 title 选项时，
          // template 中的 title 标签需要是 <title><%= htmlWebpackPlugin.options.title %></title>
          title: 'Index Page',
          // 在这个页面中包含的块，默认情况下会包含
          // 提取出来的通用 chunk 和 vendor chunk。
          chunks: ['chunk-vendors', 'chunk-common', 'index']
        },
        // 当使用只有入口的字符串格式时，
        // 模板会被推导为 `public/subpage.html`
        // 并且如果找不到的话，就回退到 `public/index.html`。
        // 输出文件名会被推导为 `subpage.html`。
        subpage: 'src/subpage/main.js'    
    },

    lintOnSave:true,//在保存后eslint检查代码。将值设置为'error'是把错误直接输出为编译错误。process.env.NODE_ENV !== 'production'，在生产环境上设为false。

    
    runtimeCompiler:false,//是否使用包含运行时编译器的 Vue 构建版本。设置为 true 后你就可以在 Vue 组件中使用 template 选项了，但是这会让你的应用额外增加 10kb 左右。
    transpileDependencies:[],//默认情况下 babel-loader 会忽略所有 node_modules 中的文件。如果你想要通过 Babel 显式转译一个依赖，可以在这个选项中列出来。
    productionSourceMap:true,//如果你不需要生产环境的 source map，可以将其设置为 false 以加速生产环境构建。
    //在打包完成后文件夹中有.map文件，他的作用是在打包完成后，如果运行时报错，没有.map文件不能找到报错信息的准确位置。
    
    crossorigin:undefined,//设置类型是Sring，设置生成的 HTML 中 <link rel="stylesheet"> 和 <script> 标签的 crossorigin 属性。需要注意的是该选项仅影响由 html-webpack-plugin 在构建时注入的标签 - 直接写在模版 (public/index.html) 中的标签不受影响。
    integrity:false,//在生成的 HTML 中的 <link rel="stylesheet"> 和 <script> 标签上启用 Subresource Integrity (SRI)。如果你构建后的文件是部署在 CDN 上的，启用该选项可以提供额外的安全性。
    //需要注意的是该选项仅影响由 html-webpack-plugin 在构建时注入的标签 - 直接写在模版 (public/index.html) 中的标签不受影响。
    //另外，当启用 SRI 时，preload resource hints 会被禁用，因为 Chrome 的一个 bug 会导致文件被下载两次。
    configureWebpack:Object|Function,//如果这个值是一个对象，则会通过 webpack-merge 合并到最终的配置中。
    //如果这个值是一个函数，则会接收被解析的配置作为参数。该函数及可以修改配置并不返回任何东西，也可以返回一个被克隆或合并过的配置版本。
    
    chainWebpack:Function,//是一个函数，会接收一个基于 webpack-chain 的 ChainableConfig 实例。允许对内部的 webpack 配置进行更细粒度的修改。
    
    //css.loaderOptions:{},//Object,默认是{},向 CSS 相关的 loader 传递选项
    css: {
        modules:false,//默认情况下，只有 *.module.[ext] 结尾的文件才会被视作 CSS Modules 模块。设置为 true 后你就可以去掉文件名中的 .module 并将所有的 *.(css|scss|sass|less|styl(us)?) 文件视为 CSS Modules 模块。
        extract:Boolean,//生产环境下是 true，开发环境下是 false,是否将组件中的 CSS 提取至一个独立的 CSS 文件中 (而不是动态注入到 JavaScript 中的 inline 代码)。
        //同样当构建 Web Components 组件时它总是会被禁用 (样式是 inline 的并注入到了 shadowRoot 中)。
        //当作为一个库构建时，你也可以将其设置为 false 免得用户自己导入 CSS。
        //提取 CSS 在开发环境模式下是默认不开启的，因为它和 CSS 热重载不兼容。然而，你仍然可以将这个值显性地设置为 true 在所有情况下都强制提取。
        sourceMap:false,//Boolean,是否为 CSS 开启 source map。设置为 true 之后可能会影响构建的性能。
        loaderOptions: {
          css: {
            // 这里的选项会传递给 css-loader
          },
          postcss: {
            // 这里的选项会传递给 postcss-loader
          }
        }
     }
     //支持的 loader 有：css-loader,postcss-loader,sass-loader,less-loader,stylus-loader
    
    devServer:{
        clientLogLevel:'silent' | 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'none' | 'warning',//使用内联模式时，DevTools中的控制台将显示消息，例如在重新加载之前，错误之前或启用热模块更换时。默认为info
        historyApiFallback: true,//使用HTML5历史记录API时，index.html可能必须提供该页面以代替任何404回复。devServer.historyApiFallback默认情况下禁用。通过传递启用它
        hot: true,//热模块替换，就是热更新页面
        compress: true,//为所服务的一切启用gzip压缩
        host: 'localhost',//指定要使用的主机。默认情况下这是localhost。
        port: 8080//端口号，
        //所有 webpack-dev-server 的选项都支持。注意：
        //有些值像 host、port 和 https 可能会被命令行参数覆写。
        //有些值像 publicPath 和 historyApiFallback 不应该被修改，因为它们需要和开发服务器的 publicPath 同步以保障正常的工作。
        
        //proxy:"url地址",//前端应用和后台API服务没有运行在一个主机上，设置此项在开发环境下代理到API服务器。
        proxy:{//配置不同的后台API地址
            '/api': {
                target: '<url>',
                ws: true,
                changeOrigin: true,
                pathRewrite: {
                  "^/api": "/"
                }
              },
              '/foo': {
                target: '<other_url>'
              }
        }
    }，

    parallel:require('os').cpus().length > 1,//Boolean,是否为 Babel 或 TypeScript 使用 thread-loader。该选项在系统的 CPU 有多于一个内核时自动启用，仅作用于生产构建。
    
   pwa:{},//向 PWA 插件传递选项。
   
   pluginOptions:{},//一个不进行任何 schema 验证的对象，因此它可以用来传递任何第三方插件选项


}

1.下载安装vue-cli3，这里我使用npm安装

npm install -g @vue/cli

如果已经安装之前版本（1.x或2.x）需要先卸载，再安装新的版本。
安装完成后可以通过vue --version命令查看版本

2.创建一个项目

vue-cli3和之前创建一个项目的命令不同

vue create project-name    // vue-cli3
vue init webpack project-name    //vue-cli2

Vue-cli3 搭建的项目界面想对之前较为简洁

之前的build和config文件夹不见了，那么应该如何配置如webpack等的配那

只需要在项目的根目录下新建 vue.config.js 文件（是根目录，不是src目录）

语法

const IS_PROD = ['production', 'prod'].includes(process.env.NODE_ENV);

console.log("process.env.NODE_ENV:" + process.env.NODE_ENV);
const UglifyJsPlugin = require('uglifyjs-webpack-plugin');
const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin;
const path = require('path')
const CompressionWebpackPlugin = require('compression-webpack-plugin');
const productionGzipExtensions = ['js', 'css']
const resolve = dir => path.resolve(__dirname, dir)

module.exports = {
    publicPath: './', // 默认'/'，部署应用包时的基本 URL
    outputDir: 'dist', // 'dist', 生产环境构建文件的目录
    assetsDir: '',  // 相对于outputDir的静态资源(js、css、img、fonts)目录
    lintOnSave: false,
    runtimeCompiler: true, // 是否使用包含运行时编译器的 Vue 构建版本
    productionSourceMap: false,  // 生产环境的 source map
    // CSS 相关选项
    css: {
        // 将组件内的 CSS 提取到一个单独的 CSS 文件 (只用在生产环境中)
        // 也可以是一个传递给 `extract-text-webpack-plugin` 的选项对象
        extract: true,

        // 是否开启 CSS source map？
        sourceMap: false,

        // 为预处理器的 loader 传递自定义选项。比如传递给
        // sass-loader 时，使用 `{ sass: { ... } }`。
        loaderOptions: {},

        // 为所有的 CSS 及其预处理文件开启 CSS Modules。
        // 这个选项不会影响 `*.vue` 文件。
        modules: false
    },

    // 在生产环境下为 Babel 和 TypeScript 使用 `thread-loader`
    // 在多核机器下会默认开启。
    parallel: require('os').cpus().length > 1,
    pwa: {},

    chainWebpack: config => {
        // 修复HMR
        config.resolve.symlinks(true);
        //修复 Lazy loading routes Error
        config.plugin('html').tap(args => {
            args[0].chunksSortMode = 'none';
            return args;
        });

        // 添加别名
        config.resolve.alias
            .set('@', resolve('src'))
            .set('assets', resolve('src/assets'))
            .set('components', resolve('src/components'))
            .set('layout', resolve('src/layout'))
            .set('base', resolve('src/base'))
            .set('static', resolve('src/static'));

        //压缩图片
        // config.module
        //     .rule("images")
        //     .use("image-webpack-loader")
        //     .loader("image-webpack-loader")
        //     .options({
        //         mozjpeg: {progressive: true, quality: 65},
        //         optipng: {enabled: false},
        //         pngquant: {quality: "65-90", speed: 4},
        //         gifsicle: {interlaced: false},
        //         webp: {quality: 75}
        //     });
    },
    configureWebpack: config => {

        if (IS_PROD) {
            const plugins = []
            plugins.push(
                new UglifyJsPlugin({
                    uglifyOptions: {
                        compress: {
                            warnings: true,
                            drop_console: true,
                            drop_debugger: true,
                            pure_funcs: ['console.log'] //移除console
                        },
                        mangle: false,
                        output: {
                            beautify: true,//压缩注释
                        }
                    },
                    sourceMap: false,
                    parallel: true,
                })
            )
            plugins.push(
                new CompressionWebpackPlugin({
                    filename: '[path].gz[query]',
                    algorithm: 'gzip',
                    test: productionGzipExtensions,
                    threshold: 10240,
                    minRatio: 0.8
                })
            )

            //去掉 console.log
            plugins.push(
                new UglifyJsPlugin({
                    uglifyOptions: {
                        compress: {
                            warnings: true,
                            drop_console: true,
                            drop_debugger: true,
                            pure_funcs: ['console.log']//移除console
                        }
                    },
                    sourceMap: false,
                    parallel: true
                })
            );
            config.plugins = [...config.plugins, ...plugins]
        }

        // 打包分析
        if (process.env.IS_ANALYZ) {
            config.plugin('webpack-report')
                .use(BundleAnalyzerPlugin, [{
                    analyzerMode: 'static',
                }]);
        }

        // //配置 externals
        // //防止将某些 import 的包(package)打包到 bundle 中，而是在运行时(runtime)再去从外部获取这些扩展依赖
        // config.externals = {
        //     'vue': 'Vue',
        //     'element-ui': 'ELEMENT',
        //     'vue-router': 'VueRouter',
        //     'vuex': 'Vuex',
        //     'axios': 'axios'
        // }
    },
    devServer: {
        // overlay: {
        //   warnings: true,
        //   errors: true
        // },
        open: IS_PROD,
        host: '0.0.0.0',
        port: 8080,
        https: false,
        hotOnly: false,
        proxy: {
            '/api': {
                target: process.env.VUE_APP_BASE_API || 'http://127.0.0.1:8080',
                changeOrigin: true
            }
        }
    }
};

注意事项：执行yarn build或npm run build 的之前，请先设置下环境，就是输入下面这个命令行。

set NODE_ENV=production

配置举例

上图内容做了两块内容，经测试没有问题

1.将启动端口设置为 8080

2.设置路径别名

作者：菜鸟搬砖
链接：https://www.jianshu.com/p/11616f1d4a92
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

作者：逸宸a
链接：https://www.jianshu.com/p/b001492fc9b9
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。