嘿，作为Android开发新手完全不用不好意思，你的代码思路没问题，只是系统的联系人插入Intent只支持部分常用顶层字段，像你提到的姓名前缀/后缀、地址细分项、网址这些精细字段，得通过直接操作Contacts ContentProvider来实现，而不是只靠Intent.putExtra。我当初刚接触联系人操作时也踩过这个坑，给你一步步拆解解决方案：

一、为什么你的自定义Key无效？ #

系统自带的Intents.Insert.ACTION Intent只识别ContactsContract.Intents.Insert类里定义的常量（比如NAME、EMAIL、PHONE、POSTAL这些），你自己试的city、zip这类自定义Key，系统根本不会处理，所以才会全部跑到Street字段里。

二、细分字段的正确实现方式 #

要填充那些精细字段，我们需要先插入一个RawContact，然后往对应的Data表中添加具体的条目（姓名、地址、网址等都存在不同的Data子表中）：

• 姓名前缀/后缀：对应ContactsContract.CommonDataKinds.StructuredName表，常用列有PREFIX（前缀）、SUFFIX（后缀）、GIVEN_NAME（名）等
• 地址细分字段：对应ContactsContract.CommonDataKinds.StructuredPostal表，常用列有CITY（城市）、REGION（州/省）、POSTCODE（邮编）等
• 网址：对应ContactsContract.CommonDataKinds.Website表，用DATA列存网址内容
• 日期事件：对应ContactsContract.CommonDataKinds.Event表，用START_DATE存日期，TYPE指定事件类型（比如生日）

三、完整代码示例 #

推荐直接用ContentProvider全程操作，能更灵活地控制所有字段：

// 获取ContentResolver
ContentResolver resolver = getContentResolver();
ArrayList<ContentProviderOperation> ops = new ArrayList<>();

// 1. 插入空的RawContact，获取其ID
ops.add(ContentProviderOperation.newInsert(ContactsContract.RawContacts.CONTENT_URI)
        .withValue(ContactsContract.RawContacts.ACCOUNT_TYPE, null)
        .withValue(ContactsContract.RawContacts.ACCOUNT_NAME, null)
        .build());

// 2. 添加带前缀/后缀的完整姓名
ops.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
        .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)
        .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE)
        .withValue(ContactsContract.CommonDataKinds.StructuredName.PREFIX, "Mr.")
        .withValue(ContactsContract.CommonDataKinds.StructuredName.GIVEN_NAME, "This")
        .withValue(ContactsContract.CommonDataKinds.StructuredName.MIDDLE_NAME, "T.")
        .withValue(ContactsContract.CommonDataKinds.StructuredName.FAMILY_NAME, "Works")
        .withValue(ContactsContract.CommonDataKinds.StructuredName.SUFFIX, "Jr.")
        .build());

// 3. 添加拆分后的地址字段
ops.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
        .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)
        .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.StructuredPostal.CONTENT_ITEM_TYPE)
        .withValue(ContactsContract.CommonDataKinds.StructuredPostal.STREET, "1234 TestRun Drive")
        .withValue(ContactsContract.CommonDataKinds.StructuredPostal.CITY, "Testopolis")
        .withValue(ContactsContract.CommonDataKinds.StructuredPostal.REGION, "Testerland")
        .withValue(ContactsContract.CommonDataKinds.StructuredPostal.POSTCODE, "55421")
        .withValue(ContactsContract.CommonDataKinds.StructuredPostal.COUNTRY, "USA")
        .build());

// 4. 添加邮箱、电话等基础字段
ops.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
        .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)
        .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE)
        .withValue(ContactsContract.CommonDataKinds.Email.ADDRESS, "testing@testrun.com")
        .withValue(ContactsContract.CommonDataKinds.Email.TYPE, ContactsContract.CommonDataKinds.Email.TYPE_WORK)
        .build());

ops.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
        .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)
        .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE)
        .withValue(ContactsContract.CommonDataKinds.Phone.NUMBER, "(098) 765-4321")
        .withValue(ContactsContract.CommonDataKinds.Phone.TYPE, ContactsContract.CommonDataKinds.Phone.TYPE_WORK)
        .build());

// 5. 添加网址
ops.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
        .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)
        .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Website.CONTENT_ITEM_TYPE)
        .withValue(ContactsContract.CommonDataKinds.Website.URL, "https://testrun.com")
        .withValue(ContactsContract.CommonDataKinds.Website.TYPE, ContactsContract.CommonDataKinds.Website.TYPE_WORK)
        .build());

// 6. 添加日期事件（比如生日）
ops.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
        .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)
        .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Event.CONTENT_ITEM_TYPE)
        .withValue(ContactsContract.CommonDataKinds.Event.START_DATE, "1990-01-01")
        .withValue(ContactsContract.CommonDataKinds.Event.TYPE, ContactsContract.CommonDataKinds.Event.TYPE_BIRTHDAY)
        .build());

// 执行批量操作
try {
    resolver.applyBatch(ContactsContract.AUTHORITY, ops);
    Toast.makeText(this, "联系人添加成功", Toast.LENGTH_SHORT).show();
} catch (RemoteException | OperationApplicationException e) {
    e.printStackTrace();
    Toast.makeText(this, "添加失败", Toast.LENGTH_SHORT).show();
}

四、补充注意事项 #

• 别忘了添加权限：在Manifest里加上<uses-permission android:name="android.permission.WRITE_CONTACTS"/>，Android 6.0以上还要动态申请权限
• 你之前用的name_given、name_family其实是ContentProvider的列名，不是Intent的Extra Key，所以Intent.putExtra不会生效，必须通过ContentProvider操作
• 如果只是快速插入基础字段，用Intent没问题，但要精细控制字段，ContentProvider是唯一途径

这样就能完美填充所有你需要的字段啦，有其他问题随时问～

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