Go中处理CSV分号：避免单元格拆分的解决方案

在Go的HTTP处理器中生成CSV并返回时，部分字段包含分号（如google;gmail、https://www.goo;gle.com/），用Excel等工具打开时，这些字段会被拆分为多个单元格，而非保留在单个单元格内。要求无需修改用户的CSV查看器设置，且用双引号包裹字段时，打开文件不会显式看到引号。

当前代码如下：

func routeReferencesCrossrefDownloadPost(w http.ResponseWriter, r *http.Request) {
    var req DownloadRequest
    if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
        fmt.Println("JSON Decode Error:", err)
        http.Error(w, "Invalid request", http.StatusBadRequest)
        return
    }

    w.Header().Set("Content-Type", "text/csv")
    w.Header().Set("Content-Disposition", `attachment; filename="search_items.csv"`)

    writer := csv.NewWriter(w)
    defer writer.Flush()

    writer.Write([]string{"#", "Name", "URL"})

    name := "google;gmail"
    URL := "https://www.goo;gle.com/"
    for i := 0; i < 5; i++ {
        writer.Write([]string{
            fmt.Sprintf("%d", i+1),
            name,
            URL,
        })
    }
}

解决方案 #

问题核心是CSV中的特殊字符（分号）未被正确引用，导致Excel误将其识别为单元格分隔符。以下两种方案可解决该问题：

方案1：将CSV分隔符设为分号

部分地区的Excel默认以分号作为CSV分隔符，将Writer的分隔符改为分号后，含分号的字段会被自动用双引号包裹，Excel解析时会将引号内的内容视为单个单元格，且不会显示引号。

修改代码如下：

func routeReferencesCrossrefDownloadPost(w http.ResponseWriter, r *http.Request) {
    var req DownloadRequest
    if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
        fmt.Println("JSON Decode Error:", err)
        http.Error(w, "Invalid request", http.StatusBadRequest)
        return
    }

    // 补充charset避免乱码，适配多语言场景
    w.Header().Set("Content-Type", "text/csv; charset=utf-8")
    w.Header().Set("Content-Disposition", `attachment; filename="search_items.csv"`)

    writer := csv.NewWriter(w)
    // 设置CSV分隔符为分号
    writer.Comma = ';'
    // 启用CRLF换行，适配Windows系统的Excel
    writer.UseCRLF = true
    defer writer.Flush()

    writer.Write([]string{"#", "Name", "URL"})

    name := "google;gmail"
    URL := "https://www.goo;gle.com/"
    for i := 0; i < 5; i++ {
        writer.Write([]string{
            fmt.Sprintf("%d", i+1),
            name,
            URL,
        })
    }
}

方案2：强制所有字段用双引号包裹

保持默认逗号分隔符，设置QuotePolicy为csv.QuoteAlways，让所有字段都被双引号包裹。这样无论Excel使用逗号还是分号作为分隔符，都会将引号内的内容视为单个单元格，且打开时不会显示引号。

修改代码如下：

func routeReferencesCrossrefDownloadPost(w http.ResponseWriter, r *http.Request) {
    var req DownloadRequest
    if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
        fmt.Println("JSON Decode Error:", err)
        http.Error(w, "Invalid request", http.StatusBadRequest)
        return
    }

    w.Header().Set("Content-Type", "text/csv; charset=utf-8")
    w.Header().Set("Content-Disposition", `attachment; filename="search_items.csv"`)

    writer := csv.NewWriter(w)
    // 强制所有字段用双引号包裹
    writer.QuotePolicy = csv.QuoteAlways
    writer.UseCRLF = true
    defer writer.Flush()

    writer.Write([]string{"#", "Name", "URL"})

    name := "google;gmail"
    URL := "https://www.goo;gle.com/"
    for i := 0; i < 5; i++ {
        writer.Write([]string{
            fmt.Sprintf("%d", i+1),
            name,
            URL,
        })
    }
}

关键说明 #

• UseCRLF设置为true是为了适配Windows系统的换行规则，避免Excel打开时出现换行异常。
• 补充charset=utf-8到Content-Type中，可避免中文等非ASCII字符出现乱码。
• 两种方案生成的CSV在Excel中打开时，均不会显式显示双引号，仅将其作为字段边界标识。

内容的提问来源于stack exchange，提问作者user275472