术语表
第一次看到这些词时，回到这一页即可。
Patch
一份描述「某年之后区划变了什么」的 JSON 文件，放在仓库的 patches/<年份>/。常见内容是更名、新设社区、撤销。提交前用 validatePatch 检查格式。怎么写见 贡献 Patch。
注水（hydrate）
cndiv hydrate 把 npm 上的数据包下载进本机 ~/.cndiv/cache.db。这是一个普通的 SQLite 文件。文档里说的「注水」就是这件事，装好之后查询不再访问网络。
市辖区占位层
直辖市在「省」和「区」之间有一层名字叫「市辖区」的记录。北京是 110100000000。它不是东城区、西城区那种真实的区。
所以 getChildren('110000000000', 2023) 只返回「市辖区」。加上 { skipPlaceholder: true } 才会返回 16 个区。见 常见用法。
会被跳过的名字（且层级是市这一级）有：市辖区、县、省直辖县级行政区划、省直辖县级行政单位、自治区直辖县级行政区划。
区划码 12 位结构
统计用区划代码固定 12 位，切成 2+2+2+3+3：省、市、县、乡、村。
text
11 01 01 001 001
省 市 县 乡 村东城区 110101000000 是县级：前 6 位是 110101，后面 6 位是 0。不足 12 位可以补零，补零只说明格式齐了，不说明这个地方真实存在。拆码函数见 @cndiv/core。
GB2260 与 NBS
两套都是行政区划代码，深度不一样：
| 名称 | 有哪些级 | 在本仓库里怎么装 |
|---|---|---|
| GB/T 2260 | 省、市、县 | cndiv hydrate --year=history（1980–2021，合计 131,356 条） |
| 统计用区划代码（NBS） | 上面三级，再加乡、村 | cndiv hydrate --year=2023（665,271 条） |
查 2023 年的村，用 NBS 这一包。查「2015 年这个县叫什么」，用 history 这一包。
dmfw
国家地名信息库，网站 dmfw.mca.gov.cn。统计局的五级全量在 2024 年后不再公开发布，2026 年起官方入口转到这里。