美国税务软件实测:UsTaxes 与 OpenTaxSolver 的 CSV 导入和导出
用同一组合成股票交易测试两款免费税务软件,核对交易配对、200 美元收益、CSV/JSON/PDF 输出,以及错误输入的处理边界。
一份股票交易 CSV 能否直接放进税务软件,首先取决于它记录的是什么。我用两笔合成交易测试了免费工具 UsTaxes 和 OpenTaxSolver:买入 10 股,每股 100 美元;随后全部卖出,每股 120 美元,手续费为零。两条路线都得到 1,000 美元成本、1,200 美元出售收入和 200 美元短期收益,但需要的输入文件不同。
UsTaxes 接收买入、卖出两行,再构建投资组合。OpenTaxSolver 的 Form 8949 导入器接收已经配好的出售批次,行里直接给出买入日期、出售日期、收入和成本。这个区别比“支持 CSV”更能帮助选择工作流。
这次使用 UsTaxes 公开网站的税年 2025 界面,以及 OpenTaxSolver 的税年 2025、23.07 MacM 下载包。后者的 US 1040 模块启动时显示 v23.06。范围是导入、检查和本地导出;材料全为自建合成数据,没有实际申报。UsTaxes 测到资产 CSV、JSON 备份和重新载入;OpenTaxSolver 测到计算报告和 PDF。
先准备两种含义不同的 CSV
原始交易文件 trades.csv 保留买卖动作、单价和数量:
asset,date,side,price,quantity,fee
DEMO-STOCK,2025-01-02,buy,100,10,0
DEMO-STOCK,2025-03-03,sell,120,10,0
两笔交易没有部分出售、多次买入、手续费或调整项,配对可以直接核算:成本 10 × 100 = 1000,收入 10 × 120 = 1200,收益 1200 − 1000 = 200。持有时间从 1 月 2 日到 3 月 3 日。
OpenTaxSolver 的 closed-lot.csv 把这两行整理成一笔出售记录:
Description,Date_Acquired,Date_Sold,Proceeds,Cost,Code,Adjustment
10 DEMO-STOCK,1/2/2025,3/3/2025,1200,1000,,
这里只合并了唯一的一买一卖。多批次买入、部分出售或洗售调整需要额外的批次依据,这个样本没有验证这些情况。文件格式参照下载包里的 example_f8949_spreadsheet.csv 和空白 US 1040 模板,功能出处可从官方当前税年下载页核对。
UsTaxes:先映射列,再核对组合
在 UsTaxes 选择 Start Return in Browser,确认页面上方的税年为 2025,进入 Income → Other investments。这个页面的 Load CSV File 接收交易文件,不需要先完成个人身份表单。
导入 trades.csv 后,表头不会自动成为税务字段。按原始列顺序把六列映射为 Asset Name、Transaction date、Buy or Sell、Price per unit、Quantity、Fee / commissions,并把 Drop first n rows 设成 1,跳过表头。缺少必需字段时,界面会列出仍需分配的字段。
点击 Build Portfolio 后,会出现配对后的 Portfolio;此时还需点击 Add Sales and Assets,才把结果加入资产列表。随后 Summary of sales in 2025 显示短期成本 $1,000、出售收入 $1,200、收益 $200。这两个按钮承担不同阶段:前一个便于检查配对,后一个保存到当前数据。

UsTaxes 的出售汇总与合成样本逐项一致。
两种导出保留的信息不同
资产列表的 Export 1 Assets 导出了 CSV。文件含 Security、Quantity、Open Date、Open Price、Cost basis、Close Date、Proceeds、Gain / Loss 等列,这次对应值为 10 股、1000、1200、200。它适合拿到表格里继续核对。
User Settings → Save data to file 则导出 JSON 备份。实际文件包含资产的开平仓日期、单价、数量、费用和税年状态;这次身份、工资等记录都为空。我通过同一设置页的 Load 重新载入这份文件,再进入 Other investments,汇总仍为 $200。界面提示 Load 会覆盖当前数据,实际使用前应先保存当前工作。

