Webpack打包vue项目（优化--注释版），开发环境，生产环境

 1.webpack.config.js配置

注意：使用到path.resolve(__dirname,"...")绝对路径的，看自己的路径是否正确

const path = require("path");
// 处理js代码规范
const EslintWebpackPlugin = require("eslint-webpack-plugin");
// 解析html,用当前html作为解析模板,无需在当前html里面引入js，会自动引入
const HtmlWebpackPlugin = require("html-webpack-plugin");
// 原始我们使用的是style-loader，它会加载成内部样式在style标签里，使用MiniCssExtractPlugin是对css做的优化，会提取成单独文件.css，作为外部样式，通过link引入
const MiniCssExtractPlugin = require("mini-css-extract-plugin");
// 对css做兼容处理，有的样式不是每个浏览器都能使用，此时需要在package.json中配置浏览器的兼容
const CssMinimizerWebpackPlugin = require("css-minimizer-webpack-plugin");
// 压缩css
const CssMinimizerPlugin = require("css-minimizer-webpack-plugin");
// 当生产模式会默认开启TerserPlugin，但是我们需要进行其他配置，就要重新写了
const TerserWebpackPlugin = require("terser-webpack-plugin");
// 压缩图片，打包时可能会出错：error:找不到该资源'...\node_modules\jpegtran-bin\vendor\jpegtran.exe'
// 解决方法：①需要将：jpegtran.exe 需要复制到 node_modules\jpegtran-bin\vendor 下面；jpegtran 官网地址：http://jpegclub.org/jpegtran/
// ②  optipng.exe需要复制到 node_modules\optipng-bin\vendor 下面；optipng官网地址：https://optipng.sourceforge.net/ 
const ImageMinimizerPlugin = require("image-minimizer-webpack-plugin");
// 不是为了把新生成的文件复制到目标目录，而是把原始文件的原封不动的复制到目标目录
const CopyPlugin = require("copy-webpack-plugin");
//  vue加载器，如果不是框架，原始的话，就需要单独在入口文件配置了
const { VueLoaderPlugin } = require("vue-loader");
const { DefinePlugin } = require("webpack");
const AutoImport = require("unplugin-auto-import/webpack");
const Components = require("unplugin-vue-components/webpack");
const { ElementPlusResolver } = require("unplugin-vue-components/resolvers");
// 接收参数是生产环境还是开发环境
const isProduction = process.env.NODE_ENV === "production";

// 返回处理样式loader函数，return返回的数组，执行顺序从后往前
const getStyleLoaders = (pre) => {
  return [
    isProduction ? MiniCssExtractPlugin.loader : "vue-style-loader",
    "css-loader",
    {
      // 处理css兼容性问题
      // 配合package.json中browserslist来指定兼容性
      loader: "postcss-loader",
      options: {
        postcssOptions: {
          plugins: ["postcss-preset-env"],
        },
      },
    },
    pre && {
      loader: pre,
      options:
        pre === "sass-loader"
          ? {
            additionalData: `@use "@/styles/element/index.scss" as *;`,
          }
          : {},
    },
  ].filter(Boolean);
};

