uni-app实现手机联系人读取 uni-app获取通讯录名单方法-uni-app-PHP中文网

答案是否定的，uni-app本身不提供跨端读取联系人的原生api；h5无权限，app端需用原生插件（如uni-contact），小程序仅支持用户主动选择（如wx.choosecontact）。

uni-app实现手机联系人读取 uni-app获取通讯录名单方法

uni-app 能否直接读取手机联系人？答案是否定的

uni-app 本身不提供 getContacts 或类似原生 API 的跨端接口，H5 环境完全无权限，App 端（iOS/Android）需调用原生模块，小程序端则受限于平台策略：微信小程序仅支持通过 openContact 打开联系人界面，不返回数据；支付宝、QQ 小程序暂不开放读取能力。所谓“获取通讯录名单”，实际只能走原生扩展或用户主动授权选择。

App 端读取联系人必须用 native plugin（非 plus.contacts）

plus.contacts 是旧版 5+ SDK 接口，在当前 uni-app 3.x（基于 Vue 3 + nvue 或 vue 页面）中已失效，调用会报 undefined is not an object。正确路径是：

使用 DCloud 官方提供的 uni-contact 插件（需在插件市场下载并配置）
或自行封装原生 Android/iOS 模块（Android 需动态申请 READ_CONTACTS 权限，iOS 需在 Info.plist 添加 NSContactsUsageDescription）
调用时必须先检查权限：uni.getSystemInfoSync().platform === 'app' 再执行，否则 H5 或小程序会静默失败

示例（使用 uni-contact 插件）：

const contact = uni.requireNativePlugin('uni-contact');
contact.getContacts({
  fields: ['name', 'mobile']
}, res => {
  if (res.code === 0) {
    console.log('联系人列表', res.data);
  } else {
    console.warn('读取失败', res.msg);
  }
});

微信小程序里“选联系人”是唯一合规方式

微信明确禁止自动读取通讯录，但允许用户点击后调起系统选择器——这属于用户主动行为，符合隐私规范。对应 API 是 wx.chooseContact，uni-app 中需用条件编译：

// #ifdef MP-WEIXIN
uni.chooseContact({
  success: res => {
    console.log('选中的联系人', res);
    // res 包含 name、mobilePhoneNumber（需用户授权且非加密）
  }
});
// #endif

注意：mobilePhoneNumber 在 iOS 上可能为空，Android 需用户开启“读取手机号”授权；若用户取消或拒绝，fail 回调不会抛错，而是返回 { errMsg: 'chooseContact:fail cancel' }，需主动判断。