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 标记
相关推荐
qq4356947012 分钟前
Vue02
开发语言·前端·javascript
小李云雾12 分钟前
Pinia:Vue3 全局状态管理从入门到精通
前端·javascript·vue.js
风吹夏回20 分钟前
Vue3 + Element Plus 完整使用指南
前端·javascript·vue.js·element
疯狂SQL9 小时前
JWT 在线解码、验签、生成一篇讲透:附前端实现、工具架构与在线体验地址
javascript·jwt·编解码·jwt测试
前端一小卒10 小时前
不手写代码的第 30 天,我才明白前端这个岗位还剩什么
前端·javascript·ai编程
Ajie'Blog10 小时前
Copilot Agent Tasks API 开放:AI 编程开始进入后台任务时代
服务器·前端·javascript·人工智能·copilot·ai编程
老毛肚10 小时前
jeecgboot vue TS & 模板化 04
前端·javascript·vue.js
晓131310 小时前
【Cocos Creator 2.x】篇——第二章 入门
javascript·游戏引擎
Electrolux12 小时前
[onlyoffice-v9]纯前端怎么实现编辑预览office
前端·javascript·github
VidDown12 小时前
Webhook 调试器:让第三方回调“原形毕露”
java·开发语言·javascript·编辑器·postman