sublime text 需依赖 node.js 和全局安装的 prettier cli 才能格式化代码；推荐组合安装 sublimelinter-prettier 与 prettier 插件，配置本地配置优先并绑定快捷键，注意 macos 下需从终端启动以继承 path。
Sublime Text 本身不自带代码自动格式化能力，必须通过插件（如 Prettier）配合 Node.js 环境才能实现 —— 如果没装 Node.js 或没正确配置 prettier CLI，装了插件也只会报错或无响应。
确认 Node.js 和 prettier CLI 已全局可用
这是最容易被跳过的前置条件。Prettier 插件默认调用系统命令行里的 prettier，不是靠插件自带的 JS 包。
- 终端运行
node -v和npm -v，确保输出版本号 - 运行
npm install -g prettier安装 CLI（推荐全局安装，避免路径混乱） - 再运行
prettier --version，确认能正常返回版本（如3.3.3） - 如果提示
command not found: prettier，说明 npm 全局 bin 路径没加入系统PATH，需手动补上（macOS/Linux 查npm config get prefix下的bin目录；Windows 通常在%AppData%\npm）
安装 SublimeLinter-prettier + Prettier 插件组合
仅装一个叫 “Prettier” 的插件（如 JsPrettier）容易误选——它已多年未维护；当前稳定方案是用 SublimeLinter-prettier 作为 linter 接口，再配 Prettier（由 packagecontrol.io 维护的轻量插件）触发格式化。
- 用
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Package Control: Install Package→ 回车 → 搜索并安装：SublimeLinter、SublimeLinter-prettier、Prettier - 安装完后，重启 Sublime Text（部分插件需重启才加载环境变量）
- 打开一个
.js或.ts文件，右键菜单应出现Format Code with Prettier选项
配置 Prettier 插件识别项目级配置
插件默认只读取全局配置，但实际开发中几乎都用项目级 .prettierrc 或 prettier.config.js。需手动开启“查找本地配置”开关。
- 菜单栏 →
Preferences → Package Settings → Prettier → Settings - 在右侧用户设置里添加：
{ "prettier_options": { "config_precedence": "file-override" } } - 保存后，插件会按顺序查找：
prettier.config.js→.prettierrc→.prettierrc.json等 - 若仍不生效，检查文件是否在子目录中 —— 某些旧版插件对软链接或深层嵌套路径识别不稳定
绑定快捷键并处理常见失败反馈
右键操作太慢，建议绑定快捷键；而格式化失败时，错误信息往往藏在 Sublime 控制台（Ctrl+`），不是弹窗提示。
- 菜单栏 →
Preferences → Key Bindings，在右侧添加：[ { "keys": ["ctrl+alt+f"], "command": "prettier" } ] - 触发后无反应？打开控制台（
Ctrl+`），看是否有类似prettier failed: Cannot find module 'prettier'的报错 - 常见原因：Node.js 版本过低（
prettier@3.x需 Node.js ≥ 14.21）、Sublime 进程启动时未继承 shell 的PATH（macOS 用户尤其注意：从终端执行subl启动可绕过该问题） - 临时验证：在命令行中进入项目目录，手动运行
npx prettier --write src/index.js，成功后再回 Sublime 测试
真正卡住的地方，往往不是插件装没装，而是 Sublime 启动时根本没拿到你 shell 里配置好的 PATH 和 Node.js 环境 —— 尤其 macOS 图形界面启动时，默认不加载 ~/.zshrc 里的路径声明。
