# @aaroon/workbox-rspack-plugin 中文文档

规范地址：https://npmcn.com/package/%40aaroon/workbox-rspack-plugin/

版本：1\.0\.1
npm 元数据更新时间：2026-05-23T04:12:33.190Z
中文译文更新时间：2026-11-05T17:32:35.125Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：34.6 kB，14 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：4 个
- peer 依赖：@rsbuild/core ^1\.0\.0 \|\| ^2\.0\.0，@rspack/core ^1\.0\.0 \|\| ^2\.0\.0
- 首次发布：2024-03-10T08:45:40.051Z
- 最新版本发布：2026-05-23T04:12:32.885Z
- 近 30 天下载量：274156（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 3 个）

## 中文简介

使用工作盒的 Rspack 插件

## 安装

```sh
npm install @aaroon/workbox-rspack-plugin
```

也可以使用：`pnpm add @aaroon/workbox-rspack-plugin`、`yarn add @aaroon/workbox-rspack-plugin`、`bun add @aaroon/workbox-rspack-plugin`

## README

# 工作箱- rspack- 插件

[![NPM version](https://badge.fury.io/js/@aaroon%2Fworkbox-rspack-plugin.svg)](https://www.npmjs.com/package/@aaroon/workbox-rspack-plugin) [![NPM Downloads](https://img.shields.io/npm/dw/@aaroon/workbox-rspack-plugin)](https://www.npmjs.com/package/@aaroon/workbox-rspack-plugin) [![License](https://img.shields.io/github/license/Clarkkkk/workbox-rspack-plugin)](https://github.com/Clarkkkk/workbox-rspack-plugin/blob/main/LICENSE.md) [![Minified Size](https://img.shields.io/npm/unpacked-size/%40aaroon%2Fworkbox-rspack-plugin)](https://www.npmjs.com/package/@aaroon/workbox-rspack-plugin) [![Build Status](https://img.shields.io/github/actions/workflow/status/Clarkkkk/workbox-rspack-plugin/.github%2Fworkflows%2Fpublish.yml)](https://github.com/Clarkkkk/workbox-rspack-plugin/actions)

要使用的 rspack 插件 [工作框](https://developer.chrome.com/docs/workbox) {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}在棕榈树上 两者 `GenerateSW` 财务报告和审定财务报表 `InjectManifest` 被支持。 所有的选择都和官方一样 [`workbox-webpack-plugin`](https://developer.chrome.com/docs/workbox/modules/workbox-webpack-plugin)目前,它通过所有测试 从官方 `workbox-webpack-plugin`,并应当为一般用途稳定。 有问题就随便吧 [打开一个问题](https://github.com/Clarkkkk/workbox-rspack-plugin/issues)。 。 。 .

## 所需经费

```sh
node >= 18
```

并有以下一说:

```sh
@rspack/core@^1.0.0 || ^2.0.0
```

或者说

```sh
@rsbuild/core@^1.0.0 || ^2.0.0
```

## 安装

```sh
npm i -D @aaroon/workbox-rspack-plugin
```

或者说

```sh
pnpm i -D @aaroon/workbox-rspack-plugin
```

```sh
yarn add -D @aaroon/workbox-rspack-plugin
```

## 使用量

```js
import { GenerateSW, InjectManifest } from '@aaroon/workbox-rspack-plugin'
/**
 * @type import('@rspack/cli').Configuration}
 */
export default {
    plugins: [
        new GenerateSW({
            // options
        }),
        // or
        new InjectManifest({
            // options
        })
    ]
}
```

如果你在用Rsbuild的话,用它来 `tools.rspack.plugins`数字 :

```js
import { defineConfig } from '@rsbuild/core'
import { GenerateSW, InjectManifest } from '@aaroon/workbox-rspack-plugin'

export default defineConfig({
    tools: {
        rspack: {
            plugins: [
                new GenerateSW({
                    // options
                }),
                // or
                new InjectManifest({
                    // options
                })
            ]
        }
    }
})
```

## 选项

与 [工作箱-网包-插件](https://developer.chrome.com/docs/workbox/modules/workbox-webpack-plugin)。 。 。 .

## 更改日志

可见 changelog [这里](https://github.com/Clarkkkk/workbox-rspack-plugin/blob/main/CHANGELOG.md)。 。 。 .

## 贷项

大部分代码来自Google的工作框 [还原](https://github.com/GoogleChrome/workbox)我只是让它和Rspack兼容.

## 承认

如果你觉得它有用,我会很感激 如果你能留下一颗星星 在工程的GitHub仓库.

谢谢.

## 常见问题

### @aaroon/workbox-rspack-plugin 是什么？

使用工作盒的 Rspack 插件

### 如何安装 @aaroon/workbox-rspack-plugin？

在项目目录运行 npm install @aaroon/workbox-rspack-plugin，或使用 pnpm add / yarn add / bun add。

### @aaroon/workbox-rspack-plugin 支持 TypeScript 吗？

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

### @aaroon/workbox-rspack-plugin 支持 ESM 还是 CommonJS？

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

### @aaroon/workbox-rspack-plugin 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aaroon/workbox-rspack-plugin 可以商用吗？

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

### @aaroon/workbox-rspack-plugin 的下载量有多少？

根据 npm 官方下载统计，@aaroon/workbox-rspack-plugin 在 2026/10/05 – 2026/11/03 这 30 天内被下载 274,156 次，日均约 9,139 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aaroon/workbox-rspack-plugin 还在维护吗？

最新版本 1\.0\.1 发布于 2026/05/23（5 个月前）；至今共发布 10 个版本，其中过去 12 个月发布了 3 个；首次发布于 2024/03/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。