Python 生成模拟地址数据:Faker之外的备选库

承接上一篇《Python Faker库入门》,很多同学问:Faker地址是虚构的,有没有其他库可以生成地址?有些场景需要真实行政区划、省市区联动,甚至真实街道,下面整理几款常用库,附带简单示例。

1. china-area-data(纯行政区划数据,推荐国内场景)

特点 :不是生成器,是国内省/市/区/乡镇静态字典数据源 ,数据来自国标行政区划,全部真实存在,没有虚构地址。

适合:生成合规的省市区下拉、做测试数据时保证省市区真实联动,缺点没有街道、门牌号。

需要自己搭配随机函数抽取数据。

安装

bash 复制代码
pip install china-area-data

使用示例

python 复制代码
import random
from china_area_data import area_data

# 获取所有省份
provinces = area_data["86"]
province_code, province_name = random.choice(list(provinces.items()))

# 获取该省份下所有城市
cities = area_data[province_code]
city_code, city_name = random.choice(list(cities.items()))

# 获取城市下所有区县
districts = area_data[city_code]
district_code, district_name = random.choice(list(districts.items()))

address = f"{province_name}{city_name}{district_name}"
print(address)

优点:省市区一定真实;缺点:缺少详细街道,需要自己补充街道词库。

2. pypinyin + 本地地址词库(自定义方案)

不属于地址专用库,思路:自己维护一份街道、小区名字列表,配合上面china-area-data,拼接完整地址。

适合高度定制化测试数据,完全可控。

3. geonamescache(全球地理数据)

特点 :基于 GeoNames 开放地理数据库,可以获取全球城市、地区名称,真实地名,支持多国家。

适合:需要海外地址、城市名;国内数据覆盖一般,没有精细区县街道。

安装

bash 复制代码
pip install geonamescache

示例

python 复制代码
import geonamescache
import random

gc = geonamescache.GeonamesCache()
cities = gc.get_cities()
city_info = random.choice(list(cities.values()))
print(city_info["name"], city_info["countrycode"])

4. mimesis(对标Faker,轻量替代)

Mimesis 是 Faker 强有力替代品,速度更快,内置多语言地址信息,支持中文。

和Faker一样:地址是虚构格式,不是真实存在地址,只是格式合法。

安装

bash 复制代码
pip install mimesis

中文地址示例

python 复制代码
from mimesis import Person, Address
from mimesis.locales import Locale

address = Address(Locale.ZH_CN)
person = Person(Locale.ZH_CN)

print(address.province())
print(address.city())
print(address.district())
print(address.address())
print(person.full_name())

优势:性能比Faker高,包体积更小;缺点中文精细度略弱于Faker。

5. fake2db(直接生成数据库测试数据)

底层封装了Faker/Mimesis,一键直接往MySQL/SQLite等数据库批量插入,支持地址等字段。

适合不想手写循环插入数据库的场景。

bash 复制代码
pip install fake2db

6. 第三方API方案(非Python库,备选)

如果需要真实可校验地址,库基本都做不到,可以调用公开地址API:

  • 高德/百度地图开放平台行政区域查询接口(获取真实省市区)

注意:有调用额度限制,大批量测试数据不推荐。

各库对比总结

库 地址真实性 国内支持 街道门牌号 适用场景
Faker 虚构 ✅较好 ✅有 快速造测试数据
Mimesis 虚构 ✅一般 ✅有 高性能mock数据
china-area-data 真实省市区 ✅很强 ❌无 省市区联动测试
geonamescache 真实城市 ❌弱 ❌无 海外地理数据

选型建议

  1. 只需要省市区真实存在 :优先 china-area-data,自己拼接街道词库;
  2. 只要格式对,不需要真实地址 :Mimesis 可以作为Faker平替;
  3. 需要全球地址:geonamescache;
  4. 大批量直接写入数据库:fake2db。

常见坑提醒

  1. china-area-data 只有行政区划,没有街道小区,不能直接生成完整地址;
  2. Mimesis/Faker 类生成器,地址只是"看起来像",不能用于地址校验;
  3. 国内精细街道数据属于资源,没有免费Python库自带完整真实街道库。
相关推荐
qq_1588954111112 小时前
Suno-API 是什么?官方 V6 模型与 Python / TypeScript 接入指南
python·ai音乐·suno api
我不会插花弄玉19 小时前
13.多路转接epoll【由浅入深-网络】
网络·c++·epoll
最强小杰20 小时前
某 OpenAI 兼容网关上的 `kimi-k3.1-pro`:Cline、Zed 接入与 SSE 排错示例
java·服务器·网络·ai
学无止境小袁同学1 天前
Google ADK 学习指南
python·llm·agent·多agent·google adk·llmagent·agent cli
郝学胜-神的一滴1 天前
Effective Python 条款35:用类封装替代生成器异常注入
开发语言·人工智能·python·金融·pandas·scikit-learn·matplotlib
观察员1 天前
告别频繁锁屏:5行 PowerShell 脚本实现 Windows 自动防休眠
windows·命令行
LK_071 天前
【力扣】142. 环形链表 II |Python
python·leetcode·链表
wuyk5551 天前
Python办公自动化-第02讲-Excel文件认知与四大库选型
开发语言·python·excel
Funlang1 天前
在 Windows 95 上写前端
前端·javascript·windows