v3.2.1
补丁版本：将 react-aria 从 @heroui/react 产物中外部化，并修复 SwitchGroup 横向布局。
2026 年 6 月 17 日
补丁版本：@heroui/react 不再内置自己的 react-aria 副本。react-aria 的子路径现在在 Rollup 构建中被外部化，因此会解析到你项目中安装的版本 —— 避免在 @heroui/react 内部打包出一份重复、内联的 react-aria 副本。本次发布还修复了 SwitchGroup 横向布局，补全缺失的 switch-group__items 包装层。
安装
升级到最新版本：
npm
```bash
npm i @heroui/styles@latest @heroui/react@latest
```
pnpm
```bash
pnpm add @heroui/styles@latest @heroui/react@latest
```
yarn
```bash
yarn add @heroui/styles@latest @heroui/react@latest
```
bun
```bash
bun add @heroui/styles@latest @heroui/react@latest
```
正在使用 AI 助手？ 对它说「Hey Cursor，把 HeroUI 升级到最新版本」。它会自动对比版本并应用必要变更。了解更多请参阅 HeroUI MCP 服务器。
错误修复
- @heroui/react：将
react-aria子路径与其他@react-*和react-aria-components一起在 Rollup 构建中外部化，使@heroui/react不再内置自己的react-aria副本。消费方现在会解析到项目中安装的单一react-aria，避免重复实例的问题以及不必要的产物体积膨胀 (#6653)。 - SwitchGroup：补全缺失的
switch-group__items包装层，使orientation="horizontal"时开关横向排列，而不再垂直堆叠 (#6655)。
链接
贡献者
感谢所有为本次发布做出贡献的人！
本地来源: vendor/zh/react/releases/v3-2-1.mdx
文档根据 HeroUI v3 固定提交生成，已调整内部链接与交互预览以适配 JGuang。
v3.2.0v3.2.0
Calendar week/day views and year picker on React Aria 1.18, plus breaking Radio, Checkbox, and Switch composition changes.基于 React Aria 1.18 的 Calendar 周/日视图与年份选择器，以及 Radio、Checkbox、Switch 的破坏性组合方式变更。
v3.2.2v3.2.2
Patch release that upgrades React Aria to 1.19.0, adds overflow scrolling to Tabs.ListContainer, and fixes accidental form submission from clear/close buttons and overflow scroll from visually hidden inputs.补丁版本：将 React Aria 升级到 1.19.0，为 Tabs.ListContainer 添加溢出滚动，并修复清除/关闭按钮意外提交表单以及视觉隐藏输入框导致溢出滚动的问题。