CSV Table Toggle
一个轻量的 VS Code CSV 表格预览扩展。它不需要 Python、Jupyter 或网络服务,公式和字体资源均离线打包。
使用方式
- 正常打开一个
.csv 文件。
- 点击编辑器右上角的表格图标(
Open as Table)。
- 再点击右上角的代码图标(
Open as Text)即可回到原始文本。
表格视图也提供搜索框和“文本视图”按钮。扩展会自动识别逗号、Tab、分号和竖线分隔符,并支持引号字段、转义双引号、字段内换行以及 Excel 的 sep=; 声明。
Markdown 与 LaTeX
打开表格工具栏中的 LaTeX 开关,可渲染同一个单元格内的 Markdown 文字和数学公式;再次关闭会恢复原始文本。支持:
- 行内公式:
$...$、\\(...\\)
- 块级公式:
$$...$$、\\[...\\]
- 常见环境:
equation、align、alignat、gather、CD,包括常用的星号版本
- 分式、根式、上下标、矩阵、分段函数、求和积分、希腊字母、
\\text{}、\\boxed{} 等 KaTeX 支持的命令
为了安全,原始 HTML 和可加载外部资源的 LaTeX 命令不会执行。无法识别的公式会保留为可读源码,不影响其余单元格。
公式会按当前可见区域懒渲染,并以小批次执行;即使 CSV 中有大量长文本,开启开关也不会一次性计算整张表格。
如果单元格内容是 JSON,扩展会先解析 JSON,再递归渲染对象或数组中字符串里的公式。例如 {"answer":"结果为 $\\frac{1}{2}$"} 可以直接显示为结构化内容和可读公式。对于 latex、tex、math、formula、equation 等字段,也支持不带 $...$ 的纯 LaTeX 值,例如 {"latex":"\\frac{1}{2}"}。
扩展也会容错处理经过 CSV 再次转义的类 JSON,例如 [{""error\\_type"":""计算错误"",""explanation"":""$a=\\\\\\frac{1}{2}$""}]。其中重复引号、三反斜杠以及公式中的 \\_ 会在渲染前恢复,但源 CSV 不会被修改。大型 JSON 单元格中的字符串公式会继续分批渲染,避免集中计算造成界面无响应。
表格视图目前是只读预览。回到文本视图后,可继续使用 VS Code 原生编辑、撤销、保存和格式化能力;切换视图不会改写 CSV 文件。
本地运行
- 用 VS Code 打开本目录。
- 按
F5,选择“运行 CSV Table Toggle”。
- 在新打开的 Extension Development Host 窗口中打开 CSV 文件。
运行解析器测试:
npm test
设置
csvTableToggle.maxRows:表格最多渲染的行数,默认 10,000。
csvTableToggle.maxColumns:表格最多渲染的列数,默认 200。
csvTableToggle.renderLatex:进入表格时是否默认开启 Markdown/LaTeX 渲染,默认关闭。
这些限制只影响预览,不会截断或修改源文件。
| |