ST4用户必须改用AlignTab插件,因Alignment已停更且不兼容;需手动触发首次对齐生成配置,统一缩进为空格,确保语法正确、选区完整,并解决快捷键冲突。

Alignment 插件在 ST4 上根本不会工作
Sublime Text 4 用户装了 Alignment 插件却按 Ctrl+Alt+A 没反应,不是配置错,是插件本身不兼容。作者已停更,ST4 的 API 变更导致它连菜单项都注册不上——Preferences → Package Settings 里压根找不到 Alignment。
必须换用 AlignTab:通过 Ctrl+Shift+P → Package Control: Install Package 装好后,它会自动生成 AlignTab.sublime-settings;首次触发需手动按 Ctrl+Shift+A(Windows/Linux)或 Cmd+Shift+A(macOS),输 = 回车,之后才能正常对齐。
- ST3 用户可继续用
Alignment,但 ST4 用户别试,白费时间 -
AlignTab默认快捷键是Ctrl+Shift+A,不是Ctrl+Alt+A;后者是旧版Alignment的绑定,ST4 下无效 - 装完
AlignTab后不重启 Sublime,命令不会加载,快捷键必然失灵
对齐前必须统一缩进为空格
对齐后反而更歪?大概率是 Tab 和空格混用。插件计算列位置时,Tab 算 1 字符,4 个空格算 4 字符,哪怕状态栏显示 Tab Width: 4,两者也完全不等价。
右下角状态栏点开,确认显示的是 Spaces: 4 而非 Tab Width: 4;若显示后者,点它切换,或执行 View → Indentation → Convert Indentation to Spaces。
- 全选代码 →
Ctrl+Shift+P→ 输入Convert Indentation to Spaces,强制归一化 - 再执行
Convert Line Endings → Unix,避免\r\n干扰列计算 - 对齐前先
Ctrl+Shift+P→Trim Trailing White Space,删掉行尾空格和注释干扰
选中区域必须满足“每行含锚点字符”
AlignTab 和 Alignment 都只处理「每行至少出现一次 alignment_chars 中定义的字符」的行。漏选、跨空行、某行少写一个 =,都会导致该行被跳过,其余行强行对齐,视觉上就“歪了”。
鼠标拖选容易漏掉换行符,建议改用 Ctrl+L 多次选中整行,再 Ctrl+Shift+L 拆多光标,确保逻辑行完整;状态栏显示 Plain text 时插件静默失效,务必点它切到对应语言语法(如 JavaScript、Python)。
- 不要全选整个文件,只框住目标块(比如连续 5 行变量赋值)
- 含
# comment或//的行,若想对齐,得确保=出现在注释前,否则会被跳过 - Markdown 表格别硬套这个插件,用
Table Editor,按Ctrl+Alt+T才是对的
快捷键冲突是高频卡点
Ctrl+Shift+A 在 ST4 常被 Emmet 或 SideBarEnhancements 占用,按了没反应,其实是命令被劫持了。
打开 Preferences → Key Bindings,右侧面板搜 ctrl+shift+a 或 align_tab,看是否有重复绑定;若有,删掉冲突项,或在用户配置里明确覆盖:
[{"keys": ["ctrl+shift+a"], "command": "align_tab", "args": {"user_input": "="}}]- Mac 用户慎用
Cmd+Ctrl+A,系统截图快捷键会拦截,改用Cmd+Option+A并同步更新配置 - 如果装了多个对齐类插件(比如同时有
AlignTab和Alignment),卸载掉不用的那个,避免命令混淆 - 临时验证是否生效:用
Ctrl+Shift+P输入Align Tab,手动运行一次,看是否成功
对齐不是“一键完事”,而是缩进、选区、语法、快捷键四者严丝合缝的结果。最容易被忽略的是:ST4 必须用 AlignTab,且首次触发要手动输符号生成配置——跳过这步,后面全白搭。


