module.exports = {
  entry: "./src/main.js",
  output: {
    // fullhash（webpack4 是 hash）：每次修改任何一个文件，所有文件名的 hash 至都将改变。所以一旦修改了任何一个文件，整个项目的文件缓存都将失效。
    // chunkhash：根据不同的入口文件(Entry)进行依赖文件解析、构建对应的 chunk，生成对应的哈希值。我们 js 和 css 是同一个引入，会共享一个 hash 值。
    // contenthash：根据文件内容生成 hash 值，只有文件内容变化了，hash 值才会变化。所有文件 hash 值是独享且不同的。
    path: isProduction ? path.resolve(__dirname, "../dist") : undefined,
    filename: isProduction ? "static/js/[name].[contenthash:10].js" : "static/js/[name].js",// 入口文件打包输出资源命名方式
    chunkFilename: isProduction ? "static/js/[name].[contenthash:10].chunk.js" : "static/js/[name].chunk.js",// 动态导入输出资源命名方式，要想实现动态导入，需要使用路由懒加载
    assetModuleFilename: "static/media/[hash:10][ext][query]",// 图片、字体等资源命名方式（注意用hash）
    // 清除上一次dist目录下的文件
    clean: true,
  },
  module: {
    rules: [
      // 处理css
      {
        // 正则匹配：.特殊符号，需要转义，$结尾，以.css结尾的文件
        test: /\.css$/,
        use: getStyleLoaders(),
      },
      {
        test: /\.less$/,
        use: getStyleLoaders("less-loader"),
      },
      {
        test: /\.s[ac]ss$/,
        use: getStyleLoaders("sass-loader"),
      },
      {
        test: /\.styl$/,
        use: getStyleLoaders("stylus-loader"),
      },
      // 处理图片
      {
        test: /\.(jpe?g|png|gif|webp|svg)$/,
        type: "asset",//相当于`url-loader`, 将文件转化成 Webpack 能识别的资源，同时小于某个大小的资源会处理成 data URI 形式
        parser: {
          dataUrlCondition: {
            maxSize: 10 * 1024,// 小于10kb的图片会被base64处理
          },
          //   修改输出资源和路径
        //  generator: {
            // 将图片文件输出到 static/imgs 目录中
            // 将图片文件命名 [hash:8][ext][query]
            // [hash:8]: hash值取8位
            // [ext]: 使用之前的文件扩展名
            // [query]: 添加之前的query参数
          //  filename: "static/images/[hash:8][ext][query]",
          //},
        },
      },
      // 处理其他资源
      {
        test: /\.(woff2?|ttf)$/,
        type: "asset/resource", // 相当于`file-loader`, 将文件转化成 Webpack 能识别的资源，其他不做处理
      },
      // 处理js
      {
        test: /\.js$/,
        include: path.resolve(__dirname, "../src"), //只对目标目录下的js文件做处理，同时还有个属性exclude(排除),两个只能二选一
        loader: "babel-loader",
        options: {
          cacheDirectory: true,// 开启babel编译缓存，记录上一次缓存，可以加快打包速度
          cacheCompression: false,//不压缩缓存文件，因为压缩缓存文件占用时间
        },
      },
      {
        test: /\.vue$/,
        loader: "vue-loader",
        options: {
          // 开启缓存
          cacheDirectory: path.resolve(__dirname, "../node_modules/.cache/vue-loader"),
        },
      },
    ],
  },
  // 处理html
  plugins: [
    new EslintWebpackPlugin({
      // 指定j检查文件根目录
      context: path.resolve(__dirname, "../src"),
      // 排除node_modules文件夹
      exclude: "node_modules",
      // 提升打包速度：开启缓存，初次没有缓存，没有用，第二次的时候会记录上一次的缓存，再次打包时，速度就会比较快，只更新自己修改的内容
      cache: true,
      // 缓存所放位置
      cacheLocation: path.resolve(__dirname, "../node_modules/.cache/.eslintcache"),
    }),

    new HtmlWebpackPlugin({
      // 以 public/index.html 为模板创建文件
      // 新的html文件有两个特点：1. 内容和源文件一致 2. 自动引入打包生成的js等资源
      // 如果不配置，会自动生成一个空的index.html，并不会使用当前路径下的index.html
      template: path.resolve(__dirname, "../public/index.html"),
    }),
    isProduction &&
    new MiniCssExtractPlugin({
      filename: "static/css/[name].[contenthash:10].css",
      chunkFilename: "static/css/[name].[contenthash:10].chunk.css",
    }),
    isProduction &&
    new CopyPlugin({

      patterns: [
        {
          // 将public下面的资源复制到dist目录去（除了index.html）
          from: path.resolve(__dirname, "../public"),
          to: path.resolve(__dirname, "../dist"),
          globOptions: {
            // 忽略index.html文件
            ignore: ["**/index.html"],
          },
        },
      ],
    }),
    new VueLoaderPlugin(),
    // cross-env定义的环境变量给打包工具使用
    // DefinePlugin定义环境变量给源代码使用，从而解决vue3页面警告的问题
    new DefinePlugin({
      __VUE_OPTIONS_API__: true,
      __VUE_PROD_DEVTOOLS__: false,
    }),
    // 按需加载element-plus
    AutoImport({
      resolvers: [ElementPlusResolver()],
    }),
    Components({
      resolvers: [
        ElementPlusResolver({
          // 自定义主题，引入sass
          importStyle: "sass",
        }),
      ],
    }),
  ].filter(Boolean),
  mode: isProduction ? "production" : "development",
  // 以下是一些常用的 devtool 配置选项及其特点：
  // eval: 使用 eval 函数在每个模块中执行代码，并通过 //# sourceURL 注释将映射后的代码和源代码关联起来。
  // cheap-eval-source-map: 在每个行中生成转换后的代码的 source map，但不包含列的信息。它将 source map 作为 DataURL 嵌入到 bundle.js 中。
  // cheap-module-eval-source-map: 类似于 cheap-eval-source-map，但同时会将原始源代码中的模块请求映射到转换后的模块。
  // eval-source-map: 在每个模块中生成 source map，并且使用 eval() 执行转换后的代码。它能更快地重新构建，但同时也增加了打包时间。
  // cheap-source-map: 在每个行中生成转换后的代码的 source map，但不包含列的信息。它单独生成 source map 文件，而不是嵌入到 bundle.js 中。
  // cheap-module-source-map: 类似于 cheap-source-map，但同时会将原始源代码中的模块请求映射到转换后的模块。
  // source-map: 在单独的文件中生成一个细粒度的 source map。它包含了转换前的源代码和转换后的代码的完整映射，支持断点调试和错误追踪。
  devtool: isProduction ? "source-map" : "cheap-module-source-map",
  optimization: {
    // 代码分割配置
    splitChunks: {
      chunks: "all",// 对所有模块都进行分割
      // layouts通常是admin项目的主体布局组件，所有路由组件都要使用的
      // 可以单独打包，从而复用
      // 如果项目中没有，请删除
      cacheGroups: {
        // 没写的配置的用默认配置即可
        vue: {
          test: /[\\/]node_modules[\\/]vue(.*)?[\\/]/,
          name: "vue-chunk",
          priority: 40,
        },
        // 如果项目中使用element-plus，此时将所有node_modules打包在一起，那么打包输出文件会比较大。
        // 所以我们将node_modules中比较大的模块单独打包，从而并行加载速度更好
        // 如果项目中没有，请删除
        elementPlus: {
          test: /[\\/]node_modules[\\/]element-plus[\\/]/,
          name: "elementPlus-chunk",
          priority: 30,
        },
        libs: {
          test: /[\\/]node_modules[\\/]/,
          name: "libs-chunk",
          priority: 20, // 权重最低，优先考虑前面内容
        },
      },
    },
    // 提取runtime文件
    runtimeChunk: {
      name: (entrypoint) => `runtime~${entrypoint.name}.js`, // runtime文件命名规则
    },
    // 压缩的操作
    minimize: isProduction,
    minimizer: [
      new CssMinimizerWebpackPlugin(),
      new CssMinimizerPlugin(),
      new TerserWebpackPlugin(),
      new ImageMinimizerPlugin({
        // 对图像最小化的处理
        minimizer: {
          implementation: ImageMinimizerPlugin.imageminGenerate,//告诉 ImageMinimizerPlugin 使用 imageminGenerate 方法来执行图像最小化处理。
          options: {
            plugins: [

              ["gifsicle", { interlaced: true }],//用于对 GIF 图像文件进行优化，设置 interlaced: true 可以启用隔行扫描优化。
              ["jpegtran", { progressive: true }],//用于对 JPEG 图像文件进行优化，设置 progressive: true 可以启用渐进式加载优化。
              ["optipng", { optimizationLevel: 5 }],//用于对 PNG 图像文件进行优化，optimizationLevel: 5 表示进行最高级别（级别 5）的优化
              [
                "svgo",//用于对 SVG 图像文件进行优化，plugins 列表指定了一系列优化插件的配置
                {
                  plugins: [
                    "preset-default",//启用默认的预设优化规则。
                    "prefixIds",//对 SVG 文件中的 id 进行前缀处理。
                    {
                      name: "sortAttrs", //对 SVG 文件中的属性进行排序，
                      params: {
                        xmlnsOrder: "alphabetical",//"alphabetical" 表示按字母顺序对 xmlns 属性进行排序。
                      },
                    },
                  ],
                },
              ],
            ],
          },
        },
      }),
    ],
  },
  // webpack解析模块加载选项
  resolve: {
    // 自动补全文件扩展名
    extensions: [".vue", ".js", ".json"],
    // 路径别名
    alias: {
      "@": path.resolve(__dirname, "../src"),
    },
  },
  devServer: {
    host: "localhost",
    port: 3000,
    open: true,
    hot: true, // 热更新，开启HMR，此时 css 样式经过 style-loader 处理，已经具备 HMR 功能了。 但是 js 还不行。需要在入口文件里配置
    historyApiFallback: true, // 解决前端路由刷新404问题
  },
  performance: false,//关闭performance 并不会优化生成的文件大小，它只是关闭了相关的警告和提示信息。如果你关心应用程序的性能和加载速度，建议打开
};

