CSV与vCard联系人迁移
本地映射联系人列,保留重复字段和结构值,导出可编辑CSV或UTF-8 vCard 3.0及完整侧车报告。
- 1添加输入
- 2调整设置
- 3获取结果
工具输入和文件在当前浏览器处理,不会上传。
开始之前
迁移前选择方向、分隔符和明确的姓名及列规则。
如何使用
- 选择原件与转换方向。
- 映射物理列并明确选择FN姓名规则。
- 转换,核对侧车警告及全部交付文件。
- 在接收程序中导入副本并检查重复字段。
支持范围与限制
粘贴文本或选择一个不超过2 MiB的UTF-8 CSV/vCard文件。文件优先于粘贴内容。文件名最多512个UTF-8字节,MIME标签最多256字节;开头的一个UTF-8 BOM会记录并从解析内容移除。
仅支持vCard 3.0核心字段FN、N、TEL、EMAIL、ORG、TITLE、ADR、URL、NOTE;保留重复属性、结构组件多值、TYPE、LANGUAGE与group。要求非空FN和N属性;版本、编码/CHARSET参数、语法或必需姓名错误会整体拒绝。
显式选择逗号、分号或制表符。CSV最多128列、联系人最多10,000条;按从0开始的物理列序号映射,空表头和重复表头同样计列。CSV单元格和解码组件各最多65,536个UTF-8字节,映射JSON最多32 KiB。
核心属性合计最多100,000项、每位联系人最多250项,组件多值和组织组件各最多128项,vCard非空逻辑行最多150,000行。可编辑导出最多256列,所有交付文件合计最多16 MiB。超限整体拒绝,不返回部分联系人。
默认将未映射CSV列和不支持的vCard属性完整写入报告,也可选择整体拒绝。NICKNAME、BDAY、ROLE、X属性与PHOTO保留在侧车及原件中,不进入核心迁移文件;不会获取头像或URL。
contacts.csv是可编辑文本列,重复字段使用编号列。组件多值为便于编辑而连接展示;精确数组、全部参数与group仍保留在contacts.json和roundtrip.csv。用records映射重导roundtrip.csv可保真恢复;普通客户端CSV模板仍需按其字段映射。
映射文本内的CRLF归一为LF;vCard输出采用CRLF,并按75个UTF-8字节折行,不切断字符。TEL中的反斜线/换行和URL中的空白/反斜线会拒绝。CSV空标量单元格省略该属性,records可以显式保留空值。
预览最多4,000个Unicode码点,复制和下载保留完整输出。整次运行10秒时限从引擎加载前开始,覆盖Worker就绪、文件读取和处理;取消会销毁Worker,可用保留的同一File和参数重跑。所有输入留在浏览器。
操作示例
示例输入
"Vorname";"Nachname";"Firma";"Tel";"Mobil";"Land";"Kundennummer"; "Max";"Mustermann";;"+4912345678";;"Deutschland";"1234";
示例参数
delimiter=; fnRule=given-family; explicit physical column mapping
示例输出
FN:Max Mustermann N:Mustermann;Max;;; TEL;TYPE=HOME,VOICE:+4912345678 侧车:Kundennummer=1234,第7列为空
出现问题时
修正映射/编码或减少超限记录后,用保留的原文件重跑。取消不保留部分输出。
常见问题
为什么部分字段只在报告里?
默认将未映射CSV列和不支持的vCard属性完整写入报告,也可选择整体拒绝。NICKNAME、BDAY、ROLE、X属性与PHOTO保留在侧车及原件中,不进入核心迁移文件;不会获取头像或URL。
能否保真重导重复字段?
contacts.csv是可编辑文本列,重复字段使用编号列。组件多值为便于编辑而连接展示;精确数组、全部参数与group仍保留在contacts.json和roundtrip.csv。用records映射重导roundtrip.csv可保真恢复;普通客户端CSV模板仍需按其字段映射。