# @freenow/wave 中文文档
规范地址：https://npmcn.com/package/%40freenow/wave/
版本：2\.68\.1
npm 元数据更新时间：2026-11-11T14:29:52.148Z
中文译文更新时间：2026-11-15T14:28:25.735Z
软件包许可：Apache-2\.0
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40freenow/wave
原文对照：https://npmcn.com/package/%40freenow/wave/?lang=original
项目主页：https://github.com/freenowtech/wave#readme
源码仓库：https://github.com/freenowtech/wave
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：5.5 MB，2401 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：17 个
- peer 依赖：react ^18\.2\.0，react-dom ^18\.2\.0，styled-components \>4\.3
- 首次发布：2021-05-03T09:20:47.393Z
- 最新版本发布：2026-11-11T14:29:51.803Z
- 近 30 天下载量：2707（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：239（近 12 个月 29 个）
## 中文简介
为您的前端项目执行波浪设计系统
## 安装
```sh
npm install @freenow/wave
```
也可以使用：`pnpm add @freenow/wave`、`yarn add @freenow/wave`、`bun add @freenow/wave`
## README
# 挥手
[](https://github.com/freenowtech/wave/actions?query=workflow%3Alibrary) [](https://www.npmjs.com/package/@freenow/wave) [](https://npmcn.com/package/%40freenow/wave/#readme-contributors-)
## 文档
我们的文献网站住在 [https://wave.free-now.com/ 页面存档备份,存于互联网档案馆](https://wave.free-now.com/)您可以找到详细的文件 开始,所有组件,我们的主题,我们的原则,等等.
## 安装
```sh
npm install @freenow/wave
```
或者说
```sh
yarn add @freenow/wave
```
## 开始
在将"波"作为依赖性安装后,有一些额外的步骤来让样式到位:
- 确保安装对等依赖(包括样式组件)
- 请检查date=中的日期值 (帮助) 请检查date=中的日期值 (帮助) 是否没有先前存在的全局样式,这些样式可能与组件所运出的样式相上下下下相上下相上下相上下相上下相下相上相下相下相上相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相上相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相 `a { color: #ffeeaa }`(中文(简体) )
- 确保将想要的色彩方案组件添加到您的 React 树上, 以便让 CSS 变量加载( R)[更多细节](https://wave.free-now.com/iframe.html?viewMode=docs&id=migration-to-v2--docs#1%EF%B8%8F%E2%83%A3-connect-classic-colors)(中文(简体) )
```typescript
import { ModernColors } from '@freenow/wave'; // blue primary color
ReactDOM.createRoot(document.getElementById('root')!).render(
);
```
## 捐款
谢谢你愿意捐款! 请读一下 [捐款额](https://npmcn.com/package/%40freenow/wave/CONTRIBUTING.md) 医生
## 有疑问吗?
请不要犹豫,让我们知道你的疑问是什么,有什么可以改进的,或者你很难从文件中得到什么. 打开问题开始对话!
## 贡献者
感谢这些伟大的人[emoji 密钥](https://allcontributors.org/docs/en/emoji-key):
本项目遵循 [全部贡献者](https://github.com/all-contributors/all-contributors) 规格。 任何捐款都欢迎!
## 常见问题
### @freenow/wave 是什么？
为您的前端项目执行波浪设计系统
### 如何安装 @freenow/wave？
在项目目录运行 npm install @freenow/wave，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.2\.0）、react-dom（^18\.2\.0）、styled-components（\>4\.3）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 run\_v2\_migration，可以用 npx run\_v2\_migration 直接运行。
### @freenow/wave 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @freenow/wave 支持 ESM 还是 CommonJS？
同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。
### @freenow/wave 可以商用吗？
@freenow/wave 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。
### @freenow/wave 的下载量有多少？
根据 npm 官方下载统计，@freenow/wave 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,707 次，日均约 90 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @freenow/wave 还在维护吗？
最新版本 2\.68\.1 发布于 2026/11/11（4 天前）；至今共发布 239 个版本，其中过去 12 个月发布了 29 个；首次发布于 2021/05/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。
