sublime text代码格式化依赖插件，jsprettier需正确配置prettier_cli_path，black替代autopep8更稳，vue文件慎用html-css-js prettify，aligntab解决符号对齐问题。
Sublime Text 本身不提供真正的代码格式化能力，所谓“一键排版”全是插件干的活。装错插件、漏配路径、没选中代码块，都会导致点下去没反应——这不是你操作错了，是环境没搭对。
JsPrettier 格式化 JS/TS/JSON 总没反应？先查 prettier 命令是否存在
JsPrettier 不是独立运行的，它必须调用系统里已安装的 prettier CLI。常见现象：按 Ctrl+Shift+P 输入 JsPrettier 回车，状态栏闪一下就停住，控制台无报错——八成是找不到 prettier。
- 在终端执行
which prettier（macOS/Linux）或where prettier（Windows），确认命令可访问 - 如果返回空，说明没装或没加进 PATH：运行
npm install -g prettier - 装完后进 Sublime →
Preferences → Package Settings → JsPrettier → Settings，填入prettier_cli_path绝对路径，例如/usr/local/bin/prettier或C:\Users\xxx\AppData\Roaming\npm\prettier.cmd - 别信“自动检测”，它几乎从不自动成功；
use_stdin建议设为true，避免文件编码或 BOM 导致解析失败
Python 用 Black 而不是 autopep8：类型注解和 f-string 容易崩
autopep8 对现代 Python 特性支持弱，遇到 def foo(x: str) -> None: 或 f"hello {name}" 可能直接报 invalid syntax。Black 是目前最稳的选择，且默认风格统一，无需纠结配置。
- 安装：终端运行
pip install black - 插件名是
sublime_black（不是Black或python-black），通过 Package Control 搜索安装 - 它不依赖 Node.js，但要求
black命令在 PATH 中；验证方式：终端输black --version - 默认快捷键是
Ctrl+Shift+K，但建议手动绑定：打开Preferences → Key Bindings，右侧加一行：{ "keys": ["ctrl+alt+b"], "command": "black" }
HTML/CSS/Vue 单文件组件慎用 HTML-CSS-JS Prettify
这个插件对纯 HTML 文件还行，但一碰到 <template></template> + <script setup></script> + <style scoped></style> 的 Vue SFC，缩进会全乱， 可能被塞进 <style></style> 里。不是 bug，是它根本没设计支持多语言块解析。
- 临时方案：只选中
<template></template>区域再格式化，别全选整个 .vue 文件 - 长期建议：改用
JsPrettier配合prettier-plugin-vue（需额外npm install -g prettier-plugin-vue） - 若坚持用 HTML-CSS-JS Prettify，请关掉
auto_format_on_save，否则保存即灾难 - 它的快捷键
Ctrl+Shift+H和 JsPrettier 冲突，两个都装必须重映射其中一个
AlignTab 是唯一真正解决「符号对齐」问题的插件
想让 a = 1、long_variable_name = 2、result = 3 垂直对齐等号？内置缩进或 JsPrettier 都做不到。AlignTab 用正则匹配符号，支持多光标、实时预览、命名模式复用，是目前 Sublime 里最灵活的对齐工具。
- 安装走 Package Control，搜
AlignTab（注意不是Alignment，后者已停止维护且不兼容 ST4） - 选中多行后，按
Ctrl+Alt+A打开对齐面板，输入=回车，立刻对齐等号 - 想对齐冒号或箭头？输入
:或->即可；需要右对齐加前缀r，如r= - 它不修改语法结构，只动空白符，所以和任何格式化插件共存无冲突——但必须手动选中，不会自动触发
真正卡住人的从来不是“该装哪个插件”，而是 prettier 命令路径没填对、black 没进 PATH、Vue 文件误用 HTML 插件、或者以为 Alignment 还能通过 Package Control 正常安装。这些细节不对，插件再强也等于没装。
