data preview插件需手动触发预览，不自动激活；常见问题包括文件后缀未识别、超5mb限制、焦点不在文件页；csv与json解析逻辑不同，中文乱码因编码不匹配，卡顿因内存渲染限制。
为什么装了 Data Preview 插件却打不开 CSV 文件？
因为插件默认不自动激活预览，必须手动右键或用快捷键触发。VSCode 本身不会像 Excel 那样双击就弹窗，Data Preview 是一个“按需启动”的轻量工具，不是后台常驻服务。
常见错误现象：Cannot preview this file 错误提示，通常是因为文件后缀未被识别（比如用 .txt 存 CSV 内容）、文件过大（默认限制 5MB）、或当前编辑器焦点不在该文件标签页上。
- 确保文件扩展名是
.csv、.tsv、.json或.xlsx（后者需额外安装依赖） - 右键编辑器内空白处 → 选择
Preview Data；或选中文件标签页后按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并运行Data Preview: Show Preview - 若文件超限，可在设置中搜索
data-preview.maxFileSize，修改为更大值（单位字节），但注意内存占用会上升
JSON 和 CSV 的预览行为为什么不一样？
Data Preview 对不同格式的解析逻辑差异明显：CSV 按分隔符切行、默认第一行为列头；JSON 则只支持扁平结构的数组（即 [{"a":1,"b":2},...]），嵌套对象或非数组根节点会直接报错 Invalid JSON structure for preview。
使用场景差异：
- CSV：适合快速检查清洗后的表格数据，支持排序、筛选（点击列头）、导出为 Excel（右键菜单）
- JSON：仅用于验证数组结构是否合规，不支持展开嵌套字段，也不渲染
null或undefined值（显示为空白） - 如果 JSON 是单个对象（如
{"users":[...]}），需先用正则或脚本提取数组部分，再另存为新文件才能预览
如何让 Data Preview 正确识别中文 CSV？
默认编码是 UTF-8，但 Windows 记事本保存的 CSV 常带 BOM 或用 GBK 编码，导致中文全变成乱码或列错位。这不是插件 bug，而是编码未对齐。
实操建议：
- 用 VSCode 打开文件后，右下角状态栏点击当前编码（如
UTF-8），选择Reopen with Encoding→GBK或GB2312；确认显示正常后再右键预览 - 更彻底的解法：在 VSCode 设置中添加
"files.autoGuessEncoding": true，让编辑器自动探测编码（但对混合编码文件仍可能失败） - 避免源头问题：用 Python/Pandas 保存 CSV 时显式指定
encoding='utf-8-sig'（加 BOM）或encoding='utf-8'（无 BOM），比依赖自动识别更可靠
预览卡顿或崩溃，是不是插件太重？
不是插件本身重，而是它把整个文件读进内存做前端渲染。5MB CSV 在浏览器环境里已接近性能临界点，尤其当列数 >100 或含长文本字段时，Webview 渲染会明显延迟甚至无响应。
可尝试的缓解方式：
- 用命令
Data Preview: Show Preview (Limited Rows)（快捷键Ctrl+Alt+P）强制只加载前 1000 行 - 在设置中开启
data-preview.enableVirtualScrolling（默认 false），启用虚拟滚动后，即使 10 万行也只渲染可视区域 - 真正大批量分析别依赖预览——它不是替代
pandas或DBeaver的工具，只是调试小样本的“快照”
容易被忽略的一点：预览窗口关闭后，VSCode 不会自动释放关联的 Webview 进程，反复开关多次可能导致内存残留。遇到卡顿时，可执行 Developer: Reload Window 强制清理。
