Skip to content

sync into main #1338

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
thinkasany merged 5 commits into from
Aug 8, 2025
Merged

sync into main #1338

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
b26cf69
docs(rolldown): update `plugin-react-oxc` mention (#20498)
sapphi-red Aug 7, 2025
a222fb4
docs(en): merging all conflicts
docschina-bot Aug 7, 2025
c9e964f
docs: update content
lxKylin Aug 8, 2025
604422d
Merge pull request #1337 from lxKylin/69f-1
thinkasany Aug 8, 2025
9c1b17a
Merge pull request #1336 from vitejs/sync-b26cf69f-1
thinkasany Aug 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions guide/rolldown.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -145,11 +145,17 @@ export default {

要测试它们，你可以在你的 Vite 配置中将 `experimental.enableNativePlugin` 选项设置为 `true`。

### `@vitejs/plugin-react-oxc` {#@vitejs/plugin-react-oxc}
### 利用 Oxc 的 React 刷新转换 {#Utilizing-Oxc's-React-refresh-transform}
Copy link
Collaborator

@waynzh waynzh Aug 8, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

可以随下次同步的时候改下

Suggested change
### 利用 Oxc 的 React 刷新转换 {#Utilizing-Oxc's-React-refresh-transform}
### 利用 Oxc 的 React 刷新转换 {#utilizing-oxc-s-react-refresh-transform}

Copy link
Collaborator Author

@thinkasany thinkasany Aug 8, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lxKylin 有一个小技巧：

下次你先临时用英文的锚点如 ### Utilizing Oxc's React refresh transform, 本地预览一下，选中

image


当使用 `@vitejs/plugin-react` 或 `@vitejs/plugin-react-swc` 时，你可以切换到 `@vitejs/plugin-react-oxc` 插件，它使用 Oxc 来实现 React 的快速刷新（Fast Refresh），取代原先的 Babel 或 SWC。该插件的设计目标是作为替代品无缝接入，同时提供更好的构建性能，并与 `rolldown-vite` 的底层架构保持一致。
`@vitejs/plugin-react` v5.0.0+ 版本使用 Oxc 的 React 刷新转换功能。如果你没有使用任何 Babel 插件（包括 React 编译器），现在整个转换过程将由 Oxc 完成，除了更新 `@vitejs/plugin-react` 外无需任何其他更改，就能提升构建性能。

请注意，只有在未使用任何 Babel 或 SWC 插件（包括 React 编译器）且未修改 SWC 选项的情况下，你才可以切换到 `@vitejs/plugin-react-oxc`。
如果你在使用 `@vitejs/plugin-react-swc` 时没有使用 SWC 插件和自定义 SWC 选项，你可以切换到 `@vitejs/plugin-react` 插件来利用 Oxc。

::: details `@vitejs/plugin-react-oxc` 插件已被弃用

此前，我们建议使用 `@vitejs/plugin-react-oxc` 来利用 Oxc 的 React 刷新转换功能。但是，我们已经将该实现合并到了 `@vitejs/plugin-react` 中，这样可以更轻松地切换到 `rolldown-vite`。`@vitejs/plugin-react-oxc` 现在已被弃用，将不再更新。

:::

### `withFilter` 包装器 {#withfilter-wrapper}

Expand Down