AlignTab 必须重启 Sublime Text 才生效,默认快捷键为 ctrl+alt+a(Windows/Linux)或 cmd+ctrl+a(macOS);需配置 alignment_chars 为 ["=", ":"] 等才能对齐等号或冒号;避免与 Alignment 插件共存,且选区须为纯文本、非只读、缩进统一。

AlignTab 快捷键默认就是 ctrl+alt+a,但必须重启才生效
装完 AlignTab 后,别急着选中代码按 ctrl+alt+a(Windows/Linux)或 cmd+ctrl+a(macOS)。它不会立刻响应——因为插件命令注册依赖 Sublime Text 完整启动流程,只重载窗口或刷新语法高亮没用。必须彻底退出 Sublime Text,再重新打开。
重启后,选中多行含 = 或 : 的文本(比如 Python 赋值、YAML 键值对),直接按快捷键,光标会自动停在对齐位置右侧,完成列对齐。
- 确认右下角状态栏不是
Plain text,否则 AlignTab 可能跳过处理 - 如果按了没反应,先打开控制台(
ctrl+`),看有没有报错;没有报错却无响应,90% 是没重启 - 别和旧插件 Alignment 共存:两者都注册
ctrl+alt+a,ST4 会静默丢弃后加载的那个
想对齐 = 或 :,必须改 alignment_chars 配置
AlignTab 默认只按空白字符对齐,不识别等号、冒号。你看到“对齐没效果”,大概率是配置没动过。
菜单栏 → Preferences → Package Settings → AlignTab → Settings,在右侧用户配置里填入:
{
"alignment_chars": ["=", ":"],
"alignment_space": 1,
"align_indents": false
}
注意三点:
-
"alignment_chars"必须是字符串数组,"="和":"要加双引号、逗号分隔 -
"align_indents": false很关键——设为true会让缩进空格也被当对齐目标,结果错乱 - 改完保存即可,不用重启,但已选中的文本要取消再重选,新配置才会应用
自己配快捷键?优先用 ctrl+alt+a,别覆盖 ctrl+d 这类高频键
没必要重绑 AlignTab 的快捷键。它的默认 ctrl+alt+a 冲突率低、易记,且 ST4 没把它分配给其他功能。
如果你真要自定义,务必通过 Preferences → Key Bindings 编辑右侧 User.sublime-keymap,内容必须是合法 JSON 数组:
[{"keys": ["ctrl+shift+q"], "command": "align_tab"}]
关键提醒:
- 命令名是
"align_tab",不是"align"或"alignment",输错就无效 - 别碰
ctrl+d、ctrl+shift+d这些原生多光标键——覆盖后日常选中效率断崖下跌 - 如果快捷键没反应,先检查右下角是否显示红字(JSON 格式错误),再确认是否被系统输入法拦截
对齐失败时,先查这三处硬性前提
AlignTab 不是智能解析器,它只做字符串级匹配。失败几乎从不因为插件本身,而是环境或操作越界:
- 文件是只读状态(右下角显示
RO)→ 对齐命令直接被忽略 - 选区跨了折叠代码块、Markdown 表格、或嵌入的 HTML 注释 → AlignTab 不处理非纯文本区域
- 混用了 Tab 和空格缩进 → 插件可能因行首空白不一致而放弃对齐逻辑(尤其
align_indents: true时)
真正难调的点不在插件配置,而在你选中的那几行文本是否“干净”:无隐藏控制字符、无语法高亮干扰、无意外换行符。对齐前手动执行一次 Convert Indentation to Spaces,往往比调十次配置更有效。


















