# @fungi\.computer/cloudflare-worker-bundler 中文文档

规范地址：https://npmcn.com/package/%40fungi.computer/cloudflare-worker-bundler/

版本：0\.2\.3-fungi\.0
npm 元数据更新时间：2026-10-15T08:01:22.137Z
中文译文更新时间：2026-11-15T18:20:30.795Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fungi.computer/cloudflare-worker-bundler
原文对照：https://npmcn.com/package/%40fungi.computer/cloudflare-worker-bundler/?lang=original
项目主页：https://github.com/fungi-computer/cloudflare-worker-bundler#readme
源码仓库：https://github.com/fungi-computer/cloudflare-worker-bundler

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

- 包体积（解压后）：26 MB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：10 个
- 首次发布：2026-10-15T07:59:11.759Z
- 最新版本发布：2026-10-15T08:01:21.815Z
- 近 30 天下载量：12581（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

@ cloudflare/ 工人- 绑定器的分叉, 不含捆绑图

## 安装

```sh
npm install @fungi.computer/cloudflare-worker-bundler
```

也可以使用：`pnpm add @fungi.computer/cloudflare-worker-bundler`、`yarn add @fungi.computer/cloudflare-worker-bundler`、`bun add @fungi.computer/cloudflare-worker-bundler`

## README

# @fungi. 计算机/云雾-工人-bundler

> **实验**: 此软件包正在积极开发中, 它的 API 可能 不加通知地更改。 未建议用于生产.

在Cloudflare的软件包和软件包上服务 [装入器装订](https://developers.cloudflare.com/workers/runtime-apis/bindings/worker-loader/) (闭塞β. 它能动态地产生真正npm依赖性的工人,或者 用客户端捆绑和静态资产服务构建完整的应用程序.

## 运行时间要求

此软件包只运行 **在Cloudflare工人运行时间(`workerd`(中文(简体) )** —— 说 生产和生产 `wrangler dev`它通过一个 `esbuild-wasm` `WebAssembly.Module` 输入只有 Worker 模块加载器可以解析. 它会 **没有** 普通节点下的工作,包括默认集合 Vitest/Jest 测试; 取决于其需要的测试代码 [`@cloudflare/vitest-pool-workers`](https://developers.cloudflare.com/workers/testing/vitest-integration/)。 。 。 .

这个 `./assets` 条目(见下文)是例外:没有捆绑器 依赖和运行任何地方.

## 真菌叉

这个包是真菌叉 [`@cloudflare/worker-bundler`](https://github.com/cloudflare/agents/tree/%40cloudflare/worker-bundler%400.2.3/packages/worker-bundler) 6.2.3 (承诺) `d424945`),以麻省理工学院许可证发行. 从 上游由真菌电脑制作:

-   `src/assets.ts`: 一个新的 `./assets` 服务资产出口条目 (单位:千美元)`handleAssetRequest`, (中文(简体) ), `buildAssetManifest`, (中文(简体) ), `buildAssets`, (中文(简体) ), `createMemoryStorage`, (中文(简体) ), `inferContentType`, (中文(简体) ), `isTextContentType`没有 esbuild/Sucrase 捆绑图. `src/index.ts` 再出口相同名称.
-   `src/file-system.ts`进口 `DurableObjectStorage` 从 `@cloudflare/workers-types`,现在是一个依赖, 所以出版 在无环境工人类型的情况下进行类型检查.
-   `scripts/build.ts`: 构建 `./assets` 输入并降低上游 单相声明格式化步骤.
-   `src/index.ts`, (中文(简体) ), `src/app.ts`, (中文(简体) ), `src/asset-handler.ts`: 三个表达式 重写时没有多余的分量 所以叉子通过牛林 正确规则.
-   只有可操作的上游试验(`asset-handler`, (中文(简体) ), `redos`)保留.

见 [通知](https://npmcn.com/package/%40fungi.computer/cloudflare-worker-bundler/NOTICE) 用于完整归属文本.

## 安装

```sh
npm install @fungi.computer/cloudflare-worker-bundler
```

## 快开始

Bundle a Worker - 提供源代码和依赖, 捆绑手柄 其余部分:

```ts
import { createWorker } from "@fungi.computer/cloudflare-worker-bundler";

const worker = env.LOADER.get("my-worker", async () => {
  const { mainModule, modules } = await createWorker({
    files: {
      "src/index.ts": `
        import { Hono } from 'hono';
        const app = new Hono();
        app.get('/', (c) => c.text('Hello from Hono!'));
        export default app;
      `,
      "package.json": JSON.stringify({ dependencies: { hono: "^4.0.0" } })
    }
  });

  return { mainModule, modules, compatibilityDate: "2026-01-01" };
});

await worker.getEntrypoint().fetch(request);
```

独立时使用静态资产 `./assets` 条目( 无捆绑图) 所需:

```ts
import {
  handleAssetRequest,
  buildAssets
} from "@fungi.computer/cloudflare-worker-bundler/assets";

const { manifest, storage } = await buildAssets({
  "/index.html": "<h1>Hello</h1>"
});

export default {
  async fetch(request) {
    const assetResponse = await handleAssetRequest(request, manifest, storage);
    if (assetResponse) return assetResponse;
    return new Response("API");
  }
};
```

`createApp` 捆绑服务器 Worker、客户端 JavaScript 和静态 在一个呼叫中合并资产;见 [上游读取](https://github.com/cloudflare/agents/tree/%40cloudflare/worker-bundler%400.2.3/packages/worker-bundler#readme) 页:1 `createApp`,满 `createWorker`编号 :`createApp` 选项表格 `FileSystem` 接口( e)`InMemoryFileSystem`, (中文(简体) ), `DurableObjectKVFileSystem`, (中文(简体) ), `DurableObjectRawFileSystem`),进程内 TypeScript 语言服务 (单位:千美元)`./typescript` 子路径),资产配置(HTML/未找到处理, 重新定向、取头、缓存)和已知的局限性——无一变化 这个叉子超越 `./assets` 上文提到的切入点.

## 在使用的地方

[牡蛎](https://github.com/fungi-computer/oyster) 用此叉来捆绑 并使用 `./assets` 为静态资产服务的条目 不拉入捆绑.

## 许可证

麻省理工学院. 此软件包带有上游 Cloudflare 版权和许可证 不变——见 [自由主义](https://npmcn.com/package/%40fungi.computer/cloudflare-worker-bundler/LICENSE) 财务报告和审定财务报表 [通知](https://npmcn.com/package/%40fungi.computer/cloudflare-worker-bundler/NOTICE)。 。 。 .

## 常见问题

### @fungi\.computer/cloudflare-worker-bundler 是什么？

@ cloudflare/ 工人- 绑定器的分叉, 不含捆绑图

### 如何安装 @fungi\.computer/cloudflare-worker-bundler？

在项目目录运行 npm install @fungi\.computer/cloudflare-worker-bundler，或使用 pnpm add / yarn add / bun add。

### @fungi\.computer/cloudflare-worker-bundler 支持 TypeScript 吗？

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

### @fungi\.computer/cloudflare-worker-bundler 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @fungi\.computer/cloudflare-worker-bundler 需要什么版本的 Node\.js？

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

### @fungi\.computer/cloudflare-worker-bundler 可以商用吗？

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

### @fungi\.computer/cloudflare-worker-bundler 的下载量有多少？

根据 npm 官方下载统计，@fungi\.computer/cloudflare-worker-bundler 在 2026/10/16 – 2026/11/14 这 30 天内被下载 12,581 次，日均约 419 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fungi\.computer/cloudflare-worker-bundler 还在维护吗？

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