Blade::directive() 必须在 AppServiceProvider::boot() 中注册，register() 或运行时注册均无效；指令参数为原始字符串，需手动拼接PHP代码并处理空值；@xxx与@endxxx需成对注册；修改后必须执行php artisan view:clear。
Blade::directive() 必须在 AppServiceProvider::boot() 里注册
指令不生效，八成是注册位置错了。Blade 编译器只在 boot() 阶段完成初始化，register() 里调用 Blade::directive() 会静默失败；控制器、中间件或视图里动态注册更不行——Laravel 只读取一次注册表。
实操建议：
- 打开
app/Providers/AppServiceProvider.php，确保use Illuminate\Support\Facades\Blade;已引入 - 把所有
Blade::directive()调用统一放在boot()方法内，不要分散到多个服务提供者中 - 若指令较多，可新建独立服务提供者（如
BladeServiceProvider），运行php artisan make:provider BladeServiceProvider，再在config/app.php的providers数组中注册它 - 重复注册同名指令（比如两次
Blade::directive('log', ...)）会静默覆盖，无报错但行为不可预期
@myDirective($arg) 的 $arg 是原始字符串，不是 PHP 值
你写 @datetime($user->created_at)，传进闭包的 $expression 就是字面量 $user->created_at 这个字符串，不是它运行后的 Carbon 实例。别试图在里面直接调用 auth() 或 request() —— 这些是运行时 Facade，而闭包是在编译阶段执行的。
实操建议：
- 所有表达式都得手动拼进返回的 PHP 字符串里，例如：
return "<?php echo ({$expression})->format('Y-m-d'); ?>"; - 务必处理空值，避免
Call to a member function format() on null：用({$expression}) ? ({$expression})->format(...) : ''包裹 - 用
trim($expression, " '\"")清理括号外的空格和引号，否则@role( 'admin' )里的空格也会传进来 - 别漏写
<?php和?>，也别在返回字符串末尾加分号——Blade 会自动补，多加反而导致语法错误
@myBlock … @endmyBlock 必须成对注册两个 directive
Blade 不识别“区块指令”这个概念，它靠编译器栈匹配 @xxx 和 @endxxx。所以 @role 和 @endrole 是两个完全独立的指令，必须都注册，且生成的 PHP 片段要严格语法配对。
实操建议：
-
Blade::directive('role', ...)返回类似"<?php if (auth()->check() && auth()->user()->hasRole{$expression}): ?>" -
Blade::directive('endrole', ...)必须返回对应结束语句，例如'<?php endif; ?>'，不能写成@endRole或@end_role—— 名称必须完全一致 - 不要用
Blade::if()替代，它只支持单标签，@endxxx会被完全忽略 - 如果需要捕获并二次编译中间内容（比如嵌套
@if），得用Blade::extend()配合正则，但要注意它在每次请求编译时都会触发（除非缓存开启），性能敏感场景慎用
改完指令后必须执行 php artisan view:clear
Blade 编译后的 PHP 文件缓存在 storage/framework/views/，改了指令逻辑但没清缓存，模板仍运行旧代码，新逻辑永远不会触发。错误通常静默吞掉，只渲染空白，或者报错指向缓存文件里的某一行，而不是你写的指令本身。
实操建议：
- 开发期间养成习惯：每次修改
Blade::directive()后，立即运行php artisan view:clear - 也可以手动删缓存：
rm -rf storage/framework/views/*（Linux/macOS）或del /s /q storage\framework\views\*（Windows） - 上线前务必确认部署脚本包含
view:clear步骤，否则本地有效、线上失效的问题反复出现 - 调试时可在闭包里加
dd($expression, $returnString);确认拼接结构是否正确，但记得删掉再上线
