VSCode调试Node.js CSV脚本的关键是正确配置PATH和launch.json：macOS/Linux需在~/.zshrc中导出node路径并重启VSCode，Windows需将Node路径加入系统PATH；program字段须指向正确JS/TS文件路径，TypeScript项目需启用sourceMap；中文乱码需显式指定GBK编码，断点失效需避免nodemon/ts-node直接运行而改用attach模式。
VSCode 本身不解析 CSV，Node.js 也不直接“解析 CSV”——你真正需要的是：在 VSCode 里能可靠运行、调试一个用 Node.js 读取/处理 CSV 的脚本。配置的关键不是“让 VSCode 解析 CSV”，而是确保 node 能正确执行你的 CSV 处理代码，并且调试器能跟进去。
node -v 在终端有效，但 F5 调试报 command not found
这不是插件或 launch.json 写错了，是 VSCode 没继承 shell 的 PATH。macOS/Linux 下它根本没加载 ~/.zshrc 或 ~/.bash_profile；Windows 下则是系统 PATH 没包含 Node 安装路径。
- 先在 VSCode 内置终端（
Ctrl + `）里跑node -v—— 没输出就别往下配launch.json - macOS/Linux：运行
which node，把结果（如/opt/homebrew/bin/node）加进~/.zshrc的export PATH="...:$PATH"，然后彻底退出 VSCode，再从终端执行code .启动 - Windows：检查系统环境变量中 “系统变量 > PATH” 是否含
C:\Program Files\nodejs\；没加就手动添，或重装 Node.js 并勾选 “Add to PATH”
launch.json 中 program 字段指向 CSV 处理脚本失败
program 是调试器唯一入口，写错路径、混淆源文件和编译产物、忽略工作目录，都会导致断点不生效或找不到模块。
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
- 单文件测试：用
"program": "${file}"，适合快速验证fs.createReadStream('./data.csv') - 项目级脚本：必须写明确路径，比如
"program": "${workspaceFolder}/scripts/parse-csv.js" - TypeScript 项目：
program必须指向生成的.js文件（如dist/parse.js），不能指.ts；同时确认tsconfig.json含"sourceMap": true，且.js.map和.js在同一目录 - 加
"cwd": "${workspaceFolder}"显式设工作目录，避免require('./data.csv')因路径解析失败报Cannot find module
CSV 解析库在调试时无法断点或报错乱码
常见于用 csv-parser、papaparse 或 fast-csv 时，本质是编码或流处理模式没对齐。
- 中文乱码：Node 默认按 UTF-8 读文件，若 CSV 是 GBK 编码，需显式指定编码：
fs.createReadStream('data.csv', { encoding: 'gbk' }) - 断点跳过：检查是否用了
nodemon或ts-node启动——VSCode 默认launch模式不兼容它们的进程模型 -
nodemon场景：删掉runtimeExecutable，改用attach模式——终端先跑nodemon --inspect-brk scripts/parse-csv.js，再在launch.json新增request: "attach"配置连过去 -
ts-node场景：用type: "pwa-node"，配"runtimeExecutable": "npx"和"runtimeArgs": ["ts-node", "scripts/parse-csv.ts"]
预览 CSV 文件 vs 运行 Node 解析脚本，别混成一件事
VSCode 插件（如 vscode-csv-preview）只负责“看”，和 Node 运行时完全无关。你在预览窗口改数据，不会影响磁盘上原始 CSV；你在 Node 脚本里 fs.writeFileSync()，也不会自动刷新预览视图。
- 想边写脚本边看效果？用
console.table()输出解析结果，比依赖预览更直接 - 大文件（>5 万行）别靠插件预览，会卡死；用命令行快速验证：
head -10 data.csv | csvformat -D '│'（需csvkit） - 编辑 CSV 时，切回文本视图（右键 →
Reopen in Text Editor），避免预览模式下复制粘贴破坏结构
最常被忽略的点：CSV 解析逻辑本身（比如字段含逗号、换行、引号）是否被库正确处理，和 VSCode 配置无关。先确保脚本能独立跑通，再谈调试——别让环境问题掩盖了数据格式问题。
