JsPrettier需本地prettier CLI在PATH中,推荐npm install -g prettier;Python用sublime_black而非AutoPEP8,需pip install black;HTML/XML须用Sublime-HTMLPrettify;多语言项目应配EditorConfig统一基础格式。

JsPrettier 装完就用,但 prettier CLI 必须在系统 PATH 里
JsPrettier 不是“装上就自动排版”,它本质是调用本地 prettier 命令行工具。如果终端里执行 prettier --version 报错或提示 command not found,插件必然失效。
- 推荐用 npm 全局安装:
npm install -g prettier(Node.js ≥14) - macOS 用户若用 Homebrew 安装过 Node,可能需手动把
/opt/homebrew/bin加进 Sublime 的环境变量(通过插件设置里的node_path或系统 shell 配置) - Windows 用户注意:CMD 和 PowerShell 的 PATH 可能不同,建议用 CMD 测试
prettier是否可用 - 装完后,在 Sublime 里按
Ctrl+Shift+P→ 输入JsPrettier→ 选JsPrettier: Format Code,首次会弹出配置确认,别跳过
Python 用 sublime_black,不是 AutoPEP8
AutoPEP8 修复基础风格但不重排结构;sublime_black 直接调用 black,更接近现代 Python 工程实践,且默认禁用多光标格式化——这点反而更安全。
- 必须先装
black:pip install black(建议用项目虚拟环境的 pip,避免全局污染) - 插件设置里检查
executable_path是否指向正确的black(尤其多 Python 版本时) -
black默认不处理单行 if/for,如需强制展开,得加--line-length=88到插件配置的args字段 - 保存即格式化?别开
format_on_save全局开关,容易误触;建议只对.py文件类型启用,并配合项目根目录下的pyproject.toml
HTML/XML 排版别用原生缩进设置,要装 Sublime-HTMLPrettify
Sublime 内置的 indent_size 和 indent_tabs 只控制新键入代码的缩进,对已有 HTML 标签嵌套、属性换行、空格对齐完全无效。
- 这个插件依赖
js-beautifyCLI,装法:npm install -g js-beautify - 默认快捷键是
Ctrl+Shift+H,但常被系统快捷键劫持,建议在Preferences → Package Settings → Sublime-HTMLPrettify → Key Bindings里改一个干净组合键 - 它支持自定义
html配置项,比如设"end_with_newline": true,避免保存后文件末尾缺换行 - 注意:它对 Vue/Svelte 单文件组件里的
<template>块支持有限,遇到Unexpected token错误时,先删掉非标准语法再格式化
多语言混排项目,优先配 EditorConfig 插件
不同语言靠不同插件格式化,但缩进风格、换行符、空格/Tab 这些基础规则,全靠人肉切换设置极易出错。EditorConfig 是唯一能跨插件统一底层格式约定的方案。
- 装插件:
EditorConfig(通过 Package Control),它本身不格式化代码,只读取项目根目录的.editorconfig - 典型配置里必须写明:
indent_style = space、indent_size = 2、end_of_line = lf,否则 JsPrettier/Black 可能忽略你期望的风格 - 注意:某些旧版
Sublime-HTMLPrettify会无视.editorconfig的indent_size,得在它的专属配置里显式覆盖 - 验证是否生效:新建一个
test.js,输入function a(){return 1},按Ctrl+Shift+P → JsPrettier,观察缩进是否符合.editorconfig规定

















