Blade 无法通过 composer require blade 安装，正确方式是安装 illuminate/view:^11.7 并手动初始化 ViewFactory，需确保模板路径和可写缓存路径（如 storage/framework/views）正确配置，且 FileViewFinder 路径顺序决定 @include 查找逻辑。
Blade 不能直接通过 composer require laravel/framework 或 composer require blade 安装——它没有独立包名叫 “blade”，所有所谓“安装 Blade”本质是引入 illuminate/view（Laravel 的视图组件），再手动初始化渲染器。错用包名、漏装依赖、缓存路径未写入可写目录，是 90% 的失败原因。
为什么 composer require jenssegers/blade 不推荐了
该包已多年未更新（最后提交在 2021 年），与当前主流 PHP 版本（8.2+）和 illuminate/view ≥11.x 不兼容。实际运行时会报类似 Class "Illuminate\View\Compilers\BladeCompiler" not found 或 Call to undefined method Illuminate\View\Factory::make() 的错误。
正确做法是直连官方维护的 illuminate/view：
- 运行
composer require illuminate/view:^11.7（Laravel 11 对应版本，PHP 8.2+ 友好） - 避免指定
^10.0或更低——它们不支持 PHP 8.2 的严格类型推导，容易在ViewFactory初始化时报TypeError - 若项目已用 Laravel，无需重复安装；
illuminate/view已内置，直接调用即可
illuminate/view 初始化必须设对这 3 个路径
Blade 渲染器不是 new 一下就能用的，ViewFactory 构造函数强制要求传入 FileViewFinder 和 FileViewCompiler，二者都依赖物理路径。常见错误是只配了模板路径，忘了缓存路径或设成了只读目录。
最小可行初始化示例：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
// bootstrap.php
use Illuminate\View\Factory;
use Illuminate\View\Engines\CompilerEngine;
use Illuminate\View\Engines\EngineResolver;
use Illuminate\View\FileViewFinder;
use Illuminate\View\Compilers\BladeCompiler;
$viewsPath = __DIR__ . '/views';
$cachePath = __DIR__ . '/storage/framework/views'; // 必须存在且可写！
// 确保 cachePath 目录存在且 chmod 755+
if (!is_dir($cachePath)) {
mkdir($cachePath, 0755, true);
}
$resolver = new EngineResolver();
$resolver->register('blade', function () use ($cachePath) {
return new CompilerEngine(new BladeCompiler(
new \Illuminate\Filesystem\Filesystem,
$cachePath
));
});
$finder = new FileViewFinder(new \Illuminate\Filesystem\Filesystem, [$viewsPath]);
$view = new Factory($resolver, $finder, new \Illuminate\Events\Dispatcher);
-
$viewsPath：存放.blade.php文件的目录，如views/welcome.blade.php -
$cachePath：Blade 编译后的 PHP 文件输出位置，必须可写，否则报file_put_contents(): Failed to open stream: Permission denied - 不要把
$cachePath设成/tmp或根目录——部署到容器或共享主机时极易因权限或清理策略失效
渲染时传参和 @include 路径怎么写才不报错
Blade 在独立使用时，@include、@extends 的路径解析不走 Laravel 的自动前缀逻辑，全部基于 FileViewFinder 构造时传入的数组顺序匹配。
比如你这样初始化：
$finder = new FileViewFinder($fs, [__DIR__.'/views', __DIR__.'/shared']);
那么 @include('header') 会先找 views/header.blade.php，找不到再找 shared/header.blade.php。但 @include('shared.header') 是无效的——Blade 不支持子目录点号语法，必须写成 @include('header') 并靠路径数组顺序解决复用。
- 变量传入统一用
$view->make('welcome', ['name' => 'Taylor'])，不能用with()链式调用（独立模式下View实例不支持） -
@yield和@section正常工作，但母版文件（如layouts/app.blade.php）必须放在$viewsPath下，不能跨目录引用 - 如果要用
@auth或@can这类 Laravel 特有指令，得额外引入illuminate/auth和配置 guard——纯 Blade 不提供这些
最易被忽略的是缓存路径权限和 FileViewFinder 的路径数组顺序：前者导致首次渲染就失败，后者让 @include 总是找不到文件却报错模糊。别跳过 mkdir -p storage/framework/views && chmod 755 storage/framework/views 这一步。
