sublime text 的代码格式化依赖外部 prettier cli 和 jsprettier 插件协同工作；需确保 node、npm、prettier 命令在终端可用，正确安装 jsprettier 插件，配置 auto_format_on_save 和 prettier_cli_path，并启用 use_local_config 以支持项目级 .prettierrc。
Sublime Text 本身不处理代码格式化，所有“自动重排”都依赖外部 Prettier CLI 和 JsPrettier 插件协同工作；没装对 CLI、路径配错、或启动方式不对，就会静默失败——不是插件坏了，是它根本没调到 prettier。
确认 prettier 命令真能在终端里跑通
这是最常被跳过的一步。JsPrettier 不自带 Node 或 Prettier，只调用你系统 PATH 里的 prettier 可执行文件。
- 打开终端，依次运行：
node -v、npm -v、prettier --version—— 三者都必须有输出 - 如果
prettier --version报command not found，别进 Sublime 配置：先查which prettier（macOS/Linux）或where prettier（Windows） - 没结果？说明
npm install -g prettier没生效，或全局 bin 路径没加进系统PATH（macOS 常见于 shell 配置未被 Sublime 加载）
装 JsPrettier，不是 “Prettier” 或 “SublimeLinter-prettier”
Package Control 里搜到一堆名字带 “Prettier” 的插件，但当前最稳定、维护活跃、支持 Vue/TS/JSX 的只有 JsPrettier。其他多数已停更或定位模糊。
- 快捷键默认是
Ctrl+Alt+F（Win/Linux）或Cmd+Alt+F（macOS），不是Ctrl+Shift+F - 右键菜单应出现
Format with Prettier，不是 “Format Code with Prettier” 或类似变体 - 安装后不用重启，但若之前开过 Sublime，建议关掉再重开——部分环境变量需 fresh 启动才加载
启用保存时自动格式化并指定 CLI 路径
光开 auto_format_on_save 不够。尤其 macOS 用户从桌面图标启动 Sublime，PATH 往往不包含 npm 全局 bin，导致插件找不到 prettier。
- 打开
Preferences → Package Settings → JsPrettier → Settings – User - 至少填这两项：
"auto_format_on_save": true和"prettier_cli_path": "/opt/homebrew/bin/prettier"（macOS Apple Silicon 示例） - Windows 路径示例：
"prettier_cli_path": "C:\Users\xxx\AppData\Roaming\npm\prettier.cmd" - 留空
prettier_cli_path看似省事，但一旦 PATH 不一致，就变成“点了保存，代码纹丝不动”
让项目级 .prettierrc 生效的关键开关
插件默认只读全局配置，而团队协作必须靠项目根目录的 .prettierrc（或 prettier.config.js）统一规则。但 JsPrettier 不自动启用该行为。
- 在 JsPrettier 用户设置中，必须显式开启：
"use_local_config": true - 确保
.prettierrc文件放在项目最外层目录，且格式合法（JSON/YAML/JS 均可，但 JS 文件需导出对象） - 如果格式化结果和
.prettierrc不符，先检查控制台：Ctrl+`打开 Sublime 控制台，看是否有Failed to load config类报错
真正卡住人的从来不是配置项多，而是 Sublime 启动时继承的环境和你在终端里敲命令的环境不一致——尤其 macOS 下从 Dock 点开和从 open -a "Sublime Text" 启动，PATH 可能差两个目录。这点不验证，后面所有配置都是空中楼阁。
