alignment插件正确安装需搜完整单词“alignment”(作者wbond),若搜不到则手动下载解压重命名后拖入packages目录;快捷键ctrl+alt+a需在用户键绑定中配置为{"keys":["ctrl+alt+a"],"command":"alignment"};对齐等号需在settings–user中设"align_indent":false和"alignment_chars":["="]。

Alignment插件装不上?先确认 Package Control 搜索关键词
直接搜 Align 或 Aligner 会装错——Alignment(作者 wbond)才是正解。Package Control 里拼写必须是完整单词 Alignment,少一个字母或换用同义词都会命中其他不稳定插件。
如果搜不到,说明 Sublime Text 4 默认屏蔽了未签名包。此时要手动安装:
去 https://github.com/wbond/sublime_alignment 下载 ZIP → 解压 → 文件夹重命名为 Alignment → 打开 Preferences → Browse Packages… → 把文件夹拖进去 → 关闭再打开当前文件(不需重启整个 Sublime)。
- 装完验证:按
Ctrl+Shift+P输入alignment,能出现Alignment命令即成功 - 别试
AlignTab或CodeAlign:前者依赖 Python 环境且多行赋值易错位,后者对self.long_var = 1这类带点号的变量名识别不准
Ctrl+Alt+A 没反应?快捷键被系统或插件劫持了
Sublime Text 4 默认把 Ctrl+Alt+A 绑定为「全选」,直接覆盖了 Alignment 的触发逻辑。必须手动重绑:
打开 Preferences → Key Bindings,在右侧用户配置中加一行:
[ {"keys": ["ctrl+alt+a"], "command": "alignment"} ]
注意:command 值必须小写 alignment,大小写错误、拼成 Alignment 或 align 都无效。
- macOS 用户额外检查系统快捷键:系统设置 → 键盘 → 快捷键 → 「聚焦搜索」是否占用了
Cmd+Alt+A - 若仍无效,先关掉其他插件(尤其是格式化类),再测试
对齐后等号歪了?关键在 alignment_chars 和 align_indent
默认配置下 Alignment 只按缩进对齐,根本不管 =。必须显式告诉它你要什么:
打开 Preferences → Package Settings → Alignment → Settings – User,填入:
{ "align_indent": false, "alignment_chars": ["="] }
align_indent 设为 false 是硬性要求——否则它优先拉齐空格列,你写的 = 就被无视了。
-
alignment_chars是数组,每个符号用双引号包裹,逗号不能省略 - 想同时支持
=和:(比如字典或 JSON),写成["=", ":"]即可 - 别写
==在=前面——=会提前匹配,==永远不会生效
对齐结果错位?八成是选区或空白字符惹的祸
Alignment 对选区极其敏感:漏一行、多一个空行、混用 Tab/空格,都会导致错位。
安全操作流程:
- 先全选目标代码块 →
Ctrl+Shift+P→ 输入Trim Trailing White Space清理行尾空格 - 再执行
View → Indentation → Convert Indentation to Spaces统一为空格 - 用
Ctrl+L逐行选中(避开空行和注释行),不要鼠标拖选——拖选容易漏掉换行符 - Python 字典或 JS 对象,只选中键值对部分(如从
"key":到"value"),绝对不包含{和}
对齐不是万能的——它只做纯文本列对齐,不理解语法。变量名过长、混合点号或括号时,右边值列自然会飘,这是设计使然,不是 bug。











