API同步失败，换成手动导入CSV，结果导入了一堆重复交易——这是Koinly、CoinLedger、CoinTracking这些税务软件里最常见的报错场景之一。
平台报"Duplicate"不代表你的CSV文件有问题，而是它发现这条记录在你的账本里已经存在了。手动导入要避开的重复，核心就三类：同一文件重复导入、API和CSV混用、跨文件重叠。
步骤 1：同一文件导入了多次（最常见）
做什么：确认你是否把同一个CSV文件反复导入过。
怎么做：去税务软件的"导入记录"或"已连接账户"列表里，看有没有同一个文件名出现多次。CoinLedger的"Missing Cost Basis Troubleshooting"面板会直接标出"Same CSV file imported twice"；Koinly的导入摘要里"Duplicate"会显示被跳过的交易数量。
完成标准：你能说出现在同一个文件在系统里有几个副本。
常见失败原因：很多人忘了自己一个月前已经导过一次，这个月为了补新数据又导了一次同一份老文件，结果老交易全重复了一遍。最简单的办法：每次导入前，先去"已导入文件"列表里看一眼。
步骤 2：API 和 CSV 同时用（最容易漏）
做什么：确认你正在导入的CSV，是否来自一个已经通过API同步过同个账户的交易所。
怎么做：
检查税务软件的"已连接账户"列表，看看有没有同一个交易所有API连接存在。
CoinLedger明确指出，如果把同一个交易所的CSV和API混合使用，系统无法有效过滤重复——两者走的是不同的识别机制。CoinTracking也建议，同一个账户只选一种方式，不要混用。
有些平台（如MEXC）的API和CSV互不兼容，同时用必然产生重复。
完成标准：你确认当前使用的交易所，在系统里只挂了一种数据来源（要么API，要么CSV，不是两个都在）。
风险提醒：API和CSV混用导致的重复，系统不会全部自动跳过。CoinLedger明确提示，这种情况可能引发"缺失成本基础"警告——重复交易会干扰成本流转，导致部分交易无法匹配正确的买入成本。最终你的税务报告里可能出现成本为0的记录，拉高应纳税额。
步骤 3：跨文件交易重叠（多文件分批导入）
做什么：确认多个CSV文件之间是否有时间或交易范围重叠。
怎么做：
如果你是分批次导入（比如按季度导出、或按月份拆开），要确保每批文件的日期范围不重叠。
Koinly用户曾反馈，Bybit的CSV拆分成多份导入后，系统会标记部分交易为"Duplicate"，即使文件时间不重叠。解决办法是按时间升序导入、每次导入尽可能大的文件（如10MB上限），减少拆分次数。
对于有重叠的跨文件交易，优先保留较早导入的那一批，删除后面重复的部分。
完成标准：你所有导入的文件日期范围不重叠，或者在重叠部分已经手动标记了保留哪一条。
操作完成的校验方式
导入完成后，去税务软件的"交易列表"里筛选该币种或该交易所，按时间排序：
检查是否有同一时间戳、同一币种、同一数量的交易出现两次以上。如果有，这就是典型的重复交易标志。
查看"Missing Cost Basis"警告面板——如果有重复导入被标记，系统会在这里提示。
下一步衔接动作：如果已经产生了重复记录，不要去手动逐条删除。先删除整个问题导入（删除API连接或CSV导入），再重新执行一次干净的导入。CoinTracking建议在切换导入方式前，先删除所有已导入的旧交易，再重新导入。完成后，用《交易所CSV漏掉内部划转：怎样补全完整账本》里提到的方法，把内部划转记录单独补进去，避免重复。
