如何使用EZ VCard库读取VCF文件并在TextView中显示姓名和手机号

我看你已经搭好了基础的代码框架，但还有几个细节可以调整，避免不必要的性能问题和异常，下面是完善后的实现方案：

第一步：先搞定权限配置 #

在AndroidManifest.xml里先加上存储读取权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

如果你的应用目标是Android 6.0（API 23）及以上，还得做动态权限申请，不然直接读取会失败，后面我会附上这部分的代码。

第二步：优化后的核心代码 #

// 提前获取TextView实例，别在循环里反复调用findViewById
TextView tv1 = findViewById(R.id.tv1);
// 用StringBuilder拼接内容，避免频繁刷新UI
StringBuilder contactInfoBuilder = new StringBuilder();

try {
    File vcfFile = new File(Environment.getExternalStorageDirectory() + "/mark/Contact/a.vcf");
    List<VCard> vcardList = Ezvcard.parse(vcfFile).all();

    for (VCard vcard : vcardList) {
        // 处理姓名：如果没有格式化姓名，就显示"未知姓名"避免空指针
        String contactName = vcard.getFormattedName() != null 
            ? vcard.getFormattedName().getValue() 
            : "未知姓名";
        contactInfoBuilder.append("姓名：").append(contactName).append("\n");

        // 处理手机号
        List<Telephone> phoneNumbers = vcard.getTelephoneNumbers();
        if (!phoneNumbers.isEmpty()) {
            contactInfoBuilder.append("手机号：\n");
            for (Telephone tel : phoneNumbers) {
                // 处理号码类型：如果没有类型就显示"无类型"
                String phoneType = tel.getTypes().isEmpty() 
                    ? "无类型" 
                    : tel.getTypes().get(0).name();
                contactInfoBuilder.append("- ").append(phoneType).append(": ").append(tel.getText()).append("\n");
            }
        } else {
            contactInfoBuilder.append("无手机号\n");
        }
        // 加个分隔线区分不同联系人
        contactInfoBuilder.append("------------------------\n");
    }

    // 把拼接好的内容一次性设置到TextView
    tv1.setText(contactInfoBuilder.toString());

} catch (IOException e) {
    e.printStackTrace();
    // 给用户反馈错误信息
    tv1.setText("读取VCF文件失败：" + e.getMessage());
}

关键调整说明 #

• 提前获取TextView：循环里反复调用findViewById会浪费性能，提前获取一次就够了
• 用StringBuilder拼接：如果直接在循环里更新TextView，会频繁触发UI刷新，先把所有内容拼好再一次性设置更高效
• 空值判断：处理姓名和手机号列表的空值情况，避免出现空指针异常
• 异常反馈：捕获IO异常后，把错误信息显示给用户，方便排查问题

适配高版本Android的动态权限代码 #

如果你的App要跑在Android 6.0以上，得先申请权限才能读取外部存储：

private static final int REQUEST_READ_STORAGE = 100;

// 在读取文件前先检查权限
private void checkStoragePermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE)
            != PackageManager.PERMISSION_GRANTED) {
        // 权限没授予，发起申请
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},
                REQUEST_READ_STORAGE);
    } else {
        // 权限已授予，执行读取VCF的逻辑
        readVcfFile();
    }
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_READ_STORAGE) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            readVcfFile();
        } else {
            Toast.makeText(this, "需要存储权限才能读取VCF文件", Toast.LENGTH_SHORT).show();
        }
    }
}

// 把之前的读取VCF代码封装到这个方法里
private void readVcfFile() {
    // 这里放上面的核心读取代码
}

内容的提问来源于stack exchange，提问作者user5050715