# @brillout/vite-plugin-server-entry 中文文档 规范地址：https://npmcn.com/package/%40brillout/vite-plugin-server-entry/ 版本：0\.7\.24 npm 元数据更新时间：2026-11-02T10:23:38.957Z 中文译文更新时间：2026-11-08T15:31:39.352Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40brillout/vite-plugin-server-entry 原文对照：https://npmcn.com/package/%40brillout/vite-plugin-server-entry/?lang=original 项目主页：https://github.com/brillout/vite-plugin-server-entry#readme 源码仓库：https://github.com/brillout/vite-plugin-server-entry ## 关键信息（来自 npm 元数据） - 包体积（解压后）：65.4 kB，70 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - 运行依赖：2 个 - 首次发布：2024-01-07T17:06:41.248Z - 最新版本发布：2026-11-02T10:23:38.810Z - 近 30 天下载量：466884（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：125（近 12 个月 20 个） ## 中文简介 - [这是什么?](https://npmcn.com/package/%40brillout/vite-plugin-server-entry/#description-what-is-this) - 说吧 [手动导入](https://npmcn.com/package/%40brillout/vite-plugin-server-entry/#description-manual-import) - 学习更多(图书馆作者) - [如何运作](https://npmcn.com/package/%40brillout/vite-plugin-server-entry/#description-how-it-works) - 说吧 [何时使用](https://npmcn.com/package/%40brillout/vite-plugin-server-entry/#description-when-to-use-this) ## 安装 ```sh npm install @brillout/vite-plugin-server-entry ``` 也可以使用：`pnpm add @brillout/vite-plugin-server-entry`、`yarn add @brillout/vite-plugin-server-entry`、`bun add @brillout/vite-plugin-server-entry` ## README - [这是什么?](https://npmcn.com/package/%40brillout/vite-plugin-server-entry/#readme-what-is-this) - [手动导入](https://npmcn.com/package/%40brillout/vite-plugin-server-entry/#readme-manual-import) - 学习更多( 为图书馆作者) - [如何运作](https://npmcn.com/package/%40brillout/vite-plugin-server-entry/#readme-how-it-works) - [何时使用](https://npmcn.com/package/%40brillout/vite-plugin-server-entry/#readme-when-to-use-this) ## 这是什么? `@brillout/vite-plugin-server-entry` 做两件事: - 生成服务器生产条目 `dist/server/entry.js`。 。 。 . - 自动导入. [维琪](https://vike.dev/) 财务报告和审定财务报表 [电报](https://telefunc.com/) 以您的名义自动使用和配置此插件: 您没有什么可做的, 您通常可以忽略此插件 . ## 手动导入 通常的文件 `dist/server/entry.js` 自动导入. 但这种自动导入与Yarn PnP,一些多克配置,以及某些出品配置不相通. 你会继续得到以下错误: ``` [@brillout/vite-plugin-server-entry][Wrong Usage] The server production entry is missing. (Re-)build your app and try again. If you still get this error, then you need to manually import the server production entry. ``` 工作环路是手动导入 `dist/server/entry.js` 在服务器代码中 : ```js // server/index.js // Add this at the beginning of your server entry, or elsewhere at server start // before receiving HTTP requests. if (process.env.NODE_ENV === 'production') { await import('../dist/server/entry.js') // Or wherever the build directory is } // ... // Your server code (Express.js, Hono, Cloudflare Worker, Vercel, ...) // ... ``` > \[注\] 导入路径可能不同 : > > - 文件扩展名可能与 `.js` (例如:. `dist/server/entry.mjs`) (中文(简体) ). > - 构建目录的命名和位置可能不同于 `dist/` (例如:. `build/server/entry.js` 如果您或您的框架设置 [`vite.config.js` > 翻译: `build.outDir`](https://vitejs.dev/config/build-options.html#build-outdir) 改为 `build`) (中文(简体) ). > > ```diff > - import '../dist/server/entry.js > + import '../build/server/entry.mjs > ``` > \[注\] 如果顶级 `await` ,然后检查有条件导入的替代方法 `dist/server/entry.js` 仅生产 [有条件的手动导入](https://github.com/brillout/vite-plugin-server-entry/issues/6)。 。 。 . > \[注\] `@brillout/vite-plugin-server-entry` 生成文件 `node_modules/@brillout/vite-plugin-server-entry/dist/runtime/autoImporter.js`自动导入 `dist/server/entry.js`。 。 。 . > > 这个 `node_modules/.../autoImporter.js` 文件是在构建时生成的。 因此,如果: > > -  `node_modules/` 目录不可变 (Yarn PnP): `node_modules/.../autoImporter.js` 无法写入 . > - 删除或重新安装 `node_modules/` _之后_ 创建您的生产应用程序 : `node_modules/.../autoImporter.js` 丢失. > - 比如你在当地建造,复制 `dist/` ,然后运行 `$ npm install` 在这里. > - 移动一些嵌入器配置 `dist/`,然后重新安装 `node_modules/`。 。 。 . > > 在这种情况下,您必须手动导入服务器条目 . > > 如果你没有使用Yarn PnP,你没有修改 `node_modules/` 建成后,你不需要手动导入,你不应该继续得到 `The server production entry is missing`如果你这样做,那么 [提交错误报告](https://github.com/brillout/vite-plugin-server-entry/issues/new)。 。 。 . > > 要学更多,看 [如何运作](https://npmcn.com/package/%40brillout/vite-plugin-server-entry/#readme-how-it-works)。 。 。 . ## 如何运作 > \[注\] 作为一个用户,你通常不需要阅读这个. 如果你有问题,请读一下 [手动导入](https://npmcn.com/package/%40brillout/vite-plugin-server-entry/#readme-Manual-import) 通常已经足够了. `@brillout/vite-plugin-server-entry` 做两件事: - 生成 a _服务器生产条目_,文档 `dist/server/entry.js`。 。 。 . - 生成 a _自动导入器_,文档 `node_modules/@brillout/vite-plugin-server-entry/dist/runtime/autoImporter.js`。 。 。 . 这个 _服务器生产条目_ (单位:千美元)`dist/server/entry.js`) 使工具能够像 [维琪](https://vike.dev/) 财务报告和审定财务报表 [电报](https://telefunc.com/) 将其生产条目合并为一个文件. 这个 _自动导入器_ 文件( 编号`node_modules/@brillout/vite-plugin-server-entry/dist/runtime/autoImporter.js`自动导入 `dist/server/entry.js`,但需要手动操作: ```js // server/index.js // Without the auto importer, you need to manually import dist/server/entry.js if (process.env.NODE_ENV === 'production') { await import('../dist/server/entry.js') } ``` > \[注\] 这个 `autoImporter.js` 文件在内部生成 `node_modules/` ——不在构建目录中(`dist/`)——因为汽车进口商的整点是知道建设目录在哪里. 工具的运行时代码( 如 Telefunc) 生活在 `node_modules/` 无法知道构建目录的位置 。 汽车进口商以尽可能简单和最小的方式弥合这一缺口. 见 [汽车进口商如何运作](https://github.com/brillout/vite-plugin-server-entry/issues/4) 更多信息. ## 何时使用 典型的使用例 `@brillout/vite-plugin-server-entry` 当服务器条目不是由Vite处理时. 例如,在下文中,维克用Vite没有经过处理的vanilla Node.js服务器: - [维凯 > API > `renderPage()` > 无 `+serverEntry.js`](https://vike.dev/renderPage#without-serverentry-js) - [维凯 > 整合 > `+server` > 额外控制 > `+serverEntry.js` => `$ node server/index.js`](https://vike.dev/server#serverentry-js-node-server-index-js) > \[注\] 这里的根本问题是用户的 `server/index.js` (未由Vite处理) 无法神奇地加载维克的Vite入道,也无法将Telefunc等工具的Vite入道——香草节点.js服务器需要以某种方式从Vite入道. 当Vite 处理服务器条目时 `@brillout/vite-plugin-server-entry` 毫无用处:使用Vite虚拟模块就更简单了,而且从根本上更可靠. > \[注\] 另一个特征是 `@brillout/vite-plugin-server-entry` 即将各种工具的条目(如维克的条目和Telefunc的条目)捆绑在一个条目中. > > 理想的情况是,今后(见 [`vitejs/ecosystem#19` - 服务器输入注入](https://github.com/vitejs/ecosystem/issues/19)),Vite 本地支持,而不是需要这样的工具 `@brillout/vite-plugin-server-entry`. (这里的根本问题是:像Telefunc这样的工具如何将其条目注入维克或斯维尔特基特等Vite框架定义的服务器条目?) > > 从短期来看,这可能是使用 `@brillout/vite-plugin-server-entry` 尽管我们鼓励只用Vite来寻找一个更简单的解决方案(同时取消Vite团队来解决这个问题). ## 常见问题 ### @brillout/vite-plugin-server-entry 是什么？ 这是什么? - 说吧 手动导入 - 学习更多\(图书馆作者\) - 如何运作 - 说吧 何时使用 ### 如何安装 @brillout/vite-plugin-server-entry？ 在项目目录运行 npm install @brillout/vite-plugin-server-entry，或使用 pnpm add / yarn add / bun add。 ### @brillout/vite-plugin-server-entry 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/brillout\_\_vite-plugin-server-entry 是否存在。 ### @brillout/vite-plugin-server-entry 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @brillout/vite-plugin-server-entry 可以商用吗？ @brillout/vite-plugin-server-entry 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @brillout/vite-plugin-server-entry 的下载量有多少？ 根据 npm 官方下载统计，@brillout/vite-plugin-server-entry 在 2026/10/09 – 2026/11/07 这 30 天内被下载 466,884 次，日均约 15,563 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @brillout/vite-plugin-server-entry 还在维护吗？ 最新版本 0\.7\.24 发布于 2026/11/02（6 天前）；至今共发布 125 个版本，其中过去 12 个月发布了 20 个；首次发布于 2024/01/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。