Merge pull request #4981 from VisActor/fix/csv_escape

fix(csv): handle escape option correctly for CSV export

Author: fangsmile

common/changes/@visactor/vtable/fix-csv_escape_2026-02-02-07-32.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@visactor/vtable",
+      "comment": "fix(csv): handle escape option correctly for CSV export",
+      "type": "none"
+    }
+  ],
+  "packageName": "@visactor/vtable"
+}

docs/assets/guide/en/plugin/table-export.md

@@ -41,7 +41,7 @@ export type ExportVTableToExcelOptions = {
 
 export type ExportVTableToCsvOptions = {
   formatExportOutput?: (cellInfo: CellInfo) => string | undefined;
-  escape?: boolean;
+  escape?: boolean; // Whether to escape special symbols in strings to avoid interfering with CSV parsing, default true
   exportAllData?: boolean;
   downloadFile?: boolean;
   fileName?: string;

docs/assets/guide/zh/plugin/table-export.md

@@ -41,7 +41,7 @@ export type ExportVTableToExcelOptions = {
 
 export type ExportVTableToCsvOptions = {
   formatExportOutput?: (cellInfo: CellInfo) => string | undefined;
-  escape?: boolean;
+  escape?: boolean; // 是否需要将字符串中的特殊符号进行转义，以避免干扰CSV解析，默认为true
   exportAllData?: boolean;
   downloadFile?: boolean;
   fileName?: string;

packages/vtable-export/src/csv/index.ts

@@ -77,7 +77,7 @@ function getCopyCellValue(
   }
 
   let value = cellValue;
-  if (option?.escape) {
+  if (option?.escape !== false) {
     value = escapeForCSV(value);
   } else if (typeof value === 'string') {
     value = '"' + value + '"';

packages/vtable-plugins/src/table-export/csv/index.ts

@@ -81,7 +81,8 @@ function getCopyCellValue(
   }
 
   let value = cellValue;
-  if (option?.escape) {
+  if (option?.escape !== false) {
+    //escape默认逻辑改为true，进行转义
     value = escapeForCSV(value);
   } else if (typeof value === 'string') {
     value = '"' + value + '"';