Sublime Text 代码格式化依赖外部工具链:JS/TS/JSON 用 JsPrettier + prettier CLI,Python 用 sublime_black + black,Vue SFC 需 prettier-plugin-vue;reindent 仅基础缩进,非完整格式化工具。

Sublime Text 本身没有自动排版能力,所谓“哪个插件好”,关键不是名字响亮,而是看它调用的底层工具是否稳、是否适配你的语言和项目结构。
JsPrettier 是 JS/TS/JSON 的事实标准,但必须配对 prettier CLI
JsPrettier 不是独立程序,它只是 Sublime 和 prettier 命令之间的胶水。装完插件却点不动?八成是 prettier 根本没装或路径不对。
- 先在终端运行
which prettier(macOS/Linux)或where prettier(Windows),确认命令可执行 - 如果返回空,运行
npm install -g prettier;Windows 用户注意:npm 全局 bin 路径可能含空格,建议填绝对路径如C:\Users\xxx\AppData\Roaming\npm\prettier.cmd - 进 Sublime → Preferences → Package Settings → JsPrettier → Settings,手动填入
prettier_cli_path,别信“自动检测” -
use_stdin设为true,否则带 BOM 或编码异常的文件容易解析失败
Python 用 sublime_black + black,别碰 autopep8
autopep8 对 Python 3.6+ 特性支持极差,遇到 f"hello {name}" 或 def foo(x: str) -> None: 就可能直接报 invalid syntax。而 black 是目前最省心的选择——不纠结配置、兼容新语法、输出稳定。
- 终端运行
pip install black,验证用black --version - 插件名是
sublime_black(不是Black或python-black),通过 Package Control 安装 - 默认快捷键
Ctrl+Shift+K容易和系统冲突,建议在 Key Bindings 右侧加自定义项:{"keys": ["ctrl+alt+b"], "command": "black"} - 它不依赖 Node.js,但要求
black在 PATH 中——PATH 没配好,插件就完全静默无反应
Vue 单文件组件别用 HTML-CSS-JS Prettify
这个插件对纯 HTML 还行,但一碰到 <template></template>+<script setup></script>+<style scoped></style> 的 Vue SFC,缩进会错乱甚至把 JS 代码塞进 <style></style> 块里。这不是 bug,是它压根没设计多语言块解析。
- 临时解法:只选中
<template></template>区域再格式化,别全选整个.vue文件 - 长期方案:继续用 JsPrettier,但额外装
prettier-plugin-vue:npm install -g prettier-plugin-vue,确保插件配置里prettier_options启用了plugins: ["prettier-plugin-vue"] - 如果坚持用 HTML-CSS-JS Prettify,请务必关掉
auto_format_on_save,否则保存即灾难
reindent 是内置命令,不是格式化工具
很多人误以为 reindent 能替代 Prettier 或 Black,其实它只做最基础的缩进对齐:不改括号位置、不调运算符换行、不统一引号、不处理空行逻辑。它连语法树都不碰,纯粹按当前光标缩进层级推算。
- 它生效前提苛刻:右下角状态栏必须显示正确语法(如
JavaScript,不是Plain Text) - 必须全文件缩进一致(不能混用 Tab 和空格),否则直接放弃处理
- 设置里
trim_automatic_whitespace要设为false,否则格式化后末尾空格会被悄悄删掉 - 它不依赖任何外部命令,但也不解决现代代码风格问题——别指望靠它搞定 Vue 或 TypeScript
真正容易被忽略的是环境链路:Node.js / Python 是否在 PATH、全局命令是否可执行、插件配置是否覆盖了默认值。这些环节任一断开,格式化就会静默失败,连错误提示都没有。


