2.package.json

{
  "name": "vue-cli",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "start": "npm run dev",
     //cross-env是一个跨平台设置环境变量的工具，它允许你在不同的操作系统上通过命令行方式设置环境变量。使用cross-env可以确保在不同的平台上都能正确地设置环境变量。
    // 这是设置环境变量 NODE_ENV 的部分。NODE_ENV 是一个常见的环境变量，用于指示当前环境的模式
    // --config选项用于告诉Webpack使用指定的配置文件来进行构建。
    "dev": "cross-env NODE_ENV=development webpack serve --config ./config/webpack.config.js",
    "build": "cross-env NODE_ENV=production webpack --config ./config/webpack.config.js"
  },
   .....
  "browserslist": [
    // 这三个取的是交集
    "last 2 version", //市面上所有浏览器的最新两个版本
    "> 1%",  // 覆盖99%的浏览器
    "not dead"  // 死了的就不要了
  ],
  "devDependencies": {
    "@babel/core": "^7.17.10",
    "@babel/eslint-parser": "^7.17.0",
    "@vue/cli-plugin-babel": "^5.0.4",
    "babel-loader": "^8.2.5",
    "copy-webpack-plugin": "^10.2.4",
    "cross-env": "^7.0.3",
    "css-loader": "^6.7.1",
    "css-minimizer-webpack-plugin": "^3.4.1",
    "eslint-plugin-vue": "^8.7.1",
    "eslint-webpack-plugin": "^3.1.1",
    "html-webpack-plugin": "^5.5.0",
    "image-minimizer-webpack-plugin": "^3.2.3",
    "imagemin": "^8.0.1",
    "imagemin-gifsicle": "^7.0.0",
    "imagemin-jpegtran": "^7.0.0",
    "imagemin-optipng": "^8.0.0",
    "imagemin-svgo": "^10.0.1",
    "less-loader": "^10.2.0",
    "mini-css-extract-plugin": "^2.6.0",
    "postcss-loader": "^6.2.1",
    "postcss-preset-env": "^7.5.0",
    "sass": "^1.51.0",
    "sass-loader": "^12.6.0",
    "stylus-loader": "^6.2.0",
    "unplugin-auto-import": "^0.7.1",
    "unplugin-vue-components": "^0.19.3",
    "vue-style-loader": "^4.1.3",
    "vue-template-compiler": "^2.6.14",
    "webpack": "^5.72.0",
    "webpack-cli": "^4.9.2",
    "webpack-dev-server": "^4.9.0"
  },
  .....
}

