优化本地开发

本节提供在本地运行 Filament 应用时可选的性能优化建议。

若需要生产环境相关优化，请参阅部署到生产环境。

启用 OPcache

OPcache 将预编译的脚本字节码存入共享内存，从而提升 PHP 性能，避免每次请求都加载并解析脚本。这能显著加快本地开发环境，对大型应用尤为明显。

检查 OPcache 状态

要检查 OPcache 是否已启用，运行：

php -r "echo 'opcache.enable => ' . ini_get('opcache.enable') . PHP_EOL;"

应看到 opcache.enable => 1。若没有，在 php.ini 中加入：

opcache.enable=1 # Enable OPcache

TIP

查找 php.ini 位置：运行 php --ini

配置 OPcache

若响应偏慢，或怀疑 OPcache 空间不足，可在 php.ini 中调整：

opcache.memory_consumption=128
opcache.max_accelerated_files=10000

TIP

查找 php.ini 位置：运行 php --ini

• opcache.memory_consumption：OPcache 可用于存储预编译 PHP 代码的内存（MB）。可先设为 128，再按项目需求调整。
• opcache.max_accelerated_files：OPcache 可缓存的 PHP 文件数上限。可从 10000 起步，文件很多时再提高。

这些设置是可选的，但在排查性能或大型 Laravel 应用时很有用。

将项目目录排除出杀毒扫描

Filament 性能问题（尤其在 Windows 上）常常与 Microsoft Defender 有关。

实时文件扫描或杀毒软件会在每次访问文件时扫描，从而拖慢开发环境，影响 PHP 执行、视图渲染与整体性能。

若感觉变慢，可考虑将本地项目目录排除出实时扫描。

Microsoft Defender 等工具可配置跳过特定目录。请查阅杀毒/安全软件文档，了解如何将目录排除出实时扫描。

WARNING

仅在你完全信任该项目并了解风险时，才将目录排除出扫描。

关闭调试工具

调试工具对本地开发很有用，但不用时可能明显拖慢应用。需要极致性能时可临时关闭，开发体验会有明显改善。

在 Laravel Herd 中关闭视图调试

Laravel Herd 为 macOS 与 Windows 提供视图调试工具，可显示请求中渲染了哪些视图以及传入的数据。

调试时很有用，但会明显拖慢应用。若当前不用，最好关掉。

在 Herd 中关闭视图调试：

• Open Herd > Dumps.
• Click Settings.
• Uncheck the "Views" option.

关闭 Debugbar

Laravel Debugbar 便于调试，但会在每次请求收集并渲染大量数据，从而拖慢应用（复杂页面尤甚）。

若感觉变慢，可在 .env 中加入：

DEBUGBAR_ENABLED=false

若开发仍需 Debugbar，可关闭未使用的 collector。详见 Debugbar 文档。

关闭 Xdebug

Xdebug 调试能力强，但会明显影响性能。若遇性能问题，检查是否安装了 Xdebug，并考虑关闭。

若已安装但未显式关闭，默认仍会启用。已安装时请在 php.ini 中明确关闭：

xdebug.mode=off # Disable Xdebug

TIP

查找 php.ini 位置：运行 php --ini

缓存 Blade 图标

缓存 Blade icons 有助于提升本地开发性能，尤其在渲染大量图标的视图中。

启用缓存请运行：

php artisan icons:cache

安装新的 Blade 图标包后，请再次运行该命令以发现新图标。