速查在线工具箱导入通讯录后姓名乱了，是文件坏了吗？
名片文件里姓名有两个字段：一个给机器排序，一个给人看。只写其中一个，或者把全名整个塞进去，排序和显示就会错位。
核心原因是姓名有两个字段：N 是结构化姓名，按「姓、名、中间名、前缀、后缀」五段用分号分隔；FN 是显示名，界面上一律显示它。
只写显示名不写结构化姓名，部分客户端排序时找不到姓氏就会把卡片放错位置，个别严格的客户端会直接丢掉这张卡；反过来，把「张三」整段填进姓氏位，排序结果会全部乱掉。
中文名还可能碰到第二个坑：旧版格式用可打印引号编码，中文会被写成等号加十六进制的一串字符，认不出来的客户端就显示成乱码。
名片文件是纯文本，一行一个属性，用 BEGIN 与 END 包住。它的设计初衷不是「给人读」，而是让不同厂商的通讯录能互相交换数据，所以字段被拆得很细。
这一篇解释姓名为什么会被拆错，以及中文名乱码的真正来源。理解了字段分工，自己手写一张名片也很容易。
1姓名为什么要拆成两个字段
一句话概括分工：结构化字段管排序与归并，格式化字段管显示。两者都需要，缺一个就会出问题。
| 字段 | 作用 | 写法要点 | 缺失后果 |
|---|---|---|---|
| 结构化姓名 | 按姓氏排序、按姓归并 | 五段用分号分隔，空的段也要保留分号 | 排序错位，部分客户端丢弃该卡片 |
| 格式化全名 | 界面上显示的那一行 | 直接写人类习惯的完整写法 | 列表里看不到名字 |
| 地址字段 | 收件与归类 | 七段用分号分隔，规则同上 | 地址错位或串行 |
| 电话字段 | 区分号码用途 | 每个号码可带一个用途标记 | 多个号码无法区分主次 |
空段必须用分号占位。少写一个分号，后面的段会整体前移一位，于是名变成了中间名。
2三个最常见的写法错误
这三条几乎覆盖了「导入后姓名不对」的全部投诉。
- 只写显示名
- 严格解析器会因为缺少结构化姓名而拒绝整张卡，宽松的则按整串文本排序，位置随机
- 全名塞进姓氏位
- 显示正确、排序全错，因为每一张卡的姓氏都是完整姓名
- 中西顺序混用
- 中文姓名按西方习惯写成「名 姓」，看起来对，但机器按第一段当姓氏，反而全乱
不确定时优先保证结构化字段的段位正确，显示名再按当地习惯书写，两者不必一致。
3乱码与换行：两个容易被忽略的硬要求
这两条不涉及语义，但违反了就会被拒或显示成怪字符。
| 要求 | 规范写法 | 违反后的表现 |
|---|---|---|
| 编码 | 新版直接写 UTF-8 文本 | 旧版用的可打印引号编码会把中文写成等号加十六进制，认不出的客户端显示乱码 |
| 换行 | 每行以回车加换行结束 | 只写换行符时宽松解析器能读，严格的会整体拒绝 |
| 特殊字符 | 反斜杠、分号、逗号、换行都要转义 | 标题里的分号会把一个字段劈成两半 |
| 长行折行 | 超长行按固定字节数折行，续行以空格开头 | 折行位置不对时部分客户端只读到一半 |
一个文件里可以连续放多张名片，这也是通讯录导出文件的结构——导入时它按 END 一行一张地读。
相关疑问
一个文件能放多个联系人吗？
能。把若干张完整的名片块首尾相接即可，通讯录导出用的就是这个结构，解析器读到结束标记就重新开始。
为什么有的客户端不认我的名片文件？
优先检查三件事：用了哪个版本、有没有写结构化姓名、换行符是不是规范的。这三项占绝大多数。
中文名里的标点要处理吗？
要。中文顿号通常没问题，但半角逗号、分号、反斜杠属于格式保留字符，出现在内容里必须转义。
扫二维码存联系人也是这个格式吗？
是同一个格式，只是内容被编码进了二维码。容量有限，所以照片这类大字段一般不会放进去。
继续看：相关问题与资料
全部问题解答 →内容说明：本页针对具体使用问题作答，方法步骤与数值由本站自行整理与复算，事实性内容以对应官方规范与文档为准。内容最后核对日期：2026-10-09。若发现错误，欢迎通过页脚反馈入口告知。