# @erbelion/vite-plugin-laravel-purgecss 中文文档

规范地址：https://npmcn.com/package/%40erbelion/vite-plugin-laravel-purgecss/

版本：0\.4\.8
npm 元数据更新时间：2026-04-27T16:13:44.902Z
中文译文更新时间：2026-11-13T20:38:50.059Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40erbelion/vite-plugin-laravel-purgecss
原文对照：https://npmcn.com/package/%40erbelion/vite-plugin-laravel-purgecss/?lang=original
项目主页：https://github.com/erbelion/vite-plugin-laravel-purgecss#readme
源码仓库：https://github.com/erbelion/vite-plugin-laravel-purgecss

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：31.2 kB，18 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：vite \>=3
- 首次发布：2022-10-09T18:36:39.724Z
- 最新版本发布：2026-04-27T16:13:44.770Z
- 近 30 天下载量：6336（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 6 个）

## 中文简介

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

## 安装

```sh
npm install @erbelion/vite-plugin-laravel-purgecss
```

也可以使用：`pnpm add @erbelion/vite-plugin-laravel-purgecss`、`yarn add @erbelion/vite-plugin-laravel-purgecss`、`bun add @erbelion/vite-plugin-laravel-purgecss`

## README

# 紫外插管-喉管-整流器

[![Get package from npm](https://img.shields.io/npm/v/@erbelion/vite-plugin-laravel-purgecss?logo=npm&logoColor=white&style=flat&label=)](https://www.npmjs.com/package/@erbelion/vite-plugin-laravel-purgecss) [![Downloads](https://img.shields.io/npm/dt/@erbelion/vite-plugin-laravel-purgecss?color=blue&label=&logoColor=white&style=flat&logo=data:image/svg%2bxml;base64,PHN2ZyB2aWV3Qm94PSIwIDAgMjQgMjQiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgc3Ryb2tlPSIjZmZmZmZmIj48ZyBpZD0iU1ZHUmVwb19iZ0NhcnJpZXIiIHN0cm9rZS13aWR0aD0iMCI+PC9nPjxnIGlkPSJTVkdSZXBvX3RyYWNlckNhcnJpZXIiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCI+PC9nPjxnIGlkPSJTVkdSZXBvX2ljb25DYXJyaWVyIj4gPHBhdGggZD0iTTEyLjUgNFYxN00xMi41IDE3TDcgMTIuMjEwNU0xMi41IDE3TDE4IDEyLjIxMDUiIHN0cm9rZT0iI2ZmZmZmZiIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjwvcGF0aD4gPHBhdGggZD0iTTYgMjFIMTkiIHN0cm9rZT0iI2ZmZmZmZiIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjwvcGF0aD4gPC9nPjwvc3ZnPg==)](https://www.npmjs.com/package/@erbelion/vite-plugin-laravel-purgecss) [![Downloads](https://img.shields.io/npm/dw/@erbelion/vite-plugin-laravel-purgecss?color=blue&label=&logoColor=white&style=flat&logo=data:image/svg%2bxml;base64,PHN2ZyB2aWV3Qm94PSIwIDAgMjQgMjQiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgc3Ryb2tlPSIjZmZmZmZmIj48ZyBpZD0iU1ZHUmVwb19iZ0NhcnJpZXIiIHN0cm9rZS13aWR0aD0iMCI+PC9nPjxnIGlkPSJTVkdSZXBvX3RyYWNlckNhcnJpZXIiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCI+PC9nPjxnIGlkPSJTVkdSZXBvX2ljb25DYXJyaWVyIj4gPHBhdGggZD0iTTEyLjUgNFYxN00xMi41IDE3TDcgMTIuMjEwNU0xMi41IDE3TDE4IDEyLjIxMDUiIHN0cm9rZT0iI2ZmZmZmZiIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjwvcGF0aD4gPHBhdGggZD0iTTYgMjFIMTkiIHN0cm9rZT0iI2ZmZmZmZiIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjwvcGF0aD4gPC9nPjwvc3ZnPg==)](https://www.npmjs.com/package/@erbelion/vite-plugin-laravel-purgecss) [![views](https://views.erbek.space/api/views.svg?id=github.com%2Ferbelion%2Fvite-plugin-laravel-purgecss)](https://views.erbek.space/page/?id=github.com%2Ferbelion%2Fvite-plugin-laravel-purgecss)

A 类 [维特](https://github.com/vitejs/vite) 集成的插件 [清洗](https://github.com/FullHuman/purgecss) 与 [拉维尔9-13](https://github.com/laravel/laravel) 模板资产(目前更新到laravel/laravel@13.1.0).

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

## \* 安装

**使用 pnpm :**

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

**使用线条 :**

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

**使用 npm :**

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

## 使用量

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

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

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

**[更多信息](https://npmcn.com/package/%40erbelion/vite-plugin-laravel-purgecss/#readme--other-examples)**

## QQ 选项

| 参数 | 类型 | 可选 | 说明 |
| --- | --- | --- | --- |
| 路径 | `string[]` | 对 | 由PurgeCSS处理的路径列表. |
| 重写 | `boolean` | 对 | 确定清理后是否需要散列资产文件名 . |
| PurgeCSS 选项 | `Partial<UserDefinedOptions>` | 对 | PurgeCSS 选项 [(见文件)](https://purgecss.com/configuration.html#options)。 。 。 . |
| 模板 | `string[]` | 对 | 已贬值 [(无论如何,见)](https://github.com/erbelion/vite-plugin-laravel-purgecss/blob/main/src/deprecated/DEPRECATED-OPTIONS.md)。 。 。 . |

### `paths` 选项

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

```text
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` 相应.

### 所有选项

```typescript
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
}
```

## 其他实例

**通过自定义路径 :**

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

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

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

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

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

## 教书

[https://github.com/erbelion/touric-vite-plugin-laravel-purces (中文(简体) )](https://github.com/erbelion/tutorial-vite-plugin-laravel-purgecss#tutorial-vite-plugin-laravel-purgecss)

## 👉 另见:

-   [紫外插管丝绒特基特清洗器](https://github.com/erbelion/vite-plugin-sveltekit-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 和提交记录判断。