3.  .eslintrc.js

module.exports = {
  // root: true 表示当前配置文件是根配置文件，不会继续向上查找其他配置文件，并将该文件作为项目的独立配置。
  root: true,
  env: {
    node: true, // 启用node中全局变量
    //browser: true, // 启用浏览器中全局变量
  },
  // 继承规则
  extends: ["plugin:vue/vue3-essential", "eslint:recommended"],
  // 解析选项
  parserOptions: {
    // 运用的是规则，需要安装
    parser: "@babel/eslint-parser",
  },
  
};

4.babel.config.js

module.exports = {
  // 这也是一个规则，需要下载@vue/cli-plugin-babel
  presets: ["@vue/cli-plugin-babel/preset"]
};

5. main.js(入口文件)

console.log(123,'@@@@');
import count from "./public/js/count";
import sum from "./public/js/sum";
import './public/css/index.css'
import './public/css/index1.css'
console.log(count(2, 1));
console.log(sum(1, 2, 3, 4));
....

// 判断是否支持HMR功能
// 原生没有插件的时候使用此方法，但这样写会很麻烦，所以实际开发我们会使用其他 loader 来解决。比如：vue-loader, react-hot-loader。就不用再写此段代码了
if (module.hot) {
  // 引入js文件
  module.hot.accept("./js/count.js", function (count) {
    const result1 = count(2, 1);
    console.log(result1);
  });

  module.hot.accept("./js/sum.js", function (sum) {
    const result2 = sum(1, 2, 3, 4);
    console.log(result2);
  });
}