PapaParse
本篇范围
本篇聚焦 Papa Parse —— 浏览器中的 CSV 解析器：把 CSV 文本解析成 JS 数据（Papa.parse），以及把 JS 数据反解析回 CSV（Papa.unparse）。它解决的是「前端要读/写 CSV」这一类场景——用户上传 CSV、导出表格为 CSV、拉远程 CSV 报表。版本基线 Papa Parse 5.5.4；npm 包不含声明文件，TypeScript 项目另装 @types/papaparse。
Papa Parse 官方定位是「The powerful, in-browser CSV parser」。它的核心价值在于正确——CSV 不是「按逗号 split」那么简单：字段可以被引号包裹，引号内可以包含逗号、换行符，引号本身用双写 "" 转义。Papa Parse 用状态机处理这些 RFC 4180 风格边界，再叠加自动分隔符探测、流式解析与 Web Worker；只要回调不自行累积所有行，就能把峰值内存限制在当前行或数据块附近。
最该记牢的几条「现状」：核心 API 只有两个 —— Papa.parse(input, config)（CSV→JS）与 Papa.unparse(data, config)（JS→CSV）。parse 可接收字符串、浏览器 File、URL（配 download:true）、Node 可读流或 Papa.NODE_STREAM_INPUT。字符串非流式调用同步返回 { data, errors, meta }；File、下载、Worker 与 Node 流依赖回调 / 事件。header:true 让首行作字段名并自动重命名重复表头；dynamicTyping:true 会转换数字、布尔、空值和完整 ISO 日期，超出安全整数边界的数字保持字符串；step / chunk 支持增量处理；worker:true 把浏览器解析移到后台线程，但不能 pause / resume。边界要清楚：它只做 CSV，不读 .xlsx。
评价
优点
- 解析正确：完整处理引号字段内的逗号/换行、双写引号转义，远胜手写
split(',') - API 极简：核心就
parse/unparse两个方法；社区@types/papaparse提供 TypeScript 泛型 - 自动分隔符探测：
delimiter留空时从delimitersToGuess（逗号/制表符/竖线/分号等）自动识别，TSV 也能直接读 - 流式省内存：
step逐行、chunk逐块回调；不累计结果时，内存主要受当前行 / 块与业务缓冲控制 - Web Worker 不卡 UI：
worker:true把解析放后台线程，页面滚动/动画照常 - 远程友好：
download:true拉 URL，支持自定义请求头、POST body、分块下载 - 容错而非崩溃：解析错误收进
errors数组、不抛异常中断，data仍尽量返回 - 同构可用：浏览器有 File/Worker，Node 有可读流与
NODE_STREAM_INPUTDuplex 流，可.pipe() - 安全选项：
unparse的escapeFormulae挡住 Excel/Sheets 的 CSV 公式注入
缺点
- 只做 CSV：不解析 Excel
.xlsx、不处理 JSON/XML/YAML，超出范围要换库（SheetJS 等） - 默认值都是字符串：不开
dynamicTyping时连数字都是字符串，需自己转 dynamicTyping有坑：会把007这类前导零标识符转成7而丢前导零，标识符列要排除- Worker 限制：Worker 模式下
parser.pause()/resume()不可用（abort仍可用） fastMode易误用：数据含引号时强开fastMode会解析错误- 「有 errors ≠ 失败」：容错策略下需主动检查
result.errors.length，不能假设没异常就万事大吉