uni-app中地址补全应优先调用原生API（如uni.chooseLocation、wx.chooseAddress）或接入高德/腾讯地图WebService，而非用picker模拟三级联动；H5端需通过原生DOM操作集成高德AMap.Autocomplete并注意防抖、跨城搜索等细节。
uni-app 中用 input + picker 组合实现地址补全更可靠
纯前端自动补全收货地址在 uni-app 里不推荐直接做，因为地址结构复杂、用户输入随意（如“朝阳区建国路8号”“北京朝阳建国路8号SOHO”），正则或关键词匹配极易漏判或误判。实际项目中，90% 的「地址补全」本质是「省市区三级联动 + 详细地址手动输入」，真正的地理级自动补全必须依赖地图 SDK。
所以，优先走官方路径：用 uni.chooseLocation 拉起原生地图选点，再结合 uni.getSystemInfoSync().platform 做平台适配；若需输入时实时提示（如输入“中关村”弹出“中关村大街1号”），必须接入高德/腾讯地图的 WebService API（注意跨域和 key 权限）。
- 微信小程序可用
wx.chooseAddress直接拉起系统收货地址（但仅限已保存地址，无搜索补全） - H5 端必须用高德 JSAPI 的
AMap.Autocomplete，且需在 manifest.json 中配置"h5": { "usingComponents": true }并引入 script - App 端（iOS/Android）建议用
uni.getLocation+uni.openLocation配合后端逆地理编码接口，避免地图 SDK 接入复杂度
高德 Autocomplete 在 H5 端的最小可行接入（含防抖和清空逻辑）
这是最接近「输入即补全」的方案，但只适用于 H5。关键不是写多少代码，而是绕过 uni-app 的 DOM 封装限制，直接操作原生 input 元素并绑定事件。
示例逻辑：在页面 onReady 后获取 input DOM 节点 → 初始化 AMap.Autocomplete → 监听 input 事件触发搜索 → 点击下拉项后填充到表单字段。
- 必须在
index.html的<head>中提前加载高德 JSAPI：<script src="https://webapi.amap.com/maps?v=2.0&key=YOUR_KEY"></script> - 不能在
mounted钩子中初始化 Autocomplete，要等document.getElementById('address-input')真实存在，建议放onReady或setTimeout(..., 300) - 搜索关键词长度建议 ≥2，避免海量无效请求；用
clearTimeout自行实现防抖，uni-app 的@input不支持原生debounce修饰符 - 选中后务必调用
autocomplete.setCity('北京市')再执行search，否则跨城搜索会失败（例如搜“南京东路”却返回上海结果）
小程序平台如何复用系统能力而非自己造轮子
微信/支付宝/百度小程序都有原生地址选择能力，比前端补全更准、更合规、体验更好——尤其是微信的 wx.chooseAddress 返回的是经用户确认的真实收货地址，含邮编、手机号、是否默认等字段，直接赋值给表单即可。
但要注意：该 API 只返回用户在微信内「已保存的地址」，不支持模糊搜索或新增补全。如果业务强制要求「未保存也能搜」，只能退回到 H5 方案或自建地址库（不推荐）。
- 调用前需在
manifest.json中配置对应平台的权限字段，例如微信小程序需开启"mp-weixin": { "permission": { "scope.address": { "desc": "用于获取收货地址" } } } - 返回的
provinceName/cityName/districtName字段名与 uni-app 的uni.chooseLocation不一致，需做字段映射 - 支付宝小程序的
my.chooseAddress返回字段为province/city/area，注意大小写和空格处理
为什么不要用 uni-app 的 picker 模拟三级联动做“伪补全”
很多团队用 picker + 省市区 JSON 数据实现选择，再加一个 input 填详细地址——这看起来像补全，实则不是。它解决的是「结构化地址录入」，不是「用户输入文本时的智能提示」。
典型问题：用户输入“望京小腰”，你无法从省市区数据里匹配；输入“国贸三期”，三级 picker 根本不响应。这种方案适合下单页地址确认，不适合搜索场景。
- 省市区 JSON 文件体积大（完整版 >1MB），影响首屏加载，建议按需分包或用接口动态加载
- 港澳台、海外地址不在标准 JSON 中，硬编码易出错；应以接口返回为准
- picker 的
range-key和value映射容易混乱，比如value=[0,1,5]对应 “北京-朝阳区-三里屯”，但用户切换城市后没重置区级索引，导致选错
真正需要补全的场景，核心是「降低输入成本 + 减少错别字」，而不是把选择器做得多漂亮。能调原生就调原生，能接地图 API 就别拼字符串。
