@erbelion/vite-plugin-laravel-purgecss

中文文档
0.4.8发布于 2026/04/28MITTypeScriptESM + CJS近 30 天下载 6336

一个Vite插件,将PurgeCSS与Laravel模板资产整合.

中文使用文档
文档目录9 节
  1. * 安装
  2. 使用量
  3. QQ 选项
  4. paths 选项
  5. rehash 选项(实验)
  6. 所有选项
  7. 其他实例
  8. 教书
  9. 👉 另见:

紫外插管-喉管-整流器

Get package from npm Downloads Downloads views

A 类 维特 集成的插件 清洗 与 拉维尔9-13 模板资产(目前更新到laravel/[email protected]).

此插件仅在生产模式中清除未使用的 CSS 资产(pnpm build 编号 : yarn build 编号 : npm run build) (中文(简体) ).

* 安装

使用 pnpm :

pnpm add -D @erbelion/vite-plugin-laravel-purgecss

使用线条 :

yarn add -D @erbelion/vite-plugin-laravel-purgecss

使用 npm :

npm i -D @erbelion/vite-plugin-laravel-purgecss

使用量

使用您 Vite 配置中的插件( U)vite.config.ts:

import purge from '@erbelion/vite-plugin-laravel-purgecss'

export default {
    plugins: [
        laravel(...),
        purge()
    ]
}

更多信息

QQ 选项

参数类型可选说明
路径string[]对由PurgeCSS处理的路径列表.
重写boolean对确定清理后是否需要散列资产文件名 .
PurgeCSS 选项Partial<UserDefinedOptions>对PurgeCSS 选项 (见文件)。 。 。 .
模板string[]对已贬值 (无论如何,见)。 。 。 .

paths 选项

如果 paths 未指定选项,它默认为:

resources/{js,views}/**/*.{blade.php,svelte,vue,html}

rehash 选项(实验)

如果 rehash 未指定选项,它将默认为 false。 。 。 .

⚠️ 实验 —— 说 rehash 补丁 manifest.json 在Vite 写下之后的磁盘上。 这依赖于对可能突破Vite版本的Vite输出格式的假设.

为什么 rehash 存在吗?

基于此选项的 Vite hashes CSS 文件名 未处理的SCSS/CSS源 时间(例如:. app-B2qGsMUw.css) (中文(简体) ). 散开的 没有 当您在"刀锋"模板中添加新类时更改( 尽管PurgeCSS) 将在产出中增加规则.

无 rehash,浏览器或CDN缓存了旧的 CSS 文件永远不会知道 重接它, 因为尽管内容不同,文件名是相同的.

与 rehash 启用时,插件附加从 清除 CSS 内容 (例如:. app-B2qGsMUw-e5ec2996.css)和补丁 manifest.json 相应.

所有选项

type Options = {
    // Plugin options
    paths?: string[] // Defaults to `resources/{js,views}/**/*.{blade.php,svelte,vue,html}`
    rehash?: boolean // Defaults to `true`
    templates?: string[] // ❌ Deprecated

    // PurgeCSS options
    defaultExtractor?: ExtractorFunction
    extractors?: Array<Extractors>
    fontFace?: boolean
    keyframes?: boolean
    output?: string
    rejected?: boolean
    rejectedCss?: boolean
    stdin?: boolean
    stdout?: boolean
    variables?: boolean
    safelist?: UserDefinedSafelist
    blocklist?: StringRegExpArray
}

其他实例

通过自定义路径 :

purge({
    paths: ["resources/{js,views}/**/*.{blade.php,svelte,vue,html}"],
})

通过自定义路径 + 安全列表样式 : (总是保持) #bruh, (中文(简体) ), .nice-button,以及 h1 样式)

purge({
    paths: ["resources/views/**/*.blade.php", "resources/{js,views}/**/*.vue"],
    safelist: ["bruh", "nice-button", "h1"],
})

带有已逃出前缀的固定的示例配置( E)sm:, (中文(简体) ), lg:等 :

purge({
    extractors: [
        {
            extractor: (content) => {
                return content.match(/[a-z-_:\/]+/g) || []
            },
            extensions: ["php", "vue", "html"],
        },
    ],
})

教书

https://github.com/erbelion/touric-vite-plugin-laravel-purces (中文(简体) )

👉 另见:

版本与发布记录

@erbelion/vite-plugin-laravel-purgecss 共发布 33 个版本,首次发布于 2022/10/10;过去 12 个月发布了 6 个版本。

版本发布日期距今
0.4.8latest2026/04/286 个月前
0.4.72026/02/119 个月前
0.4.62026/02/119 个月前
0.4.52026/02/119 个月前
0.4.42025/11/1611 个月前
0.4.32025/11/1611 个月前

关于 @erbelion/vite-plugin-laravel-purgecss 的常见问题

@erbelion/vite-plugin-laravel-purgecss 是什么?

一个Vite插件,将PurgeCSS与Laravel模板资产整合.

如何安装 @erbelion/vite-plugin-laravel-purgecss?

在项目目录运行 npm install @erbelion/vite-plugin-laravel-purgecss,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vite(>=3)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@erbelion/vite-plugin-laravel-purgecss 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@erbelion/vite-plugin-laravel-purgecss 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@erbelion/vite-plugin-laravel-purgecss 可以商用吗?

@erbelion/vite-plugin-laravel-purgecss 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@erbelion/vite-plugin-laravel-purgecss 的下载量有多少?

根据 npm 官方下载统计,@erbelion/vite-plugin-laravel-purgecss 在 2026/10/14 – 2026/11/12 这 30 天内被下载 6,336 次,日均约 211 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@erbelion/vite-plugin-laravel-purgecss 还在维护吗?

最新版本 0.4.8 发布于 2026/04/28(6 个月前);至今共发布 33 个版本,其中过去 12 个月发布了 6 个;首次发布于 2022/10/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。