必须统一Laravel视图后缀为.blade.php：检查config/view.php中'extensions'顺序，确保'blade.php'优先；清理resources/views中非Blade后缀文件；执行php artisan view:clear并修正硬编码路径。
团队协作中多人同时修改Laravel视图文件时，因模板后缀不统一（如.blade.php、.php、.html）导致Git冲突频发、Blade语法被忽略、缓存失效或视图无法渲染，需强制统一为标准后缀并确保所有环境一致生效。
确认当前视图后缀配置
打开 config/view.php 文件，定位到 【'extensions' => ['php', 'blade.php']】 这一行。Laravel默认支持多个后缀，但实际解析优先级由数组顺序决定——排在前面的后缀优先匹配。若 php 在 blade.php 前，且存在同名 index.php 和 index.blade.php，系统将加载前者，Blade语法（如 @foreach）直接报错。
检查 resources/views/ 目录下是否混用后缀：运行 find resources/views -name "*.php" ! -name "*.blade.php" | head -5 查看非Blade的PHP视图文件。
统一替换为 .blade.php 后缀
方法一：批量重命名（推荐用于新项目或视图结构干净时）
进入 resources/views 目录，执行以下命令：
find . -name "*.php" ! -name "*.blade.php" -type f -exec bash -c 'mv "$1" "${1%.php}.blade.php"' _ {} \;
这一步会把所有 .php 视图（除已带 .blade.php 的）改为 .blade.php。注意：该操作不可逆，【执行前必须提交当前 Git 分支所有变更】，否则重命名后 Git 无法追踪历史。
方法二：渐进式切换（适用于线上项目，需兼容旧后缀）
编辑 config/view.php，将 'extensions' 改为 ['blade.php', 'php']，确保 .blade.php 优先解析；随后在控制器中显式指定后缀：return view('home.index'); // 自动找 home/index.blade.php，不再依赖 home/index.php。
禁用非Blade后缀解析能力
第一步：注释掉 config/view.php 中除 blade.php 外的所有扩展名
将 'extensions' => ['blade.php'] 设为唯一值，删掉 php、html 等其他项。
第二步：清空视图缓存防止旧后缀残留生效
运行 php artisan view:clear。若未执行此步，Laravel 可能仍从缓存中加载旧的 .php 视图，导致修改后缀后页面空白或报错。
第三步：全局搜索代码中硬编码的非Blade路径
用 IDE 全局搜索 view( 或 @include(，检查字符串参数是否含 .php 后缀（如 view('layouts.app.php')），全部改为无后缀写法（view('layouts.app')）——Laravel 会自动按 config/view.php 中定义的 extensions 顺序查找。
