---
title: "Liquid Glass React 库横向对比（2026）"
description: "Liquid Glass React 库对比：liquid-glass-react、@samasante/liquid-glass 和 WebGL 方案的渲染方式、浏览器支持和选法。"
url: https://liquidglassdesign.com/zh/blog/liquid-glass-react-libraries
language: zh-Hans
published: 2026-11-18
updated: 2026-11-20
author: "Liquid Glass Design"
tags: ["Web 前端","代码"]
translations:
  en: https://liquidglassdesign.com/blog/liquid-glass-react-libraries.md
  zh-Hant: https://liquidglassdesign.com/zh-TW/blog/liquid-glass-react-libraries.md
  ja: https://liquidglassdesign.com/ja/blog/liquid-glass-react-libraries.md
  hi: https://liquidglassdesign.com/hi/blog/liquid-glass-react-libraries.md
---

# Liquid Glass React 库横向对比（2026）

> Liquid Glass React 库对比：liquid-glass-react、@samasante/liquid-glass 和 WebGL 方案的渲染方式、浏览器支持和选法。

在 React 里做 Liquid Glass，主要是二选一。一个是下载量最大的玻璃组件 `liquid-glass-react`，它只在 Chromium 里扭曲背景；另一个是较新的 headless 透镜 `@samasante/liquid-glass`，只要你把要扭曲的内容交给它，它在 Chrome、Safari 和 Firefox 里都能折射。其余几个分别是第一个库的 fork、基于截图工作的 WebGL 渲染器，以及一个做液态形变的库，后者根本算不上玻璃。

下面所有数字都取自 2026 年 11 月 14 日的 npm、GitHub 和 Bundlephobia。「下载量」指截至当天前 30 天的 npm 下载量。

## 这些库怎么做出玻璃

一共三种技术，浏览器支持上的差别几乎都能用它们解释。

1. 用 SVG 位移滤镜读取元素后面的页面（`backdrop-filter: url()`，或者在 `backdrop-filter` 模糊上面再叠一个 `filter: url()`）。这种方式扭曲的是实时内容，但只有 Chromium 画得出来。Safari 和 Firefox 会退回到普通的平面模糊。
2. 用 `filter: url()` 把 SVG 位移滤镜作用到组件自己持有的内容上。它从不读取 backdrop，所以三个引擎都能用。问题在于，组件手里必须有一份它要扭曲的内容的副本。
3. 用 WebGL shader 在截图或 canvas 上绘制。视觉上非常灵活，但从 DOM 栅格化出来的东西就是一张静态图，除非你重新截取。

