Sublime Text 需通过 Package Control 安装 JsPrettier 插件，并依赖系统已安装的 Node.js 和全局 prettier CLI；配置时须指定绝对路径，启用 auto_format_on_save 并正确设置 custom_file_extensions 和 excludes 才能正常格式化。
Sublime Text 本身不内置 Prettier，必须通过 Package Control 安装第三方插件（如 JsPrettier），且需系统已安装 Node.js 和全局 prettier CLI —— 缺一不可，否则保存时会报 prettier command not found 错误。
确认 Node.js 和 prettier CLI 已就绪
Sublime 的 Prettier 插件本质是调用你本地的 prettier 命令行工具，不是纯 Python 实现。所以必须先在终端执行：
node -v npm install -g prettier
然后验证是否可用：
prettier --version
如果提示 command not found，说明 Node.js 的 bin 目录没进系统 PATH（macOS/Linux 检查 ~/.bashrc 或 ~/.zshrc；Windows 检查环境变量）。Sublime 默认不读取 shell 配置，这点极易被忽略。
安装 JsPrettier（推荐）而非 Prettier-Sublime
JsPrettier 是 Sublime 下最成熟、更新活跃的 Prettier 封装，支持 JS/TS/JSX/TSX/CSS/SCSS/JSON/MD 等，并能自动识别项目级 .prettierrc。而 Prettier-Sublime 已多年未维护，不兼容 Sublime Text 4，且无法读取配置文件。
安装步骤：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Package Control: Install Package回车 - 搜索并选择
JsPrettier
安装后无需重启，但首次使用前建议手动检查插件设置路径：Preferences → Package Settings → JsPrettier → Settings。
配置 JsPrettier 以匹配项目规则
默认配置会忽略项目根目录下的 .prettierrc，必须显式启用。打开 JsPrettier 用户设置（Preferences → Package Settings → JsPrettier → Settings – User），填入：
{
"auto_format_on_save": true,
"auto_format_on_save_excludes": [
"*/node_modules/*",
"*/dist/*"
],
"custom_file_extensions": [
"js", "jsx", "ts", "tsx", "css", "scss", "json", "md"
],
"node_path": "/usr/local/bin/node",
"prettier_cli_path": "/usr/local/bin/prettier"
}
注意：
-
node_path和prettier_cli_path必须填绝对路径（用which node和which prettier查） - macOS M1/M2 用户若用 Homebrew 安装 Node，路径通常是
/opt/homebrew/bin/node -
auto_format_on_save开启后，保存即格式化；如只想手动触发，删掉这行或设为false
调试“格式化无反应”或报错
常见现象：按 Ctrl+S 没反应，或状态栏显示 JsPrettier: Error。优先检查以下三项：
- 当前文件后缀是否在
custom_file_extensions列表中（例如写的是.vue却没加进去） - 文件是否被
auto_format_on_save_excludes规则排除（比如在dist/目录下） - 打开 Sublime 控制台（
Ctrl+`），看是否有类似FileNotFoundError: [Errno 2] No such file or directory: 'prettier'的报错 —— 这说明prettier_cli_path路径错了
项目级配置（如 .prettierrc）只在文件保存时生效，Ctrl+Shift+H（手动格式化）默认不加载，这是 JsPrettier 的设计限制，不是 bug。
