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 结构，就得先人工规整一遍。自动化边界很明确，越界就得自己兜底。
