# @antmjs/vantui 中文文档

规范地址：https://npmcn.com/package/%40antmjs/vantui/

版本：3\.7\.0
npm 元数据更新时间：2025-09-04T07:45:07.754Z
中文译文更新时间：2026-11-06T06:53:06.072Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40antmjs/vantui
原文对照：https://npmcn.com/package/%40antmjs/vantui/?lang=original
项目主页：https://github.com/AntmJS/vantui#readme
源码仓库：https://github.com/AntmJS/vantui

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.4 MB，2192 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=12
- 运行依赖：8 个
- 首次发布：2021-10-11T03:17:17.245Z
- 最新版本发布：2025-09-04T07:45:07.556Z
- 近 30 天下载量：5549（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：158（近 12 个月 0 个）

## 中文简介

一套适用于Taro3及React的vantui组件库

## 安装

```sh
npm install @antmjs/vantui
```

也可以使用：`pnpm add @antmjs/vantui`、`yarn add @antmjs/vantui`、`bun add @antmjs/vantui`

## README

![](https://antm-js.gitee.io/resource/antmjs-vantui.jpg)

## @antmjs/vantui

基于有赞 VantWeapp 开发的同时支持 Taro 和 React 的 UI 库

### 相关链接

-   [Vant Weapp](https://github.com/youzan/vant-weapp)：由有赞团队打造的轻量、可靠的微信小程序 UI 组件库
-   [Taro](https://github.com/NervJS/taro)：由京东团队打造的开放式跨端跨框架解决方案，支持使用 React/Vue/Nerv 等框架来开发微信/京东/百度/支付宝/字节跳动/ QQ 小程序/H5/React Native 等应用

### 为什么是高度一致

-   99% 样式文件迁移
    
-   100% React 化，在 React 化的过程中保留了有赞的大部分 JS 逻辑，尽可能的少重构！
    
-   10+ 项目接入中
    

### 我们带来了什么

-   使用 TypeScript 编写，提供完整的类型定义
    
-   支持 Taro(H5、微信小程序、支付宝小程序、抖音小程序...)(注：React Native 不支持)
    
-   与 VantWeapp 的 UI 和 API 尽可能的保持一致
    
-   50+ 个高质量组件，覆盖移动端主流场景
    
-   支持主题定制
    
-   支持按需加载
    

### 为什么你可以放心用

-   背景：整个组件库初期是依赖开源项目 Vant Weapp 的代码经过全量编译而来，所有样式文件及代码结构都与其保持高度一致，只是生命周期经过改造使其支持 React，很大程度避免了重新造轮子带来的各种问题
    
-   组件库本身无法 100%满足大众个性化的 UI 需求，如果有个性化需求的可以自己通过改主题定制或 class 或 style 的形式满足自己的要求
    

> 如果觉得不错，给个 Star 哦

### 学习链接

-   [github 文档](https://antmjs.github.io/vantui/#/home)
-   [gitee 文档](https://antm-js.gitee.io/vantui/#/home)

### 预览

![](https://antm-js.gitee.io/resource/vantui-weapp.png) ![](https://antm-js.gitee.io/resource/vantui-h5.png)

### 贡献代码

使用过程中发现任何问题都可以提 [Issue](https://github.com/antmjs/vantui/issues) 给我们，当然，我们也非常欢迎你给我们发 [PR](https://github.com/antmjs/vantui/pulls)

### 开源协议

本项目基于 [MIT](https://zh.wikipedia.org/wiki/MIT%E8%A8%B1%E5%8F%AF%E8%AD%89) 协议，请自由地享受和参与开源

### 参与共建

小电科技创新事业部前端团队

### 特别声明

-   该组件库并不是一个新的轮子，我们只是得益于有赞团队在 vant-weapp 的多年实践、积累、沉淀上做了一些简单的扩展，让它可以以 Taro/React 的方式进行开发接入。
    
-   我们是 vant-weapp 的锦上添花版本，在此还是需要感谢 Taro 团队以及有赞团队为社区所作出的贡献。
    
-   Logo 暂时还未获得使用许可，如有侵权，请及时联系我们。
    

### 以下是 @antmjs/vantui 的核心贡献者们

| [![hisanshao](https://avatars.githubusercontent.com/u/26359618?s=100&v=4)](https://github.com/hisanshao/) | [![Chitanda60](https://avatars.githubusercontent.com/u/16026533?s=100&v=4)](https://github.com/Chitanda60/) | [![zuolung](https://avatars.githubusercontent.com/u/19684540?s=100&v=4)](https://github.com/Banlangenn/) | [![hisanshao](https://avatars.githubusercontent.com/u/28145148?s=100&v=4)](https://github.com/zuolung/) |
| :-: | :-: | :-: | :-: |
| [hisanshao](https://github.com/hisanshao/) | [Chitanda60](https://github.com/Chitanda60/) | [Banlangenn](https://github.com/Banlangenn/) | [zuolung](https://github.com/zuolung/) |

### 贡献者们

感谢以下小伙伴们为 @antmjs/vantui 发展做出的贡献：

[![contributors](https://opencollective.com/vantuiantmjs/contributors.svg?width=890&button=false)](https://github.com/AntmJS/vantui/graphs/contributors)

### 快速沟通群

微信群满 200 人，需手动拉群。添加好友请备注“AntmJS”，我们会尽快拉你进群交流

![](https://antmjs.github.io/vantui/resource/chat.png)

## 常见问题

### @antmjs/vantui 是什么？

一套适用于Taro3及React的vantui组件库

### 如何安装 @antmjs/vantui？

在项目目录运行 npm install @antmjs/vantui，或使用 pnpm add / yarn add / bun add。

### @antmjs/vantui 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @antmjs/vantui 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @antmjs/vantui 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=12。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @antmjs/vantui 可以商用吗？

@antmjs/vantui 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @antmjs/vantui 的下载量有多少？

根据 npm 官方下载统计，@antmjs/vantui 在 2026/10/06 – 2026/11/04 这 30 天内被下载 5,549 次，日均约 185 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @antmjs/vantui 还在维护吗？

最新版本 3\.7\.0 发布于 2025/09/04（1\.2 年前）；至今共发布 158 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/10/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。