sublime text 本身不支持自动排版，必须依赖第三方插件（如 jsprettier、sublime_black）调用外部 cli 工具（prettier、black）实现；reindent 仅调整缩进，不涉及语法树级重排，且需确保文件语法识别正确、缩进统一、cli 工具路径配置无误。
Sublime Text 本身不支持自动排版，必须装插件才能格式化代码
别折腾 Preferences → Settings 里找“auto format”选项——它根本不存在。Sublime Text 没有内置的语法树级重排能力，所谓“自动排版”全是靠第三方插件调用外部工具（如 prettier、black、sqlformat）实现的。你看到的“一键美化”，本质是手动触发一次命令行工具执行。
常见误区：reindent 不是自动排版。它只对齐缩进，不改括号位置、不调整换行、不统一引号、不处理空行。按 Ctrl+Shift+P 输入 Reindent Lines 没反应？大概率是右下角状态栏显示 Plain Text，或文件混用了 Tab 和空格。
- 确认当前文件语法：点击右下角语言名（如
Plain Text），手动选成JavaScript/Python/SQL等 - 统一缩进：菜单
View → Indentation → Convert Indentation to Spaces，再选Indent Using Spaces - 关掉自动删末尾空格：设置里搜
trim_automatic_whitespace，设为false
JsPrettier（JS/TS/JSON）和 sublime_black（Python）怎么装才真正可用
装了插件 ≠ 能用。JsPrettier 依赖本地 prettier CLI，sublime_black 依赖本地 black 命令。缺任一环节都会报错 prettier not found 或 command not found。
验证前提是否满足：
- 终端运行
node -v有输出 → Node.js 已安装且在PATH - 终端运行
which prettier（macOS/Linux）或where prettier（Windows）能返回路径 →prettier可被调用 - 若用项目级
prettier，确保项目根目录存在node_modules/.bin/prettier - Python 用户：终端运行
which black，没结果就先pip install black
插件配置关键项（打开 Preferences → Package Settings → JsPrettier → Settings）：
-
"auto_format_on_save": false—— 强烈建议保持关闭，避免保存时意外覆盖团队约定风格 -
"use_stdin": true—— 必须开启，否则无法传入当前文件内容给prettier -
"newline": "lf"—— 统一换行符，避免 Git 提示 CRLF/LF 混乱
怎么设置快捷键让格式化真正“一键触发”
默认没绑定快捷键。你需要手动映射到某个组合键，比如 Ctrl+Alt+F（JS）或 Cmd+Shift+I（Python），但要注意别和系统或其他插件冲突。
操作路径：Preferences → Key Bindings，在右侧用户键位文件中添加（注意 JSON 格式）：
[
{
"keys": ["ctrl+alt+f"],
"command": "js_prettier",
"args": {"auto_indent": true}
},
{
"keys": ["super+shift+i"],
"command": "black",
"args": {}
}
]
常见问题：
- 按快捷键没反应？检查左下角语言是否匹配（
JavaScript文件才响应js_prettier） - 格式化后缩进变 2 空格但你想要 4？不是 Sublime 设置问题，是
prettier配置（.prettierrc）或black的--line-length参数决定的 - 快捷键生效但报错
permission denied？Mac/Linux 下可能是prettier二进制没有执行权限，终端运行chmod +x $(which prettier)
为什么保存即格式化容易出问题
"auto_format_on_save": true 看似省事，实则高风险：
- 编辑中途保存（比如只写了一半函数），
prettier会因语法错误直接失败，还可能清空光标位置 - 多人协作时，有人开、有人关，Git diff 里全是缩进和空行变动，掩盖真实逻辑修改
- 某些框架模板（如 Vue 单文件组件里的
<style></style>块）会被prettier错误处理
更稳妥的做法：保留 auto_format_on_save 关闭，养成习惯——写完一段逻辑后，手动按快捷键格式化，再提交。真正的控制权，永远在人手上，不在配置开关里。
