# @aphrody/bun-plugin-svelte 中文文档

规范地址：https://npmcn.com/package/%40aphrody/bun-plugin-svelte/

版本：1\.4\.7
npm 元数据更新时间：2026-10-23T02:17:52.127Z
中文译文更新时间：2026-11-07T06:39:13.755Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40aphrody/bun-plugin-svelte
原文对照：https://npmcn.com/package/%40aphrody/bun-plugin-svelte/?lang=original
项目主页：https://bun.com/
源码仓库：https://github.com/oven-sh/bun

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

- 包体积（解压后）：12.9 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：svelte ^5
- 首次发布：2026-10-08T20:54:50.839Z
- 最新版本发布：2026-10-23T02:17:51.890Z
- 近 30 天下载量：2030（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

Bun 的官方 Svelte 插件

## 安装

```sh
npm install @aphrody/bun-plugin-svelte
```

也可以使用：`pnpm add @aphrody/bun-plugin-svelte`、`yarn add @aphrody/bun-plugin-svelte`、`bun add @aphrody/bun-plugin-svelte`

## README

[![Logo](https://github.com/user-attachments/assets/50282090-adfd-4ddb-9e27-c30753c6b161)](https://bun.com/)

# `@aphrody/bun-plugin-svelte`

官员 [丝绒](https://svelte.dev/) 用于 [阿宝](https://bun.com/)。 。 。 .

## 安装

```sh
$ bun add -D @aphrody/bun-plugin-svelte
```

## Dev 服务器使用

`@aphrody/bun-plugin-svelte` 与 Bun 组合 [Fullstack Dev 服务器](https://bun.com/docs/bundler/fullstack),给你 HMR在开发您的 Svelte 应用程序时.

从注册开始 [bunfig.toml 页面存档备份,存于互联网档案馆](https://bun.com/docs/runtime/bunfig)数字 :

```toml
[serve.static]
plugins = ["@aphrody/bun-plugin-svelte"]
```

然后启动您的 Dev 服务器 :

```
$ bun index.html
```

见 [实例](https://github.com/oven-sh/bun/tree/main/packages/bun-plugin-svelte/example) 一个完整的例子.

## Bundler 用户

`@aphrody/bun-plugin-svelte` 让您用 [`Bun.build`](https://bun.com/docs/bundler)。 。 。 .

```ts
// build.ts
// to use: bun run build.ts
import { SveltePlugin } from "@aphrody/bun-plugin-svelte"; // NOTE: not published to npm yet

Bun.build({
  entrypoints: ["src/index.ts"],
  outdir: "dist",
  target: "browser",
  sourcemap: true, // sourcemaps not yet supported
  plugins: [
    SveltePlugin({
      development: true, // turn off for prod builds. Defaults to false
    }),
  ],
});
```

## 服务器系统使用

`@aphrody/bun-plugin-svelte` 尚不支持服务器端的导入(例如用于SSR). 不久后将增加这一点.

## 未获得支持

近期将增加对这些特征的支持

-   服务器端进口/移交
-   原始地图
-   CSS 扩展( 如尾风) 入 `<style>` 块
-   TypeScript特定特性(如enums和取名空间). 如果你在用的话 TypeScript 5.8 考虑启用 [`--erasableSyntaxOnly`](https://devblogs.microsoft.com/typescript/announcing-typescript-5-8-beta/#the---erasablesyntaxonly-option)

## 常见问题

### @aphrody/bun-plugin-svelte 是什么？

Bun 的官方 Svelte 插件

### 如何安装 @aphrody/bun-plugin-svelte？

在项目目录运行 npm install @aphrody/bun-plugin-svelte，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：svelte（^5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aphrody/bun-plugin-svelte 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aphrody\_\_bun-plugin-svelte 是否存在。

### @aphrody/bun-plugin-svelte 支持 ESM 还是 CommonJS？

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

### @aphrody/bun-plugin-svelte 可以商用吗？

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

### @aphrody/bun-plugin-svelte 的下载量有多少？

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

### @aphrody/bun-plugin-svelte 还在维护吗？

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