邮件批量迁移 CSV 格式与示例
按照正确的列顺序、限制、分隔符和引用规则准备 CSV 文件,并用示例检查批量迁移数据。
文章详情
类型、难度、套餐及最近更新信息。
▼
文章详情
类型、难度、套餐及最近更新信息。
- 类型
- 指南
- 难度
- 中级
- 套餐
- Starter · Pro · Agency
- 最近更新
- 2026年9月9日
此格式用于批量导入。文件中含有源邮箱密码,请在安全的位置创建文件,并在迁移完成后删除。不要把文件附在支持工单中,也不要将其存入代码仓库。
如果希望从 TrekMail 生成的文件开始,可在 Import > Bulk Import 下载简单或完整模板。
简单格式:三列
所有源邮箱使用同一台 IMAP 服务器时使用此格式。在 Bulk Import 表单中选择提供商,并输入共用的服务器设置。
source_email,source_password,destination_email
alice@old-example.com,app-password-for-alice,alice@yourdomain.com
bob@old-example.com,password-for-bob,bob@yourdomain.com
| 位置 | 值 |
|---|---|
| 1 | 源邮箱的电子邮件地址。 |
| 2 | 源邮箱密码或应用专用密码。 |
| 3 | TrekMail 目标邮箱地址。该邮箱必须已存在于你的账户中。 |
不需要目标邮箱的密码。
完整格式:六列
源邮箱使用不同的 IMAP 主机时使用此格式。预览文件前,在表单中启用 Each row has its own server settings。
source_email,source_password,destination_email,source_host,source_port,source_security
alice@gmail.com,app-password-for-alice,alice@yourdomain.com,imap.gmail.com,993,ssl
bob@old-example.com,password-for-bob,bob@yourdomain.com,mail.old-example.com,993,ssl
| 位置 | 值 |
|---|---|
| 1 | 源邮箱的电子邮件地址。 |
| 2 | 源邮箱密码或应用专用密码。 |
| 3 | TrekMail 目标邮箱地址。 |
| 4 | 源 IMAP 主机名。 |
| 5 | 源 IMAP 端口。 |
| 6 | 源服务器安全选项:ssl、tls 或 none。 |
请向源服务商确认主机、端口和安全设置,并优先使用其安全 IMAP 选项。不要仅为绕过连接错误而选择 none。
避免预览错误的规则
- 保持列顺序。 TrekMail 按照上面列出的位置读取数据。表头可省略;如需添加,必须采用示例中的顺序。
- 使用三列或六列。 不要在同一文件中混用两种格式。
- 文件限制: 文件不得超过 2 MB,数据行不得超过 1,000 行。Starter 和 Pro 的单批限制更低,预览会显示你的账户允许导入的行数。
- 从电子表格导出时使用 UTF-8。 TrekMail 可以处理部分旧编码,但对于包含非英语字符的名称和密码,UTF-8 最可靠。
- 支持逗号、制表符和分号作为分隔符。 TrekMail 会根据文件自动识别分隔符。
- 空行和以
#开头的行会被忽略。 - 含分隔符的字段必须加引号。 例如,密码中的逗号应写成
"pass,word"。带引号字段中的原始引号要写两次:"pass""word"。 - 确认每个源邮箱和目标邮箱只出现一次。 同一批次内,一个源邮箱不能映射到多个目标,一个目标也不能接收两个源邮箱。
- 六列文件中的不同源主机数量应保持合理。 预览一次最多接受 50 个不同的主机。多个服务商的大型项目应拆分成不同批次。
选择 Start 之前
先预览文件并修正所有无效行。常见原因包括目标邮箱不存在、源密码为空、源地址格式错误、源主机不安全或无效,以及文件中存在重复映射。
对于 Gmail、Outlook、Yahoo 和 iCloud,如果提供商要求应用专用密码,请使用相应密码。启用两步验证后,普通账户密码通常会被拒绝。
相关文章
跳转到延续此工作流的邻近指南。