# @vant/area-data

> Vant 省市区数据

Latest version **2.2.0** (published 2026-08-30) · MIT license · 0 weekly downloads

## Install

```sh
npm install @vant/area-data
pnpm add @vant/area-data
yarn add @vant/area-data
bun add @vant/area-data
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.2.0 |
| Published | 2026-08-30 |
| First published | 2021-04-09 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 236.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 24407 |
| Author | chenjiahan |
| Maintainers | chenjiahan |

## Links

- npm: https://www.npmjs.com/package/@vant/area-data
- Repository: https://github.com/vant-ui/vant
- Homepage: https://github.com/vant-ui/vant#readme
- Issues: https://github.com/vant-ui/vant/issues
- npm.io page: https://npm.io/package/@vant/area-data

## Recent versions

- 2.2.0 (latest) — 2026-08-30
- 2.1.0 — 2025-08-23
- 2.0.0 — 2024-10-13
- 1.5.2 — 2024-08-24
- 1.5.1 — 2023-10-27
- 1.5.0 — 2023-07-29
- 1.4.1 — 2023-03-09
- 1.4.0 — 2023-01-25
- 1.3.2 — 2022-09-01
- 1.3.1 — 2022-05-31
- 1.3.0 — 2022-05-22
- 1.2.4 — 2022-04-23
- 1.2.3 — 2022-03-18
- 1.2.2 — 2022-01-25
- 1.2.1 — 2021-12-29
- … 8 more at https://npm.io/package/@vant/area-data/versions

## README

# Vant China Area Data

中国省市区数据，适用于 Vant 的 Area 和 Cascader 等组件。

## 安装

```shell
# 通过 npm
npm i @vant/area-data

# 通过 yarn
yarn add @vant/area-data

# 通过 pnpm
pnpm add @vant/area-data

# 通过 Bun
bun add @vant/area-data
```

## 使用

在 Vant 的 Area 组件中使用时，直接引用 `areaList` 对象即可：

```ts
import { areaList } from '@vant/area-data';
```

在 Vant 的 Cascader 组件中使用时，请使用 `useCascaderAreaData` 方法：

```ts
import { useCascaderAreaData } from '@vant/area-data';

const cascaderAreaData = useCascaderAreaData();
```

## 数据更新

中国的行政区划每年都会有变动，如果发现省市区数据未及时更新，欢迎提 Pull Request 帮助我们更新。你可以在[「国家统计局 - 全国区划代码」](http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/) 和[「民政部 - 行政区划代码」](https://www.mca.gov.cn/article/sj/xzqh/1980/)上查询到最新数据，请根据官方数据进行核实。

---
_Source: https://npm.io/package/@vant/area-data · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._