资产 CSV 用于查看出售记录,JSON 用于恢复这款应用的数据。
这些输出格式也说明了跨软件交接的工作量:UsTaxes 导出资产 CSV 的列名和排列,与 OpenTaxSolver 要求的七列并不一致。这次把唯一一笔出售整理成了上面的 closed-lot.csv,没有验证任意备份文件之间的自动迁移。
OpenTaxSolver:输入模板连接出售 CSV
OpenTaxSolver 的本地命令行模块可读取 US 1040 文本模板。测试保留空白身份字段,设 Status Single、工资 L1a 50000 ;、联邦预扣 L25a 6000 ;,并在 f8949_spreadsheet-A/D: 后填写 closed-lot.csv。A/D 在模板中表示成本已报给 IRS 的类别;这里只是合成测试的分类假设。
输入文本和 CSV 放在同一工作目录,然后从该目录运行包内程序:
# OTS_DIR 指向解压后的软件目录
"$OTS_DIR/bin/taxsolve_US_1040_2025" ots-input.txt
程序生成 ots-input_out.txt。报告的 Form 8949 表格列出 1200 收入、1000 成本、200 收益,Schedule D 的 D7 和 1040 的 L7a 也为 200。带上工资后,报告显示调整后总收入 50,200、标准扣除 15,750、应税收入 34,450;它计算的税额为 3,899,过付款为 2,101。这些是该输入下的软件结果,UsTaxes 路线没有填写完整身份和工资表,因此本次没有做最终税额的交叉验证。
下载包还提供 PDF 生成器。按其源码给出的参数顺序,以同一报告和包内模板生成 PDF:
"$OTS_DIR/bin/universal_pdf_file_modifier" \
"$OTS_DIR/src/formdata/f1040_meta.dat" \
ots-input_out.txt \
"$OTS_DIR/src/formdata/f1040_pdf.dat"
这次得到 14 页 new.pdf,包括程序显示供参考的附表。重新读取 PDF 并查看第 14 页的 Form 8949,合成名称、日期、1200、1000、200 均落在对应栏位,身份栏保持空白。计算过程还打印了 UNEXPECTED LABEL 'Round_PDF_to_Whole_Dollars';这是包内空白模板末尾字段触发的警告,本文保留原始报告供复核。

实际导出 PDF 的 Form 8949 页;样本未填写身份资料。打开原尺寸图片可放大检查栏位。
下载合成输入模板 · 查看实际文本报告 · 下载实际生成的 PDF
错误输入会在哪里停下来
我分别保留了缺买入、非数字数量、错误表头和非数字出售收入的文件或日志。
| 输入问题 | 实际观察 | 检查方法 |
|---|---|---|
| UsTaxes 只给卖出行 | Transaction List Import Failed,指出卖出数量超过持有量,提示补上早期买入或检查尚未支持的卖空 | 回到交易来源补齐买入历史 |
UsTaxes 数量写成 oops | Could not parse quantity value (oops) as number | 修改数量后重新构建组合 |
| OTS 用原始交易 CSV 代替出售 CSV | 报表头不符合预期,但命令退出码为 0,报告仍生成 | 搜索报告里的 ERROR,核对 8949 行和 D7 |
| OTS 从另一个目录运行,相对 CSV 路径找不到文件 | 报无法读取文件,退出码仍为 0;此次报告缺少 200 收益 | 从正确工作目录执行,或填写准确路径 |
OTS 的 Proceeds 写成 oops | 报 Bad float,退出码为 1 | 核对出售收入列的数值 |
OpenTaxSolver 的两个退出码为 0 的失败,是批处理时最容易漏掉的地方。成功报告和失败报告都可能存在;应把“CSV 已读取”“8949 出现预期出售”“D7 等于样本收益”作为一起检查的条件。
按手上的资料和需要的产物选择
| 读者任务 | 这次更直接的路线 | 仍需核对 |
|---|---|---|
| 手上是按时间排列的买入、卖出交易 | UsTaxes 映射列、构建组合,再导出资产 CSV | 多批次、费用、洗售和缺失历史,本次未测 |
| 手上已有出售批次和成本依据 | OTS 的 8949 CSV 加 US 1040 模板 | 分类、调整项和实际税务资料的适用条件 |
| 想在 UsTaxes 里备份并继续编辑 | JSON 保存后用 Load 读回 | 保存当前工作,避免覆盖现有状态 |
| 需要本地计算报告和 PDF | OTS 的计算模块与 PDF 生成器 | 每张表的数值、遗漏字段与打印效果 |
UsTaxes 项目说明描述了浏览器计算和本地存储方式;这次核对的是产品的导入、导出与重新载入,没有进行全面网络或隐私审计。州税、复杂投资规则、电子申报、支付及商业产品导入能力均未测试。
对这组资料,选择从文件的含义开始:两笔买卖走交易配对,一笔已配好的出售走 8949 导入。再用导出文件核对日期、成本、收入和收益,能把“支持导入”落实为可检查的工作流程。其他数字工具实测可从工具评测分类继续阅读。