excel viewer插件不支持.xlsx文件，仅解析csv/tsv/txt等纯文本格式；需在excel中另存为utf-8编码的.csv文件，并通过插件齿轮图标正确配置分隔符、引号及启用交互模式。
Excel Viewer插件打不开.xlsx文件？检查文件路径和编码
Excel Viewer插件（Gruntfuggly.excel-viewer）本身不解析.xlsx二进制格式，它只支持纯文本表格：CSV、TSV、TXT。如果你双击一个.xlsx文件，VSCode会直接用默认系统程序打开，或报错“Unable to open xxx.xlsx — Unsupported file type”，这不是插件没装好，而是它压根不处理Office Open XML格式。
常见误操作包括：把Excel导出为.xlsx后直接拖进VSCode、用Excel另存为“CSV UTF-8”却仍保留.xlsx扩展名。正确做法是：
- 在Excel中选择「文件 → 另存为 → 浏览 → 保存类型选
CSV (Comma delimited) (*.csv)」，确保扩展名是.csv - 若含中文，务必勾选「UTF-8编码」选项（新版Excel默认开启），否则VSCode里显示乱码
- 避免用记事本另存为CSV——它会强制ANSI编码，Excel Viewer无法识别
CSV打开后字段错位、换行混乱？调整分隔符和引号设置
Excel Viewer默认按逗号,分割字段，但实际CSV可能用;、\t甚至|分隔，尤其来自欧洲语言环境或导出工具（如Power BI、某些数据库客户端）。错位表现为列对不齐、一整行被吞成单个单元格、描述字段里的换行符\n被当成分行符。
解决方法是手动指定分隔符和文本包围符：
- 右键CSV文件 → 「Open With → Excel Viewer」→ 点右上角齿轮图标 → 修改
csv.separator（例如设为;） - 同时确认
csv.quote为"（双引号），否则含逗号的字段（如"Smith, John"）会被错误切开 - 如果数据含制表符且无引号包裹，改用
csv.separator: "\t"并关闭csv.quote（设为空字符串）
想筛选/排序但右键菜单没反应？启用交互模式并注意数据结构
Excel Viewer的筛选（Filter）和排序（Sort）功能仅在「交互模式」下可用，且要求CSV是规范的首行为列名、后续为纯数据的结构。如果第一行缺失、有合并标题、或前几行是说明文字，点击列头不会弹出筛选箭头。
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
启用步骤和限制：
- 打开CSV后，点右上角
⋯→ 勾选「Enable Interactive Mode」（必须手动开启，不默认激活） - 确保第1行是纯列名（不能有空格开头、不能含公式如
=A1+B1、不能是「第1页」「汇总」这类非字段名） - 排序仅支持单列升/降序，不支持多级排序；筛选是文本模糊匹配，不支持数字范围（如「>100」需靠外部工具预处理）
- 大文件（>5万行）响应明显变慢，此时建议用命令行+
csvkit或VSCode内置搜索替代
为什么修改了settings.json里的csv配置却不生效？插件级配置优先级更高
VSCode允许在工作区、用户、插件三级设置csv.separator等参数，但Excel Viewer**只读取插件自身配置项**（即通过右上角齿轮修改的那些），忽略全局settings.json中的同名字段。很多人在settings.json里写了"csv.separator": ";"，重启VSCode后依然按逗号解析，就是因为插件没读它。
验证和修正方式：
- 打开命令面板（
Ctrl+Shift+P）→ 输入Preferences: Configure Language Specific Settings...→ 选csv→ 在出现的[csv]块里写配置（这是唯一能覆盖插件默认值的方式） - 更稳妥的做法：直接在Excel Viewer界面点齿轮 → 修改 → 它会自动写入
extensions/excel-viewer/config.json（插件私有配置） - 注意：插件v4.0+已弃用旧版
excel-viewer.csvSeparator写法，统一用csv.separator，拼错字段名会导致静默失败
交互功能依赖数据干净、配置显式、模式手动开启——这三个条件缺一不可。别指望它像桌面Excel那样容错，它的定位是轻量查看，不是替代方案。
