应安装 TableEditor(无下划线),而非 TableEditor_sublime;手动下载 vkocubinsky 版解压至 Packages 目录,重命名为 TableEditor,重启后用 Ctrl+Shift+P 调用对齐命令。

TableEditor_sublime 插件根本不能直接安装
它没有发布到 Package Control 官方仓库,搜不到、点不着、一键安装会失败。别在 Preferences → Package Control → Install Package 里白费时间找 TableEditor_sublime —— 这个名字压根不会出现。
真正能用的,是社区维护的 TableEditor(无后缀 _sublime),作者是 wbond(Package Control 作者)和 facelessuser 等人。名字差一个下划线,就完全不是同一个东西。
- 搜
TableEditor_sublime或Sublime Table Editor是常见误操作,结果是空列表或装错旧版/分叉版 - GitHub 上叫
TableEditor_sublime的仓库早已归档、停止更新,最新提交在 2016 年,不兼容 Sublime Text 4 - 正确插件主页是:
https://github.com/vkocubinsky/SublimeTableEditor(注意作者名vkocubinsky)—— 但它也不叫TableEditor_sublime,只是常被这么口误称呼
手动安装 TableEditor(vkocubinsky 版)的三步实操
这是目前唯一稳定支持 ST4、能自动对齐 Markdown/CSV/TXT 表格的版本。必须走「手动下载 + 解压到 Packages 目录」这条路。
- 打开 GitHub 项目页:
https://github.com/vkocubinsky/SublimeTableEditor - 点
Code → Download ZIP,解压后得到文件夹,重命名为TableEditor(去掉版本号和 hyphen) - 把整个
TableEditor文件夹拖进 Sublime 的Packages目录:
macOS:~/Library/Application Support/Sublime Text/Packages/
Windows:%APPDATA%\Sublime Text\Packages\
Linux:~/.config/sublime-text/Packages/ - 重启 Sublime,按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入TableEditor: Align Table测试是否生效
对齐表格时为什么光标位置影响结果
TableEditor 不是全局扫描整文件,而是以当前光标所在行为中心,向上找表头分隔行(如 |---|---|),向下找内容行,只处理“连续的、格式一致的块”。光标放错地方,它就对不齐。
- 光标必须放在表格内部任意一行(不能在空行、注释行或代码块外)
- 如果表格用空行隔开,它默认只处理当前段落内的连续行;跨空行需手动选中全部再触发命令
- 支持的分隔符:竖线
|、冒号:(用于对齐)、连字符-(用于表头分隔);但不识别+或=开头的 AsciiDoc 风格 - Markdown 表格里混用空格缩进或制表符会导致列宽计算错误,建议统一用空格对齐
和原生 Markdown Preview 冲突怎么办
装完 TableEditor 后,有时 Ctrl+Shift+P → Markdown Preview 会报错或不响应,原因是两者都监听了 on_modified_async 事件,且 TableEditor 的 hook 没做异常兜底。
- 临时解决:在
Preferences → Package Settings → TableEditor → Settings中,把"auto_align_on_save"设为false - 更稳的做法:禁用
TableEditor的自动对齐,只手动按快捷键Ctrl+Alt+T(默认绑定)来触发 - 如果你主要写 Markdown,建议同时装
MarkdownEditing插件,它和TableEditor兼容性更好,还能高亮表格语法










