需将Laravel老项目.blade.php视图统一改为.twig后缀并确保正常渲染：先清缓存（view:clear、config:clear），再安装TwigBridge、配置仅启用twig扩展、强制注册View扩展、批量重命名文件、更新继承与语法，并验证路由加载。
老项目Laravel中已有大量.blade.php视图文件，需统一改为.twig后缀并保持路由渲染正常，同时避免缓存导致模板加载失败或404错误。
确认当前视图引擎与缓存状态
执行php artisan view:clear清除所有已编译视图缓存，否则即使改了文件后缀，Laravel仍会尝试加载旧的.blade.php缓存文件，直接报错“View [home] not found”。
运行php artisan config:clear确保配置未被缓存干扰——特别是config/view.php中'extensions'和'compiled'路径是否被硬编码覆盖。
检查resources/views目录下是否存在.blade.php和.twig混存情况：【必须先清空view compiled目录，否则Twig引擎可能误读blade缓存】。
注册Twig视图引擎并替换默认解析器
安装Twig桥接包：composer require rcrowe/twigbridge（兼容Laravel 9–13）。
发布配置文件：php artisan vendor:publish --provider="TwigBridge\ServiceProvider"，生成config/twigbridge.php。
编辑config/twigbridge.php，将'extensions' => ['twig']设为唯一启用扩展名，**删除'blade'**——若保留blade，Laravel仍会优先匹配.blade.php，导致.twig文件被跳过。
在app/Providers/AppServiceProvider.php的boot()方法中添加强制注册：
View::addExtension('twig', 'twig', \TwigBridge\Extension\ViewExtension::class);
这一步不能省略：TwigBridge默认不接管view()调用，必须显式绑定扩展名与渲染器类，否则return view('home')仍走blade流程。
批量重命名视图文件并验证路径映射
第一步：进入resources/views目录，执行shell命令批量改后缀：
find . -name "*.blade.php" -exec sh -c 'mv "$1" "${1%.blade.php}.twig"' _ {} \;
第二步：检查嵌套子目录（如auth/login.blade.php→auth/login.twig），确保路径层级完全一致——Twig不支持blade的@include('shared.header')自动补全逻辑，必须严格按shared/header.twig路径引用。
第三步：打开任意控制器，将return view('home');临时改为return response()->view('home.twig');，访问页面验证是否成功渲染；成功后还原为view('home')——这说明Laravel已识别.twig为合法视图扩展名。
注意：若使用@extends('layouts.app')语法，需同步将resources/views/layouts/app.blade.php改为app.twig，且所有@section/@yield要转为Twig语法{% extends "layouts/app.twig" %}和{% block content %}{% endblock %}。
更新所有视图引用语法
方法一：全局搜索替换@if→{% if %}、@foreach→{% for %}、@endphp→{% endfor %}等，但需人工核对嵌套层级，避免{% endif %}遗漏。
方法二：用TwigBridge自带的转换工具（需启用'debug' => true），访问/_twig/debug查看未转换语法报错位置，针对性修改。
方法三：保留部分blade混合渲染——在config/twigbridge.php中设置'environment' => ['auto_reload' => true]，并在Twig模板里用{{ Illuminate\Support\Facades\View::make('shared.nav')->render()|raw }}内嵌blade片段，仅用于过渡期关键组件。
这一步完成后，所有view()调用将加载.twig文件，且php artisan migrate等命令不受影响——视图迁移与数据库迁移完全解耦。
