CsvReader 多重載建構函數參數詳解：分隔符、引號、逸出、註解、緩衝區一次看懂

LumenWorks CsvReader 提供 7 個建構函數重載，參數組合靈活但文檔分散。本文將所有重載參數彙整為對照表，並以實際場景說明何時使用哪個重載，助你快速選擇正確簽名。

七大重載完整對照表

參數深度解析

1. hasHeaders (bool)

• true：第一列視為標題，GetFieldHeaders() 可取得欄位名，ReadNextRecord() 從第二列開始。
• false：無標題，欄位索引從 0 起算，GetFieldHeaders() 回傳 null。

2. delimiter (char)

• 常見值：',' (CSV)、'\t' (TSV)、';' (歐洲 CSV)、'|' (管線分隔)。
• 若資料中包含分隔符，必須搭配 quote 包裹。

3. quote / escape (char)

• 預設雙引號 '\"' 同時作為引號與逸出（雙重逸出："" 代表一個引號）。
• 若來源使用單引號包裹、反斜線逸出，可分別傳入 '\''、'\\'。

4. comment (char)

• 行首出現該字元視為註解，整行跳過。預設 '#'。
• 若檔案無註解行，可傳入 '\0' 或不支援註解的重載。

5. ValueTrimmingOptions (enum)

6. bufferSize (int)

• 單位：位元組。預設 4096 (4KB)。
• 大檔案建議 65536 (64KB) 或 131072 (128KB)，減少系統呼叫次數。
• 過大可能增加記憶體壓力，建議實測調整。

場景化選擇指南

1. 標準 CSV、小檔案：new CsvReader(reader, true)
2. TSV 檔案：new CsvReader(reader, true, '\t')
3. 大檔案 (GB 級)：new CsvReader(reader, true, ',', 131072)
4. 舊系統匯出：單引號包裹、反斜線逸出、含註解行：
   new CsvReader(reader, true, ',', '\'', '\\', '#', ValueTrimmingOptions.Trim, 65536)

快速驗證技巧

// 列印前 3 列原始欄位，確認解析正確
for (int i = 0; i < 3 && csv.ReadNextRecord(); i++) {
    for (int j = 0; j < csv.FieldCount; j++) {
        Console.WriteLine($"[{j}] = '{csv[j]}'");
    }
    Console.WriteLine("---");
}

總結

掌握 CsvReader 七大重載的參數語意，關鍵在於識別「分隔符、引號/逸出規則、註解、修剪策略、緩衝區」五大變數。依實際檔案格式由簡入繁選擇重載，並在正式匯入前用前 3 列驗證，即可避免 90% 的解析錯誤。