# @arco-design/web-vue 中文文档

规范地址：https://npmcn.com/package/%40arco-design/web-vue/

版本：2\.59\.0
npm 元数据更新时间：2026-10-20T07:07:47.929Z
中文译文更新时间：2026-11-06T14:55:20.411Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40arco-design/web-vue
原文对照：https://npmcn.com/package/%40arco-design/web-vue/?lang=original
项目主页：https://arco.design/vue
源码仓库：https://github.com/arco-design/arco-design-vue

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

- 包体积（解压后）：30.2 MB，4209 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：9 个
- peer 依赖：vue \>=3\.1\.0
- 首次发布：2021-10-25T06:23:32.042Z
- 最新版本发布：2026-10-20T07:07:47.376Z
- 近 30 天下载量：113743（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：153（近 12 个月 3 个）

## 中文简介

Arco Design Vue 2.0: A Vue.js 3 UI 库 互联网档案馆的存檔,存档日期2013-12-20

## 安装

```sh
npm install @arco-design/web-vue
```

也可以使用：`pnpm add @arco-design/web-vue`、`yarn add @arco-design/web-vue`、`bun add @arco-design/web-vue`

## README

[![Arco Design Logo](https://avatars.githubusercontent.com/u/64576149?s=200&v=4)](https://arco.design/)

# Arco Design

基于 [Arco Design](https://arco.design/) 的 Vue UI 组件库。

[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/arco-design/arco-design-vue/blob/main/LICENSE)

[English](https://npmcn.com/package/%40arco-design/web-vue/README.md) | 简体中文

# 特性

## 全面

60多个开箱即用的高质量组件, 可以覆盖绝大部份的业务场景。

## 主题配置

海量的样式 tokens, 支持全局以及组件级别的主题配置。有以下2种方式可以定制主题：

-   [Less-loader](https://arco.design/vue/docs/theme)
-   [风格配置平台](https://arco.design/themes) - 推荐!

## TypeScript 友好

所有组件都是用 TypeScript 编写的，所以天然的类型友好。

# 安装

[npm package](https://www.npmjs.com/package/@arco-design/web-vue)

```bash
// npm
npm install @arco-design/web-vue

// yarn
yarn add @arco-design/web-vue
```

# 例子

```typescript
import { createApp } from 'vue'
import ArcoVue from '@arco-design/web-vue';
import App from './App.vue';
import '@arco-design/web-vue/dist/arco.css';

const app = createApp(App);
app.use(ArcoVue);
app.mount('#app');
```

## 开发

项目开发与提交流程请参考[贡献指南](https://github.com/arco-design/arco-design-vue/blob/main/CONTRIBUTING.zh-CN.md)

# 相关链接

-   [官网](https://arco.design/)
-   [暗黑模式](https://arco.design/vue/docs/dark)
-   [主题配置](https://arco.design/vue/docs/theme)
-   [Figma 设计资源](https://www.figma.com/file/FVu1DydEeXvJqXrkOb90Oi/ArcoDesign%E7%BB%84%E4%BB%B6%E8%AE%BE%E8%AE%A1_2.0?node-id=5472%3A308)
-   [Awesome Arco](https://github.com/arco-design/awesome-arco)

# 生态

| 项目 | 介绍 |
| --- | --- |
| [React 组件库](https://arco.design/react/docs/start) | 基于 [Arco Design](https://arco.design/) 的 React UI 组件库。 |
| [风格配置平台](https://arco.design/themes) | 精确到组件级的主题视觉配置平台 |
| [物料平台](https://arco.design/material) | 丰富可共享的业务定制物料，让效率突破猛进 |
| [图标平台](https://arco.design/iconbox) | 一站式图标管理平台 |
| [Arco Pro](https://arco.design/pro/) | 快速构建中后台的前端解决方案 |

# 参与贡献

贡献之前请先阅读 [行为准则](https://npmcn.com/package/%40arco-design/web-vue/CODE_OF_CONDUCT.md) 和 [贡献指南](https://npmcn.com/package/%40arco-design/web-vue/CONTRIBUTING.zh-CN.md)。

感谢所有为 ArcoDesign 做过贡献的人!

[![](https://contrib.rocks/image?repo=arco-design/arco-design-vue)](https://github.com/arco-design/arco-design-vue/graphs/contributors)

# License

[MIT 协议](https://npmcn.com/package/%40arco-design/web-vue/LICENSE)

## 常见问题

### @arco-design/web-vue 是什么？

Arco Design Vue 2\.0: A Vue\.js 3 UI 库 互联网档案馆的存檔,存档日期2013-12-20

### 如何安装 @arco-design/web-vue？

在项目目录运行 npm install @arco-design/web-vue，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（\>=3\.1\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @arco-design/web-vue 支持 TypeScript 吗？

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

### @arco-design/web-vue 支持 ESM 还是 CommonJS？

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

### @arco-design/web-vue 可以商用吗？

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

### @arco-design/web-vue 的下载量有多少？

根据 npm 官方下载统计，@arco-design/web-vue 在 2026/10/07 – 2026/11/05 这 30 天内被下载 113,743 次，日均约 3,791 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @arco-design/web-vue 还在维护吗？

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