必须安装 jsprettier 而非 prettier，因其稳定支持 typescript 和项目级配置；需配置绝对路径的 prettier_cli_path 与 node_path（≥14.0.0），并添加 ts/tsx 到 custom_file_extensions，启用 auto_format_on_save。

装 JsPrettier，别装叫“Prettier”的那个

Sublime Text 4 下，官方名为 Prettier 的插件已多年未更新，加载失败、不读 .prettierrc、对 TypeScript 完全无响应——它不是你想要的。必须装 JsPrettier，它是目前唯一稳定支持项目级配置和 ts/tsx 的活跃维护插件。

• 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板
• 输入 Package Control: Install Package，回车
• 搜 JsPrettier，点击安装（无需重启）
• 如果之前误装过 Sublime-Prettify 或旧版 Prettier，先去 Preferences → Package Control → Remove Package 卸载干净

prettier_cli_path 和 node_path 必须填绝对路径

Sublime 不继承 shell 的 PATH（比如 ~/.zshrc 里的配置），即使终端里 prettier --version 能跑，Sublime 仍会静默失败。插件只认你填进去的绝对路径，空值、null、~ 都不行。

Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载

• 终端执行 which prettier（macOS/Linux）或 where prettier（Windows），拿到类似 /opt/homebrew/bin/prettier 或 C:\Users\XXX\AppData\Roaming\npm\prettier.cmd 的路径
• 同样用 which node 或 where node 查 node 路径，填入 node_path
• node -v 必须 ≥ 14.0.0；低于这个版本，prettier CLI 可能启动失败

TS 文件不格式化？检查 custom_file_extensions 和语法识别

JsPrettier 默认只响应 js 和 jsx，ts 和 tsx 不在默认列表里——哪怕你文件后缀是 .ts，插件也当普通文本忽略。

• 进 Preferences → Package Settings → JsPrettier → Settings – User
• 确保 "custom_file_extensions" 显式包含 "ts" 和 "tsx"，例如：["js","jsx","ts","tsx","json"]
• 右下角状态栏确认语法显示为 TypeScript 或 JavaScript，不是 Plain text；点一下切换，或用 Ctrl+Shift+P → Set Syntax: TypeScript
• "auto_format_on_save": true 必须开启，否则保存不会触发

JSON 格式化别硬套 JsPrettier

如果你主要想一键美化 JSON，JsPrettier 是过度设计：它依赖 Node 环境、要配路径、还可能把单引号转双引号破坏原始语义。直接用 HTML-CSS-JS Prettify 更轻量可靠。

• 命令面板搜 HTML-CSS-JS Prettify（注意名字带连字符，不是 Prettify 单词）
• 安装后，打开 .json 文件，全选 + Ctrl+Shift+H 即可格式化
• 无需 Node.js，不读配置文件，也不依赖 prettier CLI，适合纯 JSON 场景

真正卡住的从来不是插件本身，而是路径没对上、扩展名没加、语法没识别——这三处漏掉任何一项，都会表现为“点了没反应”。