vite的tersor在lib库模式下不生效问题

@vite的tersor在lib库模式下不生效

官网解释:

https://vitejs.cn/vite3-cn/config/build-options.html#build-minify

复制代码
build.minify
类型: boolean | 'terser' | 'esbuild'
默认: 'esbuild'
设置为 false 可以禁用最小化混淆,或是用来指定使用哪种混淆器。默认为 Esbuild,它比 terser 快 20-40 倍,压缩率只差 1%-2%。

注意,在 lib 模式下使用 'es' 时,build.minify 选项不会缩减空格,因为会移除掉 pure 标注,导致破坏 tree-shaking。

当设置为 'terser' 时必须先安装 Terser。
npm add -D terser

遇到的问题:

javascript 复制代码
import { defineConfig, loadEnv } from 'vite'
import vue from '@vitejs/plugin-vue'
import { resolve } from 'path'
import { libInjectCss } from 'vite-plugin-lib-inject-css'

export default defineConfig(({ mode }) => {
  const env = loadEnv(mode, process.cwd())
  const isProduction = mode === 'production'

  return {
    plugins: [
      vue(),
      libInjectCss()
    ],
    build: {
      lib: {
        entry: resolve(__dirname, 'packages/index.js'),
        name: 'TalosExplainPlayer',
        formats: ['es', 'umd'],
        fileName: (format) => `talos-explain-player.${format}.js`
      },
      rollupOptions: {
        external: ['vue', 'element-plus'],
        output: {
          globals: {
            vue: 'Vue',
            'element-plus': 'ElementPlus'
          }
        }
      },
      // 使用 terser 进行代码压缩(生产环境)
      minify: isProduction ? 'terser' : false,
      terserOptions: isProduction ? {
        compress: {
          drop_console: true,
          drop_debugger: true,
          pure_funcs: ['console.log', 'console.info', 'console.debug']
        },
        mangle: {
          safari10: true
        },
        format: {
          comments: false
        }
      } : {}
    },
    server: {
      port: 5173,
      host: true
    },
    define: {
      __VUE_OPTIONS_API__: true,
      __VUE_PROD_DEVTOOLS__: false,
      // 将环境变量注入到 import.meta.env 中
      'import.meta.env.VITE_APP_BASE_URL': JSON.stringify(env.VITE_APP_BASE_URL),
      'import.meta.env.NODE_ENV': JSON.stringify(env.NODE_ENV)
    }
  }
})

最终解决:

使用 @rollup/plugin-terser 作为 Rollup 插件;优势:作为 Rollup 插件,会处理所有输出格式(包括 ES 和 UMD)

javascript 复制代码
import { defineConfig, loadEnv } from 'vite'
import vue from '@vitejs/plugin-vue'
import { resolve } from 'path'
import { libInjectCss } from 'vite-plugin-lib-inject-css'
import terser from '@rollup/plugin-terser'

export default defineConfig(({ mode }) => {
  const env = loadEnv(mode, process.cwd())
  const isProduction = mode === 'production'

  return {
    plugins: [
      vue(),
      libInjectCss()
    ],
    build: {
      lib: {
        entry: resolve(__dirname, 'packages/index.js'),
        name: 'TalosExplainPlayer',
        formats: ['es', 'umd'],
        fileName: (format) => `talos-explain-player.${format}.js`
      },
      rollupOptions: {
        external: ['vue', 'element-plus'],
        output: {
          globals: {
            vue: 'Vue',
            'element-plus': 'ElementPlus'
          }
        },
        // 生产环境下使用 terser 压缩所有格式(包括 ES 格式)
        plugins: isProduction ? [
          terser({
            ecma: 2020,
            module: true,
            compress: {
              drop_console: true,
              drop_debugger: true,
              pure_funcs: ['console.log', 'console.info', 'console.debug']
            },
            mangle: {
              safari10: true
            },
            format: {
              comments: false
            }
          })
        ] : []
      }
    },
    server: {
      port: 5173,
      host: true
    },
    define: {
      __VUE_OPTIONS_API__: true,
      __VUE_PROD_DEVTOOLS__: false,
      // 将环境变量注入到 import.meta.env 中
      'import.meta.env.VITE_APP_BASE_URL': JSON.stringify(env.VITE_APP_BASE_URL),
      'import.meta.env.NODE_ENV': JSON.stringify(env.NODE_ENV)
    }
  }
})

原因:

为什么应用模式可以生效?为什么库模式不生效?

在应用模式下:

● Vite 会压缩所有输出文件

● 不需要考虑 tree-shaking 的 pure 标注

● 输出是最终应用,不是供他人使用的库

● build.minify 对所有格式都生效

在库模式下:

● Vite 需要保留 /#PURE/ 等注释以支持 tree-shaking

● ES 模块通常由最终用户的应用构建工具处理

● 因此 Vite 在库模式下对 ES 格式不压缩(或只做有限压缩)

● 文档说明:不会缩减空格,实际可能完全不压缩

总结:

特性 应用模式 (build.lib) 库模式 (build.lib)
存在性 ❌ 无 ✅ 有
build.minify 对 ES 格式 ✅ 生效 ❌ 不生效
输出用途 最终应用 供他人使用的库
压缩策略 完全压缩 保留 tree-shaking 标记
相关推荐
老华带你飞11 小时前
考试管理系统|基于java+ vue考试管理系统(源码+数据库+文档)
java·开发语言·前端·数据库·vue.js·spring boot·后端
_Kayo_11 小时前
React上绑定全局方法
前端·javascript·react.js
练习前端两年半12 小时前
【Vue3 高级技巧】函数重载+Watch:打造类型安全的通用事件监听 Hook
前端·javascript·vue.js
一只小鸟儿12 小时前
门户短信发送验证码及验证功能
前端·javascript·jquery
talenteddriver12 小时前
mysql: MySQL中between子句和limit子句的区别
前端·javascript·数据库
q_191328469513 小时前
基于SpringBoot+Vue.js的高校竞赛活动信息平台
vue.js·spring boot·后端·mysql·程序员·计算机毕业设计
我是小邵13 小时前
【踩坑实录】一次 H5 页面在 PC 端的滚动条与轮播图修复全过程(Vue + Vant)
前端·javascript·vue.js
2501_9462309813 小时前
Cordova&OpenHarmony外观主题设置
android·javascript
军军君0113 小时前
Three.js基础功能学习一:环境资源及基础知识
开发语言·javascript·学习·3d·前端框架·threejs·三维
千寻girling14 小时前
面试官: “ 请你说一下什么是 ajax ? ”
前端·javascript