阅读时间：约5分钟

适用人群：需要将电子表格软件导出的 CSV 数据导入 LabVIEW 的开发者，尤其适用于字段内部含有逗号、换行符或双引号等特殊字符的场景。

一、背景与问题现象

CSV（逗号分隔值）是一种被广泛使用的文本数据交换格式，多数电子表格、数据库与仪器软件都以它作为默认导出格式。其基本规则由 RFC 4180 定义：常规字段以逗号分隔，记录以换行符结束；当字段本身含有逗号、换行符或双引号时，该字段必须用双引号括起来；字段内部若出现双引号，则用连续两个双引号进行转义。

在 LabVIEW 中读取这类文件时，最简单直观的做法是使用"读取电子表格文件"函数，并在分隔符参数中填入逗号。然而对于严格按照 CSV 规范导出的数据，这种处理常常得不到预期结果。典型表现有：位于双引号内部的逗号被错误地当作字段分隔符，导致原本完整的一个字段被拆成多列；双引号内部的换行符被当作整张表格的行结束符，使后续数据全部错位；绝大多数双引号应当被剥除，但字段内由两个连续引号转义出来的引号又应当被保留。对于包含大量文本内容的记录，这类错误会直接破坏数据列与行之间的对应关系，使后续处理完全不可用。.

编辑

二、原理或机制分析

上述问题的根源在于 LabVIEW 内置的"读取电子表格文件"函数。该函数内部依托"电子表格字符串转数组"节点完成字符串到二维数组的转换，而这个节点并不支持将双引号作为转义字符。也就是说，它的分隔解析仅在单个字符层面进行：遇到指定的分隔符（逗号）就切分字段，遇到换行符就切分行，完全忽略引号的存在。这个节点早在 CSV 规范被普遍采用之前就已经编写完成，因此并不具备依据引号上下文判断分隔符是否有效的解析能力。

对 CSV 语义稍加分析即可看出，逗号、换行符和双引号这三个符号的"身份"是上下文相关的：它们处于引号之内还是之外，决定了它们应当被保留为字段内容，还是被解释为结构分隔符。仅凭逐字符的固定规则扫描，无法正确区分这两种情况，这正是需要引入带状态的解析逻辑的根本原因。理解了这一机制，就能明白为什么简单地改变分隔符参数无法解决任何与引号相关的解析错误。

三、实现方法或解决方案

既然内置函数无法满足要求，可行的途径是绕开电子表格相关节点，改为自行实现一个带状态的 CSV 解析器。具体步骤为：先用"读取文本文件"函数将整个文件一次性读入内存，得到一个字符串；再对这一字符串进行逐字符的状态机扫描，将其拆分为字段的二维数组；最后把解析结果写入二维字符串数组，供后续按列进行数据类型转换。

状态机解析的核心是维护一个"当前是否处于引号内"的布尔状态。从头到尾遍历每个字符：遇到普通字符直接并入当前字段；遇到双引号时切换引号状态；当不在引号内时，逗号表示字段结束、换行符表示记录结束；当处于引号内时，逗号与换行符都作为普通字符保留。对于双引号本身，需要区分两种情况：单个双引号用于开始或结束一个被引号包裹的字段，应作为边界处理而不写入字段内容；若当前处于引号内且紧接着又出现一个双引号，则属于转义序列，应当只保留一个双引号写入字段。扫描结束时得到的二维字符串数组即构成整张表格。

在程序框图上实现时，可以将读取到的字符串交给一个条件结构驱动的主循环，每轮取出一个字符并结合当前引号状态决定其去向。字段累积可采用字符串拼接，字段结束与记录结束处分别使用"插入到字符串数组"或"数组插入"等节点组织结果。整个逻辑可独立封装为子 VI，便于复用与测试。

四、关键设计要点或易错点

在编写解析器时，有若干细节容易被忽略。首先是空字段的处理：连续两个逗号之间没有任何字符，此时必须生成一个空字符串字段，而不是跳过或报错，否则表格列数会发生错乱。其次是行尾换行符的差异，CSV 规范允许使用回车换行或单独的换行作为记录结束符，解析时应统一识别，同时注意文件末尾常带有一个多余的换行符，应将其作为空记录删除。第三是转义引号的歧义判断，判断某一个双引号是结束符还是转义字符，必须以当前引号状态为前提，否则字段内容会多出或丢失引号。第四是文件的编码问题，若文件以带 BOM 的 UTF-8 或 ANSI 编码保存，读取字符串后需要去除 BOM 字符并确认中文内容不被乱码，必要时可先将文件按字节读取，再按指定编码解码。

此外，解析器应封装为可复用的子 VI：将文件路径或原始字符串作为输入，将二维字符串数组作为输出，解析规则集中维护，这样后续程序只需调用该子 VI 即可。测试时应使用真实的、由电子表格软件导出的样本，尤其要覆盖字段内含有换行与引号的记录，这类数据最能暴露解析器的缺陷。

五、实践建议与小结

总结来看，LabVIEW 读取 CSV 文件应根据数据复杂程度选择不同策略。当字段中不含逗号、换行符或引号时，直接使用"读取电子表格文件"函数最为省事；一旦数据由电子表格软件按规范导出，且字段内包含特殊符号，就必须采用自定义的状态机解析。该解析逻辑可以完全用字符串函数与条件结构在程序框图上实现，不依赖任何外部库，维护成本可控。

归根结底，CSV 解析的难点不在语法本身，而在于对引号上下文状态的正确追踪。把握住"状态决定符号含义"这一原则，即可在 LabVIEW 中稳定地处理任何符合规范的 CSV 文件。