mockaddress 使用说明
一、mockaddress 是什么？
mockaddress 是一个全球在线地址生成工具，用于生成结构合理、格式真实的示例地址，方便在以下场景中使用：
- 网站 / App 表单调试与前后端联调；
- 自动化测试、接口压测、模拟用户数据；
- 演示、教学、测试环境数据填充；
- 需要“真实”地址样本，而不方便使用真实个人信息的场景。
重要说明：生成的地址仅供测试和学习使用，并不代表现实中真实存在的地址，不适合作为正式收货、合同或法律用途。
二、基本使用步骤
以下以「美国地址生成器」为例，其他国家/地区的使用方法类似：
- 选择国家/地区页面：在顶部导航选择对应的地址页面，例如「美国地址」「美国免税州地址」等。
-
设置生成条件（如果有）：某些页面支持选择州/省、地区类型等选项，例如：
- 选择“加州（CA）”“纽约（NY）”等州；
- 勾选是否生成身份信息、信用卡信息等额外字段。
-
点击「生成地址」按钮：页面会在浏览器本地随机生成一条示例地址，通常包含：
- 收件人姓名（可能包含性别与本地化姓名）；
- 街道地址（门牌号 + 街道名）；
- 城市 / 区域名称；
- 州 / 省 / 地区代码；
- 邮政编码（Zip / Postcode）；
- 电话号码（根据地区规则生成）。
- 查看结果区域：生成结果会以多个字段形式展示，方便单独复制；部分页面会提供「整条地址」预览，便于直接粘贴到表单中。
-
复制与保存：
- 点击字段右侧的「复制」按钮，可将该字段复制到剪贴板；
- 页面支持分享功能，点击「分享」后可将生成的地址完整复制下来；
- 如启用「保存地址」功能，生成结果会写入浏览器本地存储，方便在「已保存的地址」页面中查看和下载 CSV 或 JSON。
三、「已保存的地址」功能
3.1 如何保存地址？
在地址生成页面中，点击「保存到本地」按钮，当前生成的地址会写入浏览器 localStorage，只保存在你自己的设备和浏览器中。
3.2 在哪里查看？
通过顶部导航进入「已保存的地址」页面，可以在列表中看到所有已保存的记录，包括生成时间、国家/地区信息和各字段详情。
3.3 导出与删除
- 导出：部分页面支持导出为 CSV / JSON，用于导入测试脚本、Excel 或其他工具；
- 删除：可以单条删除某条记录，也可以一键清空所有本地保存的数据（谨慎操作，清空后无法恢复）。
提醒：所有保存的数据仅存在于你本地浏览器中，不会上传至服务器。如果你更换设备或清空浏览器缓存/本地存储，保存的地址会一并丢失。
四、多语言与站点切换
mockaddress 提供多语言版本（目前包括：中文、英文、俄文、西班牙文等）：
- 页面右上角有语言切换按钮，点击可在不同站点语言之间切换；
- 切换语言后，系统会尝试跳转到当前功能在另一语言中的对应站点页面（例如从中文「美国地址」切换到英文「US Address」）；
- 不同语言版本之间生成逻辑相同，仅页面文字与说明语言不同。
五、常见问题（FAQ）
5.1 生成的地址能用来收快递吗？
不建议，也不保证可用。 这些地址是基于公开数据和规则生成的“示例数据”，目的是测试和教学，而不是现实世界的收件地址。 请在实际业务中使用真实且经过验证的地址信息。
5.2 数据会不会被你们保存？
地址生成逻辑在浏览器本地完成；你主动“保存”的地址，只写入你浏览器的本地存储；我们不会将这些具体地址记录上传到服务器。 详情请参考《隐私政策》。
5.3 可以无限次使用吗？需要注册/付费吗？
当前版本无需注册、免费使用。在合理范围内，我们不限制生成次数，足以满足正常用户的需求（例如每 2 秒生成一次，一小时最多约 1800 次，实际前端可根据需要做频率限制）。 如未来因资源或滥用问题需要调整策略，会在站内公告中说明。
5.4 是否支持批量生成？
部分页面提供导出功能，可以通过多次生成 + 导出 CSV/JSON 的方式获取多条记录。如果你有一次生成几千条以上的大规模需求， 建议在本地编写脚本，基于公开数据集自行生成，减少对线上服务的压力。
5.5 页面显示异常或报错怎么办？
可尝试刷新页面或清空浏览器缓存；更换浏览器（建议使用最新版 Chrome、Edge、Safari 等现代浏览器）； 仍无法解决时，可以附带问题描述、浏览器信息发邮件给我们。
六、使用规范与责任提示（重点）
- 请仅在合法合规的前提下使用 mockaddress；
- 严禁将生成的示例地址用于：金融诈骗、信用欺诈、虚假注册、身份盗用、规避监管、洗钱等任何违法活动；
- 因用户违法或不当使用本工具产生的一切后果和法律责任，由用户自行承担，与 mockaddress 无关。
mockaddress 不对生成数据的真实存在性、准确性、完整性或时效性做出任何形式的保证。
七、联系与反馈
如果你在使用过程中遇到任何问题，或有功能建议、合作意向，欢迎联系我们：
- 电子邮箱：jietoushiren01@gmail.com
- Telegram：https://t.me/mockaddress
感谢你使用 mockaddress，希望它能为你的开发与测试工作带来帮助！