vscode本身不执行node代码，报错因误入浏览器环境或未在终端运行node命令；正确做法是ctrl+`打开内置终端，确认node -v可用后执行node your-script.js，避免双击文件或使用run code插件。
VSCode里直接运行Node脚本读CSV会报错？先确认执行环境
VSCode本身不执行Node代码，它只是编辑器。你看到的“无法运行”或ReferenceError: require is not defined，大概率是因为你在浏览器环境（比如HTML文件里）写了Node代码，或者没在终端里启动Node进程。
正确做法是：打开VSCode内置终端（Ctrl+`），确保当前目录下有package.json，然后运行node your-script.js。别双击JS文件、也别用“Run Code”插件直接执行——那默认走的是浏览器上下文。
- 检查终端左上角是否显示类似
node v18.17.0的版本号；没有就先运行node -v - 如果提示
command not found: node，说明Node没加进系统PATH，需重装或手动配置 - 脚本开头别写
#!/usr/bin/env node——Windows不认这个，跨平台项目建议删掉
选哪个npm包解析CSV？neat-csv vs csv-parse vs csv
三个主流包都可用，但行为差异明显，选错会导致中文乱码、空行跳过、引号字段截断等问题。
neat-csv最轻量，适合小文件（csv-parse（来自csv组织）功能全、流式处理友好、对BOM和编码更鲁棒；csv（旧版，作者已归档）存在已知的转义缺陷，不建议新项目使用。
- 中文字段出乱码？优先用
csv-parse，配合encoding: 'utf8'或encoding: 'gbk'显式指定 - 需要边读边处理大文件（比如逐行写入数据库）？用
csv-parse的fromStream+fs.createReadStream - 只是读一个几百行的配置CSV，想一行搞定？
neat-csv的await neatCsv(fs.readFileSync(...))更直白
中文乱码、科学计数法、日期被转成时间戳？关键在解析选项
不是文件本身坏了，是解析器按默认规则“好心办坏事”。比如Excel导出的CSV常用GBK编码，而Node默认按UTF-8读；又比如csv-parse默认把纯数字字段转成number类型，123456789012就变1.23456789012e+11。
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
解决方法必须写进代码里，不能只调包：
- 读文件时用
fs.readFileSync(path, 'binary')，再用new TextDecoder('gbk').decode()解码（适用于GBK/GB2312） - 传给
csvParse时加{ columns: true, skipEmptyLines: true, cast: false }——cast: false禁用自动类型转换 - 若首行是表头且含中文，确保
columns: true开启，否则第一行会被当数据丢掉 - 遇到
Invalid or unexpected token错误，八成是BOM头，用data.toString().replace(/^\uFEFF/, '')清理
VSCode里调试CSV解析脚本卡住？别让大文件拖垮Node内存
VSCode调试器（F5）跑fs.readFileSync读100MB CSV，大概率直接卡死或崩溃。这不是VSCode的问题，是Node单次加载大文件的内存限制所致。
真实场景中，应切换为流式处理：
- 用
fs.createReadStream代替fs.readFileSync - 搭配
csv-parse的parseStream方法，每解析一行触发一次on('readable')或on('data') - VSCode调试时，在
on('data')回调里打断点，能看清每行原始值，不会因加载全部内容而卡顿 - 预览前10行验证格式？用终端命令
head -n 10 your.csv，比在VSCode里等加载快得多
真正麻烦的从来不是语法，而是编码、分隔符、转义字符、空行这些隐性细节——它们不会报错，但会让输出结果和你预期差一条数据。动手前，先用file -i your.csv（Linux/macOS）或VSCode右下角编码标识确认真实编码，比反复改代码高效得多。