想看这些包底下包的是什么，我们的 [CSS 和 SVG Liquid Glass 教程](https://liquidglassdesign.com/zh/blog/liquid-glass-css-svg)用纯代码演示了前两种。

## 各个 Liquid Glass React 库

### liquid-glass-react

Max Rovensky 的 [Liquid Glass React](https://liquidglassdesign.com/resources/liquid-glass-react)（GitHub 上是 `rdev/liquid-glass-react`）是大多数人最先找到的那个。它在 GitHub 上大约有 6,700 颗星，最近 30 天 npm 下载量约 152,000。

- 它用的是第 1 种技术。组件在 `backdrop-filter` 模糊之上用 `filter: url()` 套一个 SVG `feDisplacementMap` 滤镜，做三次位移来模拟色差，在 Firefox 里则完全跳过 SVG 滤镜。README 里写着 Safari 和 Firefox「只部分支持这个效果（看不到位移）」（only partially support the effect (displacement will not be visible)）。
- props 包括 `displacementScale`、`blurAmount`、`saturation`、`aberrationIntensity`、`elasticity` 和 `cornerRadius`，还有 `mode`（"standard"、"polar"、"prominent" 或 "shader"）。README 说 shader 模式「最准确，但不是最稳定的」（the most accurate but not the most stable）。
- 版本 1.1.1，MIT 许可证，peer dependency 要求 React 19 或更新。Bundlephobia 测得 gzip 后约 33 KB。
- 最近一次提交和发布都在 2025 年 6 月。目前有 25 个未关闭的 issue 和 pull request，其中 issue #20 提到：组件总会加上 `translate(-50%, -50%)` 居中，导致它很难放进普通布局里。

它适合 Chromium 用户为主的受众，或者落地页、demo 这类以跟随鼠标的弹性效果为卖点的场景。如果是必须在 iPhone 上也显示正常的生产环境 UI，看下一个包。

`@nkzw/liquid-glass` 是它的一个 fork，「修了样式问题和 TypeScript 包的问题，并做了一些简化」（with styling fixes, TypeScript package fixes, and some simplifications）。它支持 React 18 或更新。它的最近一次发布（1.3.0）也在 2025 年 6 月，渲染思路和浏览器方面的说明都一样。

### @samasante/liquid-glass

Sam Asante 的这个包在我们的资源页上叫 [Real liquid glass for the web](https://liquidglassdesign.com/resources/real-liquid-glass-for-the-web)。它是一个 headless 的 `<Glass>` 组件：盒子的样式用你自己的 CSS 或 Tailwind 写，组件负责把它变成这种材质。

- 它用第 2 种技术，第 1 种作为可选项。用它包住一个写好样式的盒子，在所有浏览器里都会加上磨砂、染色和边缘高光；扭曲后面的实时页面则只在 Chrome 和 Edge 里生效，因为这条路径需要 `backdrop-filter: url()`。要在 Safari 和 Firefox 里也扭曲，有两个办法：让透镜折射它自己的子元素（给它 `size` 和 `center`），或者传入 `refract={<img src="/photo.jpg" />}`，让它扭曲后面内容的一份副本。
- 遇到 `<video>` 和 `<canvas>` 时它会切换到 WebGL，因为 Safari 不会对实时视频应用 SVG 滤镜。
- 它的 `BROWSERS.md` 记录了 Safari 的绕法：WebKit 里不做超采样，只在形状变化时重新生成贴图，每次更新都换一个新的滤镜 ID，因为 WebKit 按 ID 缓存滤镜输出。
- 版本 0.1.1，发布于 2026 年 6 月 23 日，MIT 许可证，零运行时依赖，peer 要求 React 18 或更新。Bundlephobia 测得 gzip 后约 17 KB。最近 30 天下载量约 63,000，GitHub 上约 670 颗星。
- 仓库自 2026 年 6 月 23 日之后就没有新提交，那时距仓库创建大约才一个小时。所以依赖它之前，锁定版本号，并读一遍源码。

### Liqui 组件库（我们自己的项目）

[Liqui](https://liqui.design/?utm_source=liquidglassdesign.com&utm_medium=referral&utm_campaign=blog_react_libraries) 是我们自己的开源项目，看这一条时请把这点考虑进去。它是一套基于 Base UI 的组件，共 38 个（按钮、菜单、选择框、对话框、滑块、iOS 风格的标签栏，以及配套的表单控件），由 shadcn CLI 以源码形式写进你的仓库。唯一的 npm 依赖是折射内核 `@liqui-design/glass`。

- 它在 Chromium 里用第 1 种技术，在 Safari 和 Firefox 里用第 2 种：用 `LiquiBackdrop` 包住一块区域，页面本身无法折射时，里面的每个玻璃表面都会改为弯折这个背景的一份副本。没有已知背景的表面，或者 portal 到盒子外面的弹出层，会退回到磨砂，边缘高光保留。
- 位移贴图在 canvas 上只画一次，按尺寸和光学参数缓存；所有滤镜放在同一个共享的 SVG 注册表里，所以很多个相同的按钮只需要一张贴图。
- `@liqui-design/glass` 0.8.0 发布于 2026 年 11 月 17 日，MIT 许可证，peer 要求 React 18 或 19，组件还需要 Tailwind CSS v4。截至 11 月 18 日的 30 天里 npm 下载量约 5,000，GitHub 上约 170 颗星（2026 年 11 月 20 日核对）。
- 安装方法、标签栏和 Safari 方面的细节，见我们的 [React 版 Liquid Glass 组件指南](https://liquidglassdesign.com/zh/blog/liquid-glass-react-components)。

### WebGL 方案

`@specy/liquid-glass-react` 用 Three.js 渲染。它的 React API 有一个 `updateScreenshot()` 方法，也就是说玻璃显示的是页面的一张截图，刷新要你自己来。Bundlephobia 上它 gzip 后约 220 KB，最近一次发布（1.0.2）是 2025 年 6 月。放在静态背景上做 hero 视觉没问题，用在会变化的内容上方做 UI 就不太合适。

Charles Yin 的 [Liquid Glass Studio](https://liquidglassdesign.com/resources/liquid-glass-studio) 是一个 playground，算不上组件库：基于 WebGL2 和 WebGPU，MIT 许可证，控制项很细。仓库在 2026 年 9 月还有更新。想看 shader 能把这种外观推到什么程度，这里很合适；如果你的玻璃本来就浮在自己渲染的 canvas 场景上，也可以借用它的数学。

### liquid-gooey，负责形变的部分

Jakub Antalik 的 [Liquid Gooey](https://liquidglassdesign.com/resources/liquid-gooey) 不做透镜，只管这种外观里形变那一面：像液体一样合并、分裂的形状，提供「Morph」和「Move」两种效果。它在一层 SVG 剪影上画出黏稠的液态效果，你真实的 DOM 清晰地叠在上面。它的 README 说它只对 SVG 内容应用滤镜，从不在 HTML 上用 CSS `url()`，这就是它在 Safari 里也能正确显示的原因。版本 0.2.2，发布于 2026 年 9 月，MIT 许可证，peer 要求 React 18 或更新，gzip 后约 17 KB，最近 30 天下载量约 318,000。想让菜单从按钮里「冒」出来，就把它和一层基于模糊的玻璃表面搭配使用。

## 怎么选

1. 如果 iPhone 和 Safari 用户必须看到折射，用 `@samasante/liquid-glass`，让它折射元素自己的子元素，或者你传进去的副本。同时接受一点：在 Chromium 以外，浮在任意实时内容上的面板只会有磨砂效果，扭不出折射。
2. 如果你想在 shadcn/ui 和 Tailwind v4 上用一整套玻璃组件（菜单、选择框、对话框、标签栏），用我们的库 Liqui。放在 `LiquiBackdrop` 里时，它在 Safari 和 Firefox 中也能折射，放在外面就是磨砂效果。
3. 如果你的受众主要是桌面版 Chrome，又想要一个拿来就用、带鼠标弹性的组件，`liquid-glass-react` 可以。确保平面模糊的回退效果本身看起来是完成品，并为定位上的怪癖留出时间。
4. 如果你只需要几个按钮或一条导航栏，就别引入依赖了。我们教程里的滤镜和贴图生成器只有几十行，回退方案也由你自己掌控。
5. 如果玻璃下面是 canvas、3D 场景或视频，用 shader；视频的话也可以用 `@samasante/liquid-glass` 的 WebGL 模式。
6. 如果你真正想要的是合并和形变，用 `liquid-gooey`，玻璃本身保持简单。

Sanoj Sunny 的 [音量滑块概念设计](https://liquidglassdesign.com/gallery/liquid-glass-slider-concept%28volume%29) 很适合拿来测试这些库。一条透明的玻璃轨道压在照片上，音量值（52）是轨道里的第二个胶囊，旁边浮着一个圆形按钮。在 Safari 里复刻它，就得折射照片的一份副本：`@samasante/liquid-glass` 可以用 `refract` prop 做到，`liquid-glass-react` 做不到。

![透明玻璃音量滑块停在 52，旁边浮着一个圆形 AirPlay 样式按钮，背景是手握音箱的暗色照片](https://cdn.liquidglassdesign.com/gallery/296cd13d-8a84-8095-9a94-c13755eef388.webp)

*Liquid Glass - Slider Concept(Volume) by sanoj sunny。* [在图库中查看](https://liquidglassdesign.com/gallery/liquid-glass-slider-concept%28volume%29)
Roman Vasylovskyi 的 [Liquid glass navigation](https://liquidglassdesign.com/gallery/liquid-glass-navigation) 属于第 1 条里那种更难办的情况：网站页头浮在一张满幅沙丘照片上，山脊线在导航栏里明显弯折。如果下面是固定的 hero 图，可以把同一张照片交给 `@samasante/liquid-glass`。一旦页面在页头下面滚动，不管用哪个库，都只有 Chromium 能显示出弯折。

![玻璃导航栏里有链接和 Get Started 按钮，背后是深色沙丘，山脊线经过导航栏时被弯折](https://cdn.liquidglassdesign.com/gallery/22acd13d-8a84-80ef-8228-f1b3eeb5f2e1.webp)

*Liquid glass navigation by Roman Vasylovskyi。* [在图库中查看](https://liquidglassdesign.com/gallery/liquid-glass-navigation)
不管选哪个，[网页性能与回退指南](https://liquidglassdesign.com/zh/blog/liquid-glass-web-performance-fallbacks)都讲了 `prefers-reduced-transparency` 下的不透明回退，以及一个页面能承受多少层玻璃。

## Vue 里的 Liquid Glass

我们资源页上的 [Liquid Glass Vue](https://liquidglassdesign.com/resources/liquid-glass-vue) 项目是一个 Vue 3 加 Vite 的 demo，用 WebGL 渲染折射。它是个拿来学习的项目，没法当成包直接安装。GitHub 也没有在仓库里检测到许可证文件，所以把代码复制进商业产品之前，先问问作者。如果要组件，npm 上的 `liqvued`（MIT 许可证，版本 0.2.1，发布于 2026 年 7 月，要求 Vue 3.5 或更新）在 Chromium 里用 `backdrop-filter: url()`，按它文档的说法，在 Safari 和 Firefox 里会退回到模糊效果。

*版本、设置和数据核对于 2026 年 11 月 14 日。*

## 参考来源

- https://github.com/rdev/liquid-glass-react
- https://github.com/rdev/liquid-glass-react/blob/master/src/index.tsx
- https://github.com/rdev/liquid-glass-react/issues/20
- https://www.npmjs.com/package/liquid-glass-react
- https://github.com/nkzw-tech/liquid-glass
- https://github.com/samasante/liquid-glass
- https://liqui.design/docs/handbook/glass
- https://www.npmjs.com/package/@liqui-design/glass
- https://github.com/leefanv/liqui-design
- https://github.com/samasante/liquid-glass/blob/main/BROWSERS.md
- https://www.npmjs.com/package/@samasante/liquid-glass
- https://github.com/Specy/liquid-glass
- https://www.npmjs.com/package/@specy/liquid-glass-react
- https://github.com/iyinchao/liquid-glass-studio
- https://github.com/Jakubantalik/Libraries
- https://www.npmjs.com/package/liquid-gooey
- https://github.com/Muggleee/liquid-glass
- https://www.npmjs.com/package/liqvued
- https://ivoyt.github.io/liqvued/guide/browser-compatibility
- https://bundlephobia.com/package/liquid-glass-react
- https://api.npmjs.org/downloads/point/last-month/liquid-glass-react
