# @builder\.io/partytown 中文文档

规范地址：https://npmcn.com/package/%40builder.io/partytown/

版本：0\.10\.3
npm 元数据更新时间：2026-09-09T09:16:52.556Z
中文译文更新时间：2026-11-08T18:58:15.663Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40builder.io/partytown
原文对照：https://npmcn.com/package/%40builder.io/partytown/?lang=original
项目主页：https://github.com/BuilderIO/partytown#readme
源码仓库：https://github.com/BuilderIO/partytown

弃用说明：Use @qwik\.dev/partytown instead

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

- 包体积（解压后）：394 kB，31 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：0 个
- 首次发布：2021-09-14T13:51:45.203Z
- 最新版本发布：2024-12-20T22:17:11.903Z
- 近 30 天下载量：914934（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：81（近 12 个月 0 个）

## 中文简介

将资源密集型第三方脚本从主线上移出并转入网络工人.

## 安装

```sh
npm install @builder.io/partytown
```

也可以使用：`pnpm add @builder.io/partytown`、`yarn add @builder.io/partytown`、`bun add @builder.io/partytown`

## README

# 政党镇

![Partytown github fit 2x](https://user-images.githubusercontent.com/452425/134568488-f36f4640-9ada-4a78-a969-2b8315cf7f47.png)

-   [介绍党镇:从网络工人那里运行第三方脚本](https://dev.to/adamdbradley/introducing-partytown-run-third-party-scripts-from-a-web-worker-2cnp)
-   [党城的同步通信工作](https://dev.to/adamdbradley/how-partytown-s-sync-communication-works-4244)
-   [我们如何用Qwik + Partytown 剪去99%的JavaScript](https://www.builder.io/blog/how-we-cut-99-percent-js-with-qwik-and-partytown)
-   [派对镇现在在Beta](https://www.builder.io/blog/partytown-is-now-in-beta)

> 您的第三方脚本挂出一个有趣的位置

党城是一个懒惰的图书馆 帮助迁移资源密集的脚本 [网络工人](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API),并关闭 [主线程](https://developer.mozilla.org/en-US/docs/Glossary/Main_thread)它的目标是通过将主线线与您的代码连接起来,以及将第三方的脚本卸载到网络工人身上来帮助加快网站的速度.

> 注:"党城"仍为β,不能保证在每一种情景下工作. 请看我们的 [财务问题](https://partytown.builder.io/faq) 财务报告和审定财务报表 [贸易业务](https://partytown.builder.io/trade-offs) 章节以获取更多信息.

哲学是,主线应该专注在您的代码上,以及任何不需要输入的脚本 [关键路径](https://developers.google.com/web/fundamentals/performance/critical-rendering-path) 应移至网络工人。 主要线程性能毫无疑问比网络工人线程性能更重要.

-   [开始](https://partytown.builder.io/getting-started)
-   [一体化](https://partytown.builder.io/integrations)
-   [配置](https://partytown.builder.io/configuration)
-   [释放](https://github.com/BuilderIO/partytown/releases)
-   [问题](https://partytown.builder.io/faq)

![Without Partytown and With Partytown: Your code and third-party code compete for main thread resources](https://user-images.githubusercontent.com/452425/152393346-6f721a4f-3f66-410a-8878-a2b49e24307f.png)

## 社区

-   [维克捷夫](https://twitter.com/QwikDev)
-   [@ Builderio (西班牙语)](https://twitter.com/builderio)
-   [地方发展](https://github.com/BuilderIO/partytown/blob/main/CONTRIBUTING.md#local-development)
-   [用于插件作者/ 开发者](https://github.com/BuilderIO/partytown/blob/main/CONTRIBUTING.md#plugin-authors-developers)

## 相关项目

-   [齐克](https://github.com/BuilderIO/qwik):一个开源框架,设计时间尽可能好,可以进行互动,其方法是注重服务器-侧式交付HTML的还原性,以及精细的懒散装入代码.
-   [微缩](https://github.com/BuilderIO/mitosis): 写部件一次, 到处跑. 编译为Vue,React,Solid,Angular,Svelte等.
-   [构建器](https://github.com/BuilderIO/builder):拖放页面构建器和CMS用于回放,Vue,Angular等.

  
  

[![Made with love by Builder.io](https://user-images.githubusercontent.com/844291/230786555-a58479e4-75f3-4222-a6eb-74c5af953eac.png)](https://www.builder.io/m/developers)

## 常见问题

### @builder\.io/partytown 是什么？

将资源密集型第三方脚本从主线上移出并转入网络工人\.注意：该包已被作者标记为弃用——Use @qwik\.dev/partytown instead

### 如何安装 @builder\.io/partytown？

在项目目录运行 npm install @builder\.io/partytown，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 partytown，可以用 npx partytown 直接运行。

### @builder\.io/partytown 支持 TypeScript 吗？

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

### @builder\.io/partytown 支持 ESM 还是 CommonJS？

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

### @builder\.io/partytown 需要什么版本的 Node\.js？

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

### @builder\.io/partytown 可以商用吗？

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

### @builder\.io/partytown 的下载量有多少？

根据 npm 官方下载统计，@builder\.io/partytown 在 2026/10/09 – 2026/11/07 这 30 天内被下载 914,934 次，日均约 30,498 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @builder\.io/partytown 还在维护吗？

最新版本 0\.10\.3 发布于 2024/12/21（1\.9 年前）；至今共发布 81 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/09/14。作者已将其标记为弃用，新项目建议寻找替代方案。