Go csv.Reader TrimLeadingSpace 处理字段前导空格的规则与引号边界

Go 读取 CSV 时，字段分隔符后面常混入空格或制表符。csv.Reader.TrimLeadingSpace 可以忽略字段开始处的空白，但它不是“清洗所有字符串”的开关：带引号字段里的空格仍可能是业务数据。实际使用时，应先按输入契约决定是否开启，再用一组同时包含普通字段和引号字段的样例确认边界。

官方文档：https://pkg.go.dev/encoding/csv#Reader

先区分字段前导空白和引号内数据

CSV 解析器面对的是“字段语法”，不是一串可以直接调用 strings.TrimSpace 的文本。比如下面三行的空格含义不同：alice, 42 中第二列前的空格可能只是排版；" 42" 中的空格位于引号内容里，可能就是值的一部分；而 "42" 的空格出现在引号字段开始之前，属于格式边界。

因此，TrimLeadingSpace 适合处理导出工具在分隔符后统一补空格的场景。它不应被理解为“把每个字段的左右空白都删除”，尤其不能用它替代对金额、编号和固定宽度代码的字段规则说明。

用 TrimLeadingSpace 处理普通字段与空白分隔符

先从最常见的逗号分隔开始。配置必须在第一次调用 Read 前完成；读取完成后，返回的字符串已经是解析结果，不能再根据原始分隔符位置反推格式意图。

package main

import (
    "encoding/csv"
    "fmt"
    "strings"
)

func main() {
    // 第一行的第二列带有排版空格，第三列的引号内容保留内部空格。
    input := "name,  age,  note\nalice, 42,\"  keep  \"\n"
    reader := csv.NewReader(strings.NewReader(input))
    // 只忽略字段开始处的空白，不能替代业务层的字段校验。
    reader.TrimLeadingSpace = true

    record, err := reader.Read()
    if err != nil {
        // 真实导入流程应记录 ParseError 的行列信息并决定是否跳过。
        panic(err)
    }
    fmt.Printf("%q\n", record)
}

上例的关键不是输出长什么样，而是空格处于哪个语法位置：普通字段的前导空格可被忽略；引号中的两个空格随字段值保留。若业务要求备注字段也去掉两端空格，应在确认字段语义后单独处理，而不是把 CSV 语法配置当成通用清洗器。

验证带引号字段的边界行为

最容易误判的情况是把引号前的空格、引号内的空格和引号外的普通字符混在一起。可以把测试输入拆成三组：普通字段前有空格、引号字段内部有空格、分隔符使用空格。每组只验证一个结论，并把样例固定在单元测试中。

func readOne(line string, trim bool) ([]string, error) {
    // 每次创建独立 Reader，避免前一次读取位置影响当前断言。
    reader := csv.NewReader(strings.NewReader(line))
    reader.TrimLeadingSpace = trim
    // Read 只返回一条记录，便于把字段边界和测试名称对应起来。
    return reader.Read()
}

func example() {
    record, err := readOne("id, \"  A-17  \"", true)
    if err != nil {
        // 解析失败时保留错误，不用空切片掩盖输入问题。
        fmt.Println("parse error:", err)
        return
    }
    fmt.Printf("id=%q note=%q\n", record[0], record[1])
}

测试应断言字段值，而不是只断言没有错误。特别是第二列，如果它代表展示名称，内部空格可能不可丢失；如果它代表规范化标识，则应在业务层明确调用专门的规范化函数。这样可以把“CSV 格式兼容”和“业务字段清洗”分成两个可维护的决策。

按输入契约选择关闭或开启

可以用下面的检查清单做最后决定：

生产导入建议保留一组包含空格、引号、空字段和异常行的回归样例。这样升级解析逻辑或更换上游导出工具时，能及时发现是输入格式变了，还是业务清洗规则误伤了值。

常见问题

TrimLeadingSpace 会删除字段末尾空格吗？

不会。它关注字段开始处的空白，字段末尾是否保留要结合 CSV 引号语法和业务层处理判断。

开启后为什么引号内的空格还在？

因为引号内属于字段内容，不是字段开始处的分隔格式。需要清洗时，应在确认字段语义后显式处理。

TrimLeadingSpace 能解决列数不一致吗？

不能。列数一致性由 FieldsPerRecord 等设置决定，两者应分别测试、分别记录错误。