Sublime Text配合Prettier实现多语种前端项目的统一格式化-sublime-PHP中文网

prettier_cli_path填错是90%格式化失效的根源；sublime不继承shell path，须用which prettier或where prettier查真实路径并一字不差填入用户设置，nvm用户需终端启动sublime，vue/ts文件需配置additional_extensions和parser。

sublime text配合prettier实现多语种前端项目的统一格式化

prettier_cli_path 填错是 90% 格式化失效的根源

Sublime 不会自动继承 shell 的 PATH，prettier 命令在终端能跑，不代表 JsPrettier 能调用它。最直接的验证方式是：在 Sublime 控制台（Ctrl+`）里执行 import subprocess; subprocess.run(["prettier", "--version"]) —— 如果报 FileNotFoundError，说明路径没对上。

先在终端运行 which prettier（macOS/Linux）或 where prettier（Windows），拿到真实路径，比如 /opt/homebrew/bin/prettier 或 C:\Users\Alice\AppData\Roaming\npm\prettier.cmd
把这个路径**一字不差**粘贴进 JsPrettier 的用户设置里："prettier_cli_path": "/opt/homebrew/bin/prettier"
用 nvm 管 Node 的 macOS 用户，必须从终端启动 Sublime：open -a "Sublime Text"，否则 which prettier 找不到

Vue 和 TypeScript 文件不格式化？检查 additional_extensions 和 parser

JsPrettier 默认只认 .js、.ts、.html 等后缀，.vue 和部分 .tsx 文件会被跳过，不是插件 bug，是配置遗漏。

PigX UI 前端开发

PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。

下载

在 JsPrettier 设置中加这一项："additional_extensions": ["vue"]，让插件识别 .vue 文件
TypeScript 文件报 Prettier: Invalid parser，大概率是 prettier 版本太低（"prettier_options": {"parser": "typescript"}
HTML 格式后空格错乱？prettier v3+ 默认关闭自动推断，显式设："html_whitespace_sensitivity": "css"

保存时没反应？先看右下角语言标识和 auto_format_on_save 开关

JsPrettier 只对已识别为有效语法类型的文件生效。右下角显示 Plain text 或 Text，哪怕文件名是 index.ts，它也完全不触发。

手动点击右下角语言名 → 选 TypeScript 或 Vue Component（需装 Vue Syntax Highlight 插件），确认状态栏变色
用户设置里必须有："auto_format_on_save": true（注意不同插件拼写略有差异，JsPrettier 用这个，不是 format_on_save）
别同时开多个格式化插件（比如 SublimeLinter-prettier + JsPrettier），它们会互相压制，留一个即可

.prettierrc 文件位置不对，项目级规则就白配了

JsPrettier 查找 .prettierrc 的逻辑很保守：只从当前文件所在目录开始，**向上逐级找一层**。如果 Sublime 工作区打开的是子目录（比如 src/），而 .prettierrc 在项目根目录，它根本读不到。

.prettierrc 必须放在你用 Sublime 打开的最外层文件夹里（即工作区根目录），不是 Git 仓库根目录
推荐用 JSON 格式：.prettierrc.json，避免 JS 文件因 require 报错导致静默失败
插件设置里的 prettier_options 是全局兜底，项目规则优先级更高；别在插件里写 "semi": false 这类风格项，全交给 .prettierrc

实际项目里最常卡住的点，不是不会配，而是 prettier_cli_path 指向了旧版本 bin 脚本、.prettierrc 放错了层级、或者右下角语言没切对——这三处一错，格式化就彻底静默，连错误提示都没有。