Sublime Text 可通过 JsPrettier 插件配合 prettier-plugin-php 实现 PHP 自动格式化:需全局安装 Prettier 及插件,配置 JsPrettier 启用 PHP 扩展、指定 CLI 路径并开启保存时格式化。

Sublime Text 本身不原生支持 PHP 代码的 Prettier 格式化,因为 Prettier 官方不支持 PHP(截至 2024 年底仍处于实验性或社区维护状态)。但你可以通过 Prettier-PHP(一个社区 fork,基于 php-cs-fixer 或 prettier-plugin-php)配合 Sublime 插件实现保存时自动格式化。以下是清晰、可行的配置流程:
1. 确保已安装 Node.js 和 Prettier-PHP
必须先在系统中全局安装 prettier 和 prettier-plugin-php(推荐使用 npm):
- 打开终端,运行:
npm install -g prettier prettier-plugin-php - 验证是否成功:
prettier --version应输出版本号(如 3.x)prettier --list-plugins应看到prettier-plugin-php - 若使用 pnpm/yarn,请确保对应全局 bin 路径已加入系统 PATH
2. 安装 Sublime 插件:JsPrettier
Sublime 中最稳定支持 Prettier(含插件)的插件是 JsPrettier(它不限于 JS,支持所有 Prettier 支持的语言):
- 打开 Sublime → Command Palette(Ctrl+Shift+P / Cmd+Shift+P)→ 输入 Install Package → 回车 → 搜索并安装 JsPrettier
- 安装后重启 Sublime(可选,但建议)
3. 配置 JsPrettier 支持 PHP + 保存时格式化
修改 JsPrettier 的用户配置,启用 PHP 支持并开启保存即格式化:
立即学习“PHP免费学习笔记(深入)”;
- 菜单栏 → Preferences → Package Settings → JsPrettier → Settings
- 在右侧用户设置(User Settings)中粘贴以下内容(覆盖默认):
{
"auto_format_on_save": true,
"auto_format_on_save_excludes": [],
"extensions": ["php", "blade.php"],
"prettier_cli_path": "/usr/local/bin/prettier",
"node_path": "/usr/local/bin/node",
"additional_cli_args": {
"--parser": "php",
"--plugin": "prettier-plugin-php"
}
}
⚠️ 注意替换路径:
-
prettier_cli_path:用which prettier(macOS/Linux)或where prettier(Windows)获取真实路径,例如C:\\Users\\xxx\\AppData\\Roaming\\npm\\prettier.cmd -
node_path:同理查which node或where node,Windows 常为C:\\Program Files\\nodejs\\node.exe - 如不指定
prettier_cli_path,JsPrettier 可能找不到全局 prettier,导致格式化失败
4. (可选)补充:PHP 语法高亮与文件关联
确保 .php 文件被正确识别为 PHP 语法:
- 打开任意 .php 文件 → 右下角点击当前语法(如 Plain Text)→ 选择 PHP
- 永久关联:右键 → Open all with current extension as… → PHP
- 如需 Blade 支持,可额外安装 Blade Snippets 插件,并在 JsPrettier 配置中把
"blade.php"加入extensions
基本上就这些。保存 PHP 文件时,JsPrettier 会调用 prettier + prettier-plugin-php 自动格式化。如果没反应,检查控制台(View → Show Console)是否有报错,大概率是路径不对或插件未加载。










