TRON Multisender [ ]
批量代币转账的 CSV 格式:模板 + 常见错误
更新于:2026年7月19日阅读约 6 分钟
作者:TRXSend team
目录6
批量代币转账的 CSV 只需要两列——先是收款地址,然后是金额——每行一个收款人,用英文逗号分隔,小数点用英文句点,不要表头行。这就是全部格式。下载下面的现成模板,把示例行替换成你的真实地址,就完成了;本文其余部分之所以存在,是因为电子表格会以七种可预见的方式破坏这种简单性,而花十分钟整理文件,远比一笔无法撤回的错误转账便宜。
下载模板
下载 CSV 模板——三行格式正确的示例:
TYourRecipientAddressHere111111111,100
TYourRecipientAddressHere222222222,25.5
TYourRecipientAddressHere333333333,10
有一个刻意设计的安全特性:示例地址的格式看起来没问题(34 个字符,以 T 开头),但并不是真实的 TRON 地址,所以 dApp 的校验器会在上传时拒绝它们。你不可能把资金误发到模板上——把每一行都换成真实收款人,文件就能通过校验。
逐行格式说明
每一行代表一个收款人,遵循同一条规则:
<TRON 地址>,<金额>
- 地址:base58 格式的 TRON 地址——以
T开头,恰好 34 个字符。前后不要有空格,不要加引号。 - 逗号:列分隔符。每行一个逗号,别的都不要。
- 金额:一个普通数字。小数用句点(
25.5),不要千位分隔符(写10000,不要写10,000),不要货币符号,末尾不要空格。 - 不要表头行。 第一行就必须是真实收款人——文本
address,amount会被标记为无效地址(这是校验器在提醒你删掉它)。 - 允许重复,但有含义:同一个地址出现两次,就表示向该钱包转账两次。除非你确实想这样,否则请先去重。
同样的两列名单也可以作为纯文本直接粘贴到 dApp 中,包含同样两列的 XLS/XLSX 文件也可以直接使用——CSV 只是三者中通用性最好的格式。
从你常用的工具中导出
格式本身很简单;出问题的是导出环节。三种最常见的途径:
Google 表格。 地址放在 A 列,金额放在 B 列,工作表上不要有其他内容——没有标题行,没有备注列。把金额列设置为普通数字格式(格式 → 数字 → 数字,然后去掉千位分隔符的显示;更好的做法是,用句点输入数值后选择 格式 → 数字 → 纯文本)。通过 文件 → 下载 → 逗号分隔值(.csv)导出。表格导出的是你看到的内容,所以如果该列显示为 10,000,这个逗号就会进入文件。
Excel。 危险的变量是系统区域设置:在许多欧洲系统上,Excel 会写出以分号分隔、以逗号作小数点的"CSV"——文件看起来正确,解析却是错的。两种解决办法:要么在工作簿中把小数分隔符设为句点(选项 → 高级 → 取消勾选"使用系统分隔符"),要么彻底绕开这个坑,直接上传 .xlsx 文件本身——dApp 接受相同两列布局的该格式。
其他所有工具(Notion、Airtable、数据库导出):先导出工具生成的内容,再把这两列在纯文本编辑器里过一遍。这样一步就能去掉弯引号、不可见字符和富文本残留——十秒钟,常常能省下一次重新上传。
无论走哪条路,都请用文本编辑器(而不是电子表格)打开最终文件看一眼。你在那里看到的——逗号、句点、没有引号、没有表头——正是解析器将看到的内容。
七种典型错误
多年的客服对话可以归结为这份清单:
- 逗号作小数点。 许多地区(欧洲大部分国家、巴西等)的电子表格会把一又二分之一写成
1,5。在逗号分隔的文件里,这会被读成两列——金额1加上后面的乱码。导出前请把金额列的格式设置为句点小数。 - 千位分隔符。
10,000会以同样致命的方式被拆成两列;带空格的10 000则无法解析为数字。金额必须是纯数字:10000。 - 遗留的表头行。 第一行是
address,amount。删掉它。 - 空格和不可见字符。 从聊天软件、Telegram 或网页复制来的地址,常常带着空格、制表符或零宽字符。校验器会标记它们,但先在表格里清理这一列,可以省下一次重新上传。
- 带引号的值。 有些导出工具会给每个单元格加上引号(
"TAbc...","100")。大多数解析器能容忍,但混用或多余的引号(地址中间夹着引号)会不可预测地破坏行结构。请导出不带引号的普通 CSV。 - 其他网络的地址。 地址列里粘贴了以太坊的
0x…地址或交易所的备注(memo)。TRON 地址以T开头、长 34 个字符;其他任何内容都无法接收 TRC-20 代币,会被标记出来。 - base58 拼写错误。 手动修改过、错了一个字符的地址,通常无法通过校验和检查而被标记——这正是校验器的设计用途。危险的情况是:一个有效地址却属于错误的人,任何软件都无法发现——这正是审核界面存在的意义。
发送前检查文件
一个九十秒的起飞前检查,几乎能发现所有问题:
- 按地址列排序——重复项会排在一起、一目了然,格式错误的条目会排到最前或最后。
- 核对行数,与预期的收款人数比较。差一行通常意味着有表头行或末尾空行。
- 对金额列求和并记下总数。上传后,dApp 会在审核界面显示解析出的总额——两个数字必须完全一致。如果不同,说明有小数点或分隔符的问题漏了过去。
- 在 dApp 中浏览解析后的名单。 此时校验已经标记出格式错误的地址和重复项;你要做的是人工检查——名称、金额和总额看起来是否符合你打算发放的内容?
- 第一次使用这份名单? 在正式发送之前,先对几行发送一个小额测试批次,正如分步指南所建议的。链上转账不可撤回;预演是唯一的"撤销键"。
FAQ
文件需要特定的文件名或编码吗? 不需要特定文件名。使用普通的 UTF-8(任何电子表格默认都导出这种编码)。避免使用会添加字节顺序标记(BOM)或把文件转换为富文本的编辑器。
可以用 XLS/XLSX 代替 CSV 吗? 可以——dApp 接受相同两列布局的 CSV、XLS 和 XLSX,你也可以把名单作为文本粘贴。CSV 在不同工具之间传递时意外最少,所以模板采用这种格式。
如何在一个文件里放入不同的代币? 不行——一个文件就是一种代币的一次分发。代币在上传前于 dApp 中选择;不同代币请分别执行批次。
文件大小有上限吗? 实际上没有:超过约 150 个收款人的名单,会在同一流程中被拆分为多笔连续的批量交易处理。手续费计算器可以显示任意名单规模的成本,完整教程则介绍了围绕这个文件的整个发送流程。