# @better-auth-ui/heroui 中文文档 规范地址：https://npmcn.com/package/%40better-auth-ui/heroui/ 版本：1\.7\.33 npm 元数据更新时间：2026-11-03T18:04:04.139Z 中文译文更新时间：2026-11-07T23:57:27.186Z 软件包许可：未声明 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40better-auth-ui/heroui 原文对照：https://npmcn.com/package/%40better-auth-ui/heroui/?lang=original 项目主页：https://github.com/better-auth-ui/better-auth-ui#readme 源码仓库：https://github.com/better-auth-ui/better-auth-ui ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.8 MB，489 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：0 个 - peer 依赖：react \>=19\.2\.6，bowser \>=2\.11\.0，react-dom \>=19\.2\.6，better-auth \>=1\.7\.0，@heroui/react \>=3\.2\.1，@heroui/styles \>=3\.2\.1，@gravity-ui/icons \>=2\.20\.0，@better-auth-ui/core \*，@tanstack/react-form \>=1\.33\.5 \<2，@better-auth-ui/react \*，@tanstack/react-pacer \>=0\.22\.1，@tanstack/react-query \>=5\.101\.2，@tanstack/react-store \>=0\.11\.1，@tanstack/react-table \>=9\.2\.4 \<10，@internationalized/date \>=3\.12\.2 - 首次发布：2026-04-15T21:09:50.924Z - 最新版本发布：2026-11-03T18:04:03.763Z - 近 30 天下载量：18170（2026-10-08 至 2026-11-06，npm 官方下载统计） - 已发布版本数：80（近 12 个月 80 个） ## 中文简介 认证组件和数据工具 [更好的认证](https://better-auth.com/),用于反应和固态. ## 安装 ```sh npm install @better-auth-ui/heroui ``` 也可以使用：`pnpm add @better-auth-ui/heroui`、`yarn add @better-auth-ui/heroui`、`bun add @better-auth-ui/heroui` ## README # 更好的授权 UI 认证组件和数据工具 [更好的认证](https://better-auth.com/),用于反应和固态. [文档](https://better-auth-ui.com/docs) • 妇女 [演示](https://demo.better-auth-ui.com/) • 妇女 [解析器](https://better-auth-ui.com/discord) 更好的Auth UI提供完整的认证流量,账户设置,插件集成,以及可再用的数据API. 选择适合您的应用程序的用户界面 : - **阴影/ ui** 提供复制到项目中的反射组件. - **英雄们** 提供由HeroUI v3所构建的被包式反应组件. - **Zaidan 固体** 提供您复制到工程中的固态组件. - **反应和固件包** 为自定义接口提供钩、查询、变异和服务器帮助. ## 特征 - 登录、注册、电子邮件核查和密码恢复流程 - 用户配置、账户设置、会话管理和安全控制 - 整合更好的 Auth 插件, 如组织、 密码、 二要素认证、 魔法链接和 API 密钥 - 反应和固态的查询和变异 API - 服务器发送助手和自定义的电子邮件模板 - 完全控制复制组件代码的浅暗主题 ## 预览 ### 阴影/ ui ![Better Auth UI sign-in form built with shadcn/ui](https://npmcn.com/package/%40better-auth-ui/heroui/apps/docs/public/screenshots/shadcn-sign-in-light.png) ### 英雄们 ![Better Auth UI sign-in form built with HeroUI](https://npmcn.com/package/%40better-auth-ui/heroui/apps/docs/public/screenshots/heroui-sign-in-light.png) ## 快开始 安装 [更好的认证](https://www.better-auth.com/docs/installation)。然后在添加UI软件包之前为您的应用程序配置它. ### 阴影/ ui 将认证组件添加到已存在的 shadcn/ ui 工程中 : ```bash bunx --bun shadcn@latest add @better-auth-ui/auth ``` 读取 [shadcn/ui 快速启动](https://better-auth-ui.com/docs/shadcn) 用于框架设置和可选组件. ### 英雄们 安装 HeroUI 软件包及其更好的 Auth UI 依赖性 : ```bash bun add @better-auth-ui/heroui@latest @better-auth-ui/react@latest @better-auth-ui/core@latest ``` 导入您全局 CSS 文件的组件样式 : ```css @import "@better-auth-ui/heroui/styles"; ``` 读取 [英雄快开始](https://better-auth-ui.com/docs/heroui) 用于提供商和框架设置. ### Zaidan 固体 安装 Solid 数据层及其运行时间依赖性 : ```bash bun add @better-auth-ui/solid @tanstack/solid-query better-auth solid-js ``` 然后添加 Solid 登记册的认证组件 : ```bash bunx --bun shadcn@latest add https://better-auth-ui.com/r/solid/auth.json ``` 读取 [赛丹 快速开始](https://better-auth-ui.com/docs/zaidan) 为 TanStack 启动设置和可选组件. ## 软件包参考 | 软件包 | 目的 | | --- | --- | | `@better-auth-ui/core` | 共享查询选项、服务器助手、类型和框架独立工具 | | `@better-auth-ui/react` | 反应提供者、钩子、查询、变异和插件 API | | `@better-auth-ui/heroui` | 用"英雄UI"制造的 React 组件 | | `@better-auth-ui/solid` | 固态提供者、钩子、查询、突变和插件 API | | `@better-auth-ui/locales` | 本地化捆绑、语言匹配助手和本地化技能 | 见 [反应引用](https://better-auth-ui.com/docs/react) 或者说 [实心参考](https://better-auth-ui.com/docs/solid) 当您需要低级API时. ## 代理技能 Better Auth UI通过TanStack Intent和TanStack 发布同样的代理技能 [技术。sh](https://skills.sh/)。 。 。 . 对于 GitHub 安装,请选择您的应用程序的技能 : ```bash bunx skills@latest add better-auth-ui/better-auth-ui --full-depth --skill better-auth-ui-react ``` 技能涵盖React/shadcn,Solid/Zaidan,HeroUI,核心数据API,以及本地化. TanStack Intent从已安装的 npm 包装入它们. 读取 [代理技能指南](https://better-auth-ui.com/docs/agent-skills) 用于安装路径及其版本行为. ## 发展 此寄存器使用 [阿宝](https://bun.sh/) 财务报告和审定财务报表 [无](https://nx.dev/)。 。 。 . 安装工作空间依赖性 : ```bash bun install ``` 启动发展项目: ```bash bun run dev ``` 运行主要的工作空间任务 : ```bash bun run build bun run test ``` ## 社区 请加入 [更好的授权 UI Discord](https://better-auth-ui.com/discord) 询问问题,分享反馈,并与贡献者建立联系. ## 许可证 用户界面 [MIT 许可证](https://npmcn.com/package/%40better-auth-ui/heroui/LICENSE)。 。 。 . ## 捐助和支助 读取 [贡献指南](https://npmcn.com/package/%40better-auth-ui/heroui/CONTRIBUTING.md) 促进发展和审查. 使用 [辅助指南](https://npmcn.com/package/%40better-auth-ui/heroui/SUPPORT.md) 用于提问和发行路线. ## 常见问题 ### @better-auth-ui/heroui 是什么？ 认证组件和数据工具 更好的认证,用于反应和固态\. ### 如何安装 @better-auth-ui/heroui？ 在项目目录运行 npm install @better-auth-ui/heroui，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=19\.2\.6）、bowser（\>=2\.11\.0）、react-dom（\>=19\.2\.6）、better-auth（\>=1\.7\.0）、@heroui/react（\>=3\.2\.1）、@heroui/styles（\>=3\.2\.1）、@gravity-ui/icons（\>=2\.20\.0）、@better-auth-ui/core（\*）、@tanstack/react-form（\>=1\.33\.5 \<2）、@better-auth-ui/react（\*）、@tanstack/react-pacer（\>=0\.22\.1）、@tanstack/react-query（\>=5\.101\.2）、@tanstack/react-store（\>=0\.11\.1）、@tanstack/react-table（\>=9\.2\.4 \<10）、@internationalized/date（\>=3\.12\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @better-auth-ui/heroui 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @better-auth-ui/heroui 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @better-auth-ui/heroui 可以商用吗？ @better-auth-ui/heroui 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。 ### @better-auth-ui/heroui 的下载量有多少？ 根据 npm 官方下载统计，@better-auth-ui/heroui 在 2026/10/08 – 2026/11/06 这 30 天内被下载 18,170 次，日均约 606 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @better-auth-ui/heroui 还在维护吗？ 最新版本 1\.7\.33 发布于 2026/11/04（4 天前）；至今共发布 80 个版本，其中过去 12 个月发布了 80 个；首次发布于 2026/04/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。