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，且首次触发要手动输符号生成配置——跳过这步，后面全白搭。
