Sublime Text结合TableEditor实现表格排版

TableEditor插件不生效的常见原因包括：Sublime Text版本低于4107、未通过Package Control安装、Python环境异常、表格格式不规范（如含未转义竖线或换行）、光标未置于表格内，需按步骤排查并规整数据。

TableEditor插件安装后不生效，Ctrl+Shift+P 找不到命令

常见原因是插件未正确加载或 Sublime Text 版本兼容问题。TableEditor 仅支持 Sublime Text 4（build 4107 及以上），旧版 ST3 无法运行最新版插件。

• 确认版本：Sublime Text → Help → About，显示 build 号低于 4107 就必须升级
• 安装方式必须用 Package Control：按 Ctrl+Shift+P → 输入 Package Control: Install Package → 搜索并安装 TableEditor，手动解压到 Packages/ 目录会失败
• 安装后重启 Sublime Text，再按 Ctrl+Shift+P 搜索 TableEditor: 开头的命令（如 TableEditor: Align Table）
• 如果仍不出现，检查控制台（Ctrl+`）是否有 ImportError 或 no module named 'table_editor'，说明 Python 环境异常，重装插件或清空 Cache/ 目录可解决

粘贴 CSV 数据后表格不对齐，TableEditor: Align Table 没反应

TableEditor 默认只处理以竖线 | 分隔的 Markdown 表格，对逗号分隔的 CSV 不自动识别——它不是 CSV 解析器，而是表格格式化工具。

• 先手动把 CSV 转成管道表：替换 , 为 | ，首尾加 |，例如 a,b,c → | a | b | c |
• 确保每行字段数一致，缺失列要补空格或 ，否则 Align Table 会跳过该行
• 光标需位于表格区域内（任意一行内），不能在空行或代码块外执行命令
• 若使用制表符 t 分隔，需先全局替换 t 为 | ，TableEditor 不原生支持 tab 分隔

Markdown 表格里含换行或代码块，TableEditor: Align Table 报错或错乱

TableEditor 对嵌套结构无解析能力，遇到 ```、n、HTML 标签或未转义的竖线 | 会中断对齐逻辑。

• 编辑前先临时移除或注释掉多行内容：把 ``` 块换成单行描述，或把换行符替换成 <br>（仅限 HTML 表格场景）
• 表格内含竖线时必须转义：|，否则被误判为列分隔符
• 对齐后如需恢复复杂内容，建议在对齐完成后再逐字段粘贴回原内容，避免直接编辑中间列导致结构偏移
• 开启 "table_editor_preserve_spaces": true 配置项可防止首尾空格被删，但不会解决换行问题

导出为 HTML 或 LaTeX 时样式丢失或列宽异常

TableEditor 自带的导出功能仅生成基础结构，不包含 CSS 或 LaTeX 宏包定义，列宽由内容长度决定，无自动适配。

• TableEditor: Export as HTML 输出的是纯 <table>，需自行引入样式或在 Preferences → Package Settings → TableEditor → Settings 中配置 "html_template" 路径
• LaTeX 导出依赖 array 和 booktabs 宏包，若编译报错 ! Undefined control sequence，说明文档头部缺 usepackage{array,booktabs}
• 列宽控制只能靠手动插入 p{3cm} 类型列定义，TableEditor 不生成该语法，需导出后手工修改
• 如需响应式表格，必须在 HTML 导出后额外加 CSS 媒体查询，插件本身不处理 viewport 或 class 属性

实际用起来，最常卡住的地方不是功能不会用，而是默认假设你处理的是“干净管道表”——只要数据里混了换行、未转义符号、或者想让它猜 CSV 结构，就得先人工规整一遍。自动化边界很明确，越界就得自己兜底。