PhpStorm 2026.2 Help

Laravel Pint

在此页面启用并配置 Laravel Pint 质量工具。

项目

描述

配置

从列表中选择所需的解释器。 该列表包含所有当前配置的本地和远程 PHP 解释器。 如需更多信息,请参阅 配置本地 PHP 解释器配置远程 PHP 解释器

单击下拉列表右侧的 “浏览”按钮 打开 Laravel Pint 对话框

显示被忽略的文件

单击以打开 Laravel Pint 忽略的文件 对话框,其中列出了 Laravel Pint 跳过的文件。 PhpStorm 建议在检查期间,当等待 Laravel Pint 的响应超过 工具进程超时 字段中指定的限制时,将新文件添加到列表中。 这样做是为了防止处理速度变慢。 对于每个文件,PhpStorm 会显示其名称和位置。

  • 要添加文件,请单击 "添加"按钮 并在打开的对话框中找到所需的文件。

  • 要从列表中删除文件并让 Laravel Pint 再次处理它,请选择该文件并单击 移除文件 按钮 "移除"按钮

  • 要从列表中删除所有文件,请单击 关闭按钮

仅重新格式化未提交的文件

选中复选框以仅修改具有未提交更改的文件。

pint.json 的路径

指定您自己的 pint.json 配置文件的路径。 pint.json 文件是可选的:它们用于启用/禁用预定义 Laravel Pint 预设中的特定规则,或重用来自 PHP CS Fixer 的自定义规则集。

规则集

选择 Laravel Pint 的一个 预定义规则组

运行模式

配置 Laravel Pint 触发代码分析的频率:

  • 随时随地 – Laravel Pint 会在后台自动运行。 在输入时,问题会在编辑器中被高亮显示。

  • 空闲时 – 当停止输入并且 空闲阈值(毫秒): 字段设定的非活动时间结束后,Laravel Pint 会运行。

  • 在保存时 – 只有在通过手动保存或 PhpStorm 的自动保存保存文件时,才会触发 Laravel Pint。 只有当文件状态持久化到磁盘时,问题高亮显示才会更新。

空闲阈值(毫秒):

定义代码修改后 Laravel Pint 运行前的延迟时间(毫秒)。

最小间隔(毫秒):

定义两次连续在同一文件上运行 Laravel Pint 之间必须经过的最小时间(毫秒)。 这可以防止在频繁保存文件或大量输入时 Laravel Pint 运行过于频繁。

Laravel Pint 对话框

单击 “浏览”按钮 ,打开 配置 列表旁边的 Laravel Pint 页面上的对话框。

使用此对话框配置所用的 PHP 解释器、Laravel Pint 可执行文件的路径以及 Laravel Pint 的行为。 有关更多信息,请参见 Laravel Pint

项目

描述

解释器窗格

对话框的左侧窗格显示用于 Laravel Pint 的默认 PHP 解释器。 要添加不同的解释器,请单击 "添加"按钮 并从项目中配置的 CLI 解释器 列表中选择一个项目。

Laravel Pint 路径

在此字段中,指定 Laravel Pint 脚本的位置:Windows 使用 pint.bat ,Linux 和 macOS 使用 pint

PhpStorm 会检测 vendor/bin 文件夹中 Laravel Pint 可执行文件的路径,并自动填写字段,但您可以根据需要进行编辑。 请手动输入路径或点击 “浏览”按钮 并在打开的对话框中选择路径。

要检查指定的 pint.bat pint 路径是否确保 PhpStorm 与 Laravel Pint 之间的交互,即工具可以从 PhpStorm 启动并且 PhpStorm 会接收其问题报告,请单击 验证 按钮。 如果验证成功,PhpStorm 会显示检测到的 Laravel Pint 版本信息。

工具进程超时

在此字段中,指定您希望 PhpStorm 等待 Laravel Pint 返回结果的时间。 如果超时,进程将被终止以防止过多的 CPU 和内存使用。 这使您可以根据计算机的配置和使用的规则集微调 Laravel Pint 的处理行为。

2026年 7月 16日