HeroUI v3 正式发布，针对 React 和 React Native 从头进行了重写，并基于 Tailwind CSS v4 构建

HeroUI（前身为 NextUI）是一款 React 组件库，现已发布 v3 版本。该版本经过彻底重写，开发团队将其定位为适用于 Web 和原生应用的统一设计系统。2026 年 3 月发布的版本包含超过 75 个 Web 组件（其中 21 个为新增组件），同时提供了从零构建的全新 React Native 库，内含 37 个组件。

架构与样式体系

HeroUI v3 的核心技术选型值得关注：

• 无障碍基础：基于 React Aria Components 实现，确保键盘导航、屏幕阅读器等 a11y 能力开箱即用。
• 样式引擎：采用 Tailwind CSS v4 进行样式设计，同时提供 CSS 变量、OKLCH 颜色空间和 BEM 修饰符以支持深度自定义。OKLCH 颜色空间的引入使得色彩在感知均匀性上更优，便于生成一致的色阶。
• 动画去 JS 化：所有动画均已迁移至纯 CSS，不再需要 JavaScript 运行时支持，减少了运行时开销。
• API 模式：采用复合组件 API（Compound Component API），摒弃了旧版的 provider 包装器模式，降低了组件树嵌套深度。
• 兼容性：完美兼容 React 19 和 Next.js。

AI 辅助开发工具链

这次重写大量采用 AI 辅助开发，并构建了完整的 AI 工具链：

• MCP 服务器：提供 Model Context Protocol 服务，使编码助手能直接读取组件文档。
• Agent Skills：为 AI 代理提供组件使用技能。
• llms.txt：标准化的文档入口文件，便于 LLM 摄取组件 API 文档。
• Figma Kit v3：与组件完全一致的设计资源。

npm 与 GitHub 数据

• 核心包 @heroui/react 每周下载量约 341,000 次。
• 独立的 heroui-native 包每周新增下载量约 11,000 次。
• GitHub 星标数接近 27,700 个。

版本迭代

自 3.0 以来，该组件库已发布多个小版本：

• v3.0.3：将 React Aria Components 升级至 1.17.0；为加快安装速度移除了约 90% 的传递依赖项（transitive dependencies）；新增排版组件。
• v3.1.0（5 月下旬）：新增中文文档，扩展柔和色彩 Token，引入可共享的主题滚动条系统，修复 useTheme 的 SSR 问题。
• v3.2.0（2026 年 6 月 16 日）：当前主线版本，官方承诺按月发布小版本。

社区反馈与迁移注意

在 Reddit 上，一位 NextUI v2 长期用户发帖称赞了主题页面和文档，但遗憾表示 v3 中输入标签动画、预置单元和自动补全三项功能"全都不见了"。在 GitHub 上，开发者针对路线图及导航栏（Navbar）等缺失功能提出质疑，有评论者指出"项目时间表确实缺乏透明度"。

迁移要点：v2 和 v3 无法在同一项目中共存。官方迁移指南提供全量迁移和增量迁移两种路径，并由专用的迁移 MCP 服务器提供支持。部分组件（如 Image）已被完全移除，转而使用原生元素替代。

项目背景

HeroUI 由 Junior García 创建，获得 Y Combinator 支持，是可用于生产环境的开源 React 和 React Native 组件库，遵循 Apache 2.0 许可。完整发布说明可在 GitHub 上查阅。