@buoy-gg/vue

中文文档
7.0.87发布于 2026/11/07TypeScriptES Module近 30 天下载 2358

在 Vue 或 Nuxt 应用程序中运行 Buoy .

中文使用文档
文档目录6 节
  1. 安装并签名
  2. 在Vue 设置
  3. 在 Nuxt 中设置
  4. 选项
  5. 皮尼亚和裁判员
  6. 入境点

Vue 和 Nuxt 的缓冲

Buoy在Vue 3.3和上行,由Vite所建,为β. 它在Nuxt 4也运行. 你的应用程序都保留下来了. Buoy将React用于自己的屏幕并带去. 整个指南是 Vue 页面。 。 。 .

安装并签名

从您的应用程序文件夹中运行这些 :

npm install --save-dev @buoy-gg/core @buoy-gg/vue @buoy-gg/network
npx --package=@buoy-gg/core buoy login

以同样的方式增加更多的工具. 对所有Buoy包使用相同的版本. buoy login 写入 VITE_BUOY_KEY 到文件 Git 忽略.

在Vue 设置

添加 Vite 插件 :

// vite.config.ts
import vue from '@vitejs/plugin-vue';
import { buoy } from '@buoy-gg/core/vite';

export default defineConfig({ plugins: [vue(), buoy()] });

添加Buoy插件到您的应用程序中 :

import { buoy } from '@buoy-gg/vue';

createApp(App).use(router).use(pinia).use(buoy).mount('#app');

就这样. Vite 插件会找到您的工具并添加早期的钩子 . 它让Buoy离开活生生的建筑. app.use(buoy) 读取您的密钥,并在应用程序挂起时启动 Buoy . 它自己发现了Vue路由器,Pinia和Vue Query. 它阻止了Buoy 当你的应用卸载.

在 Nuxt 中设置

// nuxt.config.ts
export default defineNuxtConfig({ modules: ['@buoy-gg/vue/nuxt'] });

就这样. 带入选项 buoy 键,作为简单数据. 对于有功能的选项,设置 buoy: { setup: false }。 。 。 . 那就打电话 nuxtApp.vueApp.use(buoy, options) 在您的客户端插件中.

选项

app.use(buoy, options) 选择与 mountBuoy 从 @buoy-gg/core/web,加上这些:

选项它会做什么
load用Buoy装入应用程序设置 。 使用 dev 检查以删除文件
modules您自己的工具列表, 替换插件
enableInRelease开始Buoy的发行建筑。 设定 buoy({ enableInRelease: true }) 还有
onMountBuoy一起来就叫停机功能
onDestroyBuoy停站时打电话

startBuoy(options) 启动 Buoy 没有 Vue 应用程序 . 过 router, (中文(简体) ), pinia 财务报告和审定财务报表 queryClient 你自己来.

皮尼亚和裁判员

Pinia在Zustand工具中独家存储展出. 显示平地 ref 或者说 reactive,包起来:

import { buoyVueRef } from '@buoy-gg/vue/pinia';

app.use(buoy, { zustandStores: { count: buoyVueRef(count) } });

您可以在工具中读取并编辑它们. 编辑保存您没有更改的字段 .

入境点

导入持有
@buoy-gg/vuebuoy, (中文(简体) ), startBuoy
@buoy-gg/vue/register早钩子. Vite 插件为您添加
@buoy-gg/vue/routerconnectBuoyRouter,用于手动路由器链接
@buoy-gg/vue/piniawatchPiniaStores, (中文(简体) ), buoyVueRef
@buoy-gg/vue/highlightsconnectBuoyHighlights,用于手举高亮
@buoy-gg/vue/nuxtNuxt 模块

每个应用程序条目都有 buoy-disabled 建造它什么也做不了. Vite 插件选中它为 prod 构建 .

版本与发布记录

@buoy-gg/vue 共发布 14 个版本,首次发布于 2026/10/22;过去 12 个月发布了 14 个版本。

版本发布日期距今
7.0.87latest2026/11/071 天前
7.0.862026/11/062 天前
7.0.852026/11/053 天前
7.0.842026/11/035 天前
7.0.832026/11/035 天前
7.0.822026/11/036 天前

关于 @buoy-gg/vue 的常见问题

@buoy-gg/vue 是什么?

在 Vue 或 Nuxt 应用程序中运行 Buoy .

如何安装 @buoy-gg/vue?

在项目目录运行 npm install @buoy-gg/vue,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vue(>=3.3 <4)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@buoy-gg/vue 支持 TypeScript 吗?

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

@buoy-gg/vue 支持 ESM 还是 CommonJS?

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

@buoy-gg/vue 可以商用吗?

@buoy-gg/vue 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@buoy-gg/vue 的下载量有多少?

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

@buoy-gg/vue 还在维护吗?

最新版本 7.0.87 发布于 2026/11/07(1 天前);至今共发布 14 个版本,其中过去 12 个月发布了 14 个;首次发布于 2026/10/